El fichero .vscode/extensions.json te permite recomendar extensiones al abrir un workspace/proyecto en VS Code. Así, cada desarrollador que abra el repo verá un aviso para instalar (en un clic) las extensiones recomendadas y trabajar con un entorno homogéneo.
¿Qué es el fichero extensions.json en VS Code?
- Es un archivo JSON ubicado en la carpeta .vscode/ de tu proyecto.
- Su objetivo principal es recomendar extensiones (no las instala de forma forzada) identificadas por su ID (publisher.extensionName).
- VS Code muestra una notificación al abrir el workspace con la opción de instalar todas o revisar la lista.
Importancia de extensions.json en proyectos AL y Business Central
En equipos AL, tener todos las mismas extensiones evita discrepancias de formato, análisis estático, nomenclaturas y acelera tareas comunes:
- Lenguaje AL y snippets oficiales.
- Refactorización y utilidades AL.
- Linters y CodeCops adicionales.
- Pruebas automatizadas.
- Traducciones/XLIFF, IDs de objetos, GUIDs.
- Docker / Dev Containers.
- Git / GitLens, REST Client, etc.
Estructura mínima del archivo extensions.json
Archivo: .vscode/extensions.json
{
«recommendations»: [
«ms-dynamics-smb.al»,
«andrzejzwierzchowski.al-code-outline»,
«waldo.crs-al-language-extension»,
«rasmus.al-formatter»,
«jamespearson.al-test-runner»,
«waldo.nab-al-tools»,
«vjeko.vjeko-al-objid»,
«ms-azuretools.vscode-docker»,
«eamodio.gitlens»,
«humao.rest-client»
]
}
Cómo crear y mantener extensions.json en tu repositorio
- Crea la carpeta .vscode/ en la raíz del repo.
- Añade el archivo extensions.json con la sección «recommendations».
- Confirma los IDs correctos en el Marketplace de VS Code.
- Sube los cambios al control de versiones.
- Pide al equipo que abra el repo en VS Code y acepte la instalación recomendada.
Relación de extensions.json con otros ficheros JSON en AL
- app.json → manifiesto de tu extensión.
- launch.json → define cómo se publica y depura tu extensión.
- extensions.json → no afecta a compilación ni despliegue, solo mejora la experiencia de desarrollo.
Ejemplo práctico de uso de extensions.json
Buenas prácticas al usar extensions.json
- Documenta en el README.md por qué recomiendas cada extensión.
- Versiona el archivo y revísalo en las PRs.
- Evita duplicidades con packs de extensiones.
- Coordina su uso con settings.json del workspace.
Preguntas frecuentes sobre extensions.json
¿Se instalan solas las extensiones del extensions.json?
No. VS Code solo recomienda y el usuario debe confirmar.
¿Afecta a la compilación o publicación de mi extensión AL?
No, en absoluto.
¿Dónde verificar los IDs correctos de las extensiones?
En el Marketplace de Visual Studio Code.
ABD y el desarrollo profesional en Business Central
At ABD IT Consulting and Solutions trabajamos a diario con equipos de desarrollo de Business Central y AL, ayudándoles a estandarizar entornos, mejorar la calidad del código y acelerar los ciclos de desarrollo.
Desde la definición de workspaces homogéneos en VS Code, hasta la implantación de buenas prácticas DevOps, CodeCops y automatización, acompañamos a los equipos técnicos para que puedan centrarse en lo importante: desarrollar soluciones robustas y escalables para Business Central.
¿Quieres mejorar la productividad y calidad de tu equipo AL? Get in touch with ABD y te ayudamos a optimizar tu entorno de desarrollo.