Por qué importa tener el mismo editor en todas partes
Cualquiera que trabaje con más de una máquina conoce la sensación: abres el editor en el portátil del trabajo y falta el tema que llevas años usando, los atajos no responden como esperas, el formateo automático no se dispara y la mitad de las extensiones han desaparecido. Perder diez minutos reconstruyendo el entorno una vez es tolerable. Hacerlo cada vez que cambias de equipo, reinstalas el sistema o abres un contenedor nuevo termina siendo una fuente constante de fricción.
Visual Studio Code resuelve gran parte de este problema con una función integrada de sincronización. Antes de que existiera, la comunidad recurría a extensiones de terceros que guardaban la configuración en un archivo alojado en un servicio externo y exigían subir y bajar los datos a mano con comandos. Aquel enfoque funcionaba, pero obligaba a gestionar tokens, identificadores y un flujo manual propenso a olvidos. Hoy el propio editor se encarga de todo: inicias sesión con una cuenta, eliges qué categorías sincronizar y los cambios viajan solos entre tus instalaciones.
En este tutorial recorreremos el proceso completo y con criterio. Verás cómo activar la sincronización integrada, qué datos viajan y cuáles no, cómo usar los perfiles para separar contextos de trabajo, cómo excluir ajustes que dependen de la máquina, cómo resolver conflictos y cómo mantener coherente el entorno dentro de contenedores, WSL o servidores remotos. También repasaremos una alternativa basada en archivos versionados con Git, los problemas más habituales y las precauciones de seguridad que conviene tomar.
Una nota sobre versiones: las funciones que se describen aquí forman parte de las versiones estables recientes del editor, que se actualiza cada mes con un ciclo de lanzamientos regular. No necesitas un número concreto, pero sí una instalación razonablemente al día. Para comprobar la tuya, abre el menú de ayuda y entra en la opción de información, o ejecuta lo siguiente en una terminal.
code --version
La salida muestra el número de versión, el identificador del commit y la arquitectura. Si tu instalación es muy antigua, actualízala antes de seguir: algunas opciones de perfiles y de sincronización no existen en versiones viejas.
Qué se puede sincronizar y qué se queda en cada máquina
Antes de pulsar ningún botón conviene entender el alcance de la función. El editor sincroniza categorías de datos, no el directorio de configuración completo. Estas son las que ofrece:
- Ajustes de usuario, el contenido de
settings.json. - Atajos de teclado, el contenido de
keybindings.json. - Fragmentos de código o snippets definidos por el usuario.
- Tareas de usuario.
- Extensiones instaladas, junto con su estado de activación.
- Estado de la interfaz, como la disposición de paneles y la visibilidad de elementos.
- Perfiles, que agrupan todo lo anterior en conjuntos con nombre.
Lo que no viaja es igual de importante. Los ajustes con ámbito de máquina, por ejemplo rutas a ejecutables locales, no se sincronizan, porque lo que es válido en un equipo suele ser inválido en otro. Tampoco se sincronizan los archivos de tu proyecto, las credenciales almacenadas en el llavero del sistema, el historial de archivos recientes ni el contenido de las carpetas de trabajo. Si necesitas replicar herramientas externas, como un formateador instalado globalmente o un intérprete concreto, eso debe resolverse fuera del editor, con un gestor de paquetes o un script de aprovisionamiento.
Un ejemplo ilustra la diferencia. Imagina que en tu equipo de sobremesa defines una ruta absoluta al intérprete de Python dentro de un entorno virtual. Si esa ruta se copiara tal cual a tu portátil, apuntaría a un directorio inexistente y generaría errores. Por eso el editor marca ciertos ajustes como específicos de la máquina y los deja fuera. Para los que no están marcados pero sí dependen del equipo, existe un mecanismo de exclusión manual que veremos más adelante.
Activar la sincronización integrada paso a paso
El proceso de activación es breve y se hace una sola vez por instalación. Funciona con una cuenta de Microsoft o con una cuenta de GitHub, y ambas son válidas. La elección importa solo si quieres mantener la identidad que ya usas en otros servicios; los datos se almacenan en el servicio de sincronización del editor, no en un repositorio tuyo.
Abre la paleta de comandos con Ctrl+Shift+P en Windows y Linux, o con Cmd+Shift+P en macOS, y ejecuta el comando de activación.
Settings Sync: Turn On
También puedes llegar al mismo punto desde el icono de cuentas de la barra de actividad, situado en la parte inferior izquierda, eligiendo la opción para activar la sincronización. El asistente muestra una lista con las categorías descritas en la sección anterior, todas marcadas por defecto. Desmarca las que no quieras compartir y pulsa el botón de iniciar sesión. El navegador se abrirá para autorizar la cuenta y, al volver al editor, comenzará la primera subida de datos.
Si es la primera vez que usas la función, la nube está vacía y tus datos locales pasan a ser la referencia. Si ya sincronizaste otra máquina, el editor detectará datos remotos y te preguntará cómo combinarlos. Verás opciones para fusionar lo local con lo remoto, reemplazar lo local por lo remoto o reemplazar lo remoto por lo local. La opción de fusionar es la más prudente al principio, porque conserva lo que haya en ambos lados y te deja revisar las diferencias en una vista comparativa.
Para confirmar que todo está en marcha, comprueba el icono de cuentas: debería indicar que la sincronización está activa. Puedes consultar el estado y gestionar la función con estos comandos de la paleta.
Settings Sync: Show Settings
Settings Sync: Show Synced Data
Settings Sync: Show Log
Settings Sync: Configure
El primero abre la vista de configuración con la fecha de la última sincronización. El segundo muestra los datos almacenados en la nube y permite explorar versiones anteriores. El tercero abre el registro, que será tu aliado cuando algo falle. El último vuelve a mostrar la lista de categorías por si quieres cambiar la selección.
Configurar un segundo equipo sin perder nada
Una vez activada en el primer equipo, replicar el entorno en otro es todavía más sencillo. Instala el editor, ejecuta el mismo comando de activación e inicia sesión con la misma cuenta. El asistente descargará los ajustes, los atajos, los snippets y la lista de extensiones y las instalará automáticamente. Dependiendo de la cantidad de extensiones, el proceso puede tardar unos minutos, y es normal que el editor pida reiniciar al terminar.
En este punto surge una duda frecuente: ¿qué ocurre si el segundo equipo ya tenía su propia configuración? Aquí es donde la opción de fusionar demuestra su utilidad. El editor compara ambos conjuntos y, cuando no hay contradicciones, los une sin más. Cuando la misma clave tiene valores distintos en cada lado, te muestra un editor de comparación para que decidas. Tómate el tiempo de revisar cada diferencia; un valor aceptado a ciegas puede cambiar el comportamiento del formateo o del guardado automático sin que lo notes.
Un consejo práctico para la primera vez: antes de activar la sincronización en la segunda máquina, haz una copia manual de su carpeta de configuración. Es una red de seguridad barata. Las rutas habituales son las siguientes.
Linux
└── ~/.config/Code/User/
├── settings.json
├── keybindings.json
├── snippets/
└── profiles/
macOS
└── ~/Library/Application Support/Code/User/
├── settings.json
├── keybindings.json
├── snippets/
└── profiles/
Windows
└── %APPDATA%\Code\User\
├── settings.json
├── keybindings.json
├── snippets\
└── profiles\
Copiar esa carpeta a un lugar seguro te permite volver atrás si el resultado de la fusión no te convence. En Linux basta con un comando.
cp -r ~/.config/Code/User ~/respaldo-vscode-$(date +%F)
Perfiles: separar contextos sin duplicar el editor
Los perfiles son probablemente la función más infravalorada del editor. Un perfil es un conjunto con nombre que agrupa ajustes, atajos, snippets, tareas, extensiones y estado de la interfaz. Puedes cambiar de uno a otro en un par de clics, y cada ventana puede usar un perfil distinto.
¿Para qué sirve esto en la práctica? Piensa en tres situaciones. La primera es separar tecnologías: un perfil para desarrollo web con extensiones de JavaScript, linters y herramientas de CSS, y otro para ciencia de datos con soporte de notebooks y Python. Así evitas cargar extensiones innecesarias en cada ventana. La segunda es separar actividades: un perfil minimalista para escribir documentación, con fuente grande y sin distracciones, y otro completo para programar. La tercera es preparar demostraciones o clases: un perfil con tema claro, fuente ampliada y casi ninguna extensión, que no contamina tu entorno diario.
Para crear uno, abre la paleta de comandos y ejecuta la creación de perfil.
Profiles: Create Profile
El editor te pide un nombre y te deja elegir si el perfil parte vacío, copia el perfil por defecto o se basa en una plantilla. Las plantillas incluidas cubren lenguajes populares y vienen con extensiones y ajustes razonables. Si ya tienes un perfil que funciona, copiarlo es el camino más rápido para crear una variante.
Para cambiar de perfil usa este comando o el menú de gestión, representado por el icono de engranaje.
Profiles: Switch Profile
También puedes abrir una carpeta directamente con un perfil concreto desde la línea de comandos, algo muy útil en scripts y accesos directos.
code --profile "Web" ./mi-proyecto
Si el perfil no existe, el editor lo crea con ese nombre. Además, puedes asociar una carpeta o un espacio de trabajo a un perfil, de forma que se aplique automáticamente al abrirlos. Esto elimina el cambio manual y garantiza que cada proyecto use siempre su conjunto de herramientas.
Perfiles y sincronización trabajan juntos
Cuando la sincronización está activa y la categoría de perfiles está marcada, todos tus perfiles viajan entre equipos. Crear un perfil nuevo en el portátil hace que aparezca en el sobremesa tras la siguiente sincronización. Es la combinación ideal: aislamiento por contexto y disponibilidad en cualquier lugar.
Hay un matiz que conviene recordar. Los perfiles sincronizados se mantienen independientes entre sí, así que un cambio de atajo hecho en el perfil de desarrollo web no se refleja en el de documentación. Si quieres que un ajuste concreto sea común a todos, tendrás que definirlo en cada perfil o partir de una copia del perfil por defecto con el ajuste ya incluido.
Exportar e importar perfiles para compartirlos
No todo el mundo quiere o puede usar una cuenta de sincronización. Un equipo que necesita un entorno común, o una persona que prepara un taller, tiene en la exportación una alternativa muy práctica. Desde la paleta se ejecuta el comando de exportación.
Profiles: Export Profile
El editor ofrece dos destinos: un archivo local con extensión code-profile o un enlace compartido a través del servicio de sincronización. El archivo es autocontenido y puedes enviarlo por correo, guardarlo en un repositorio o incluirlo en la documentación del proyecto. Para importarlo en otra máquina se usa el comando correspondiente.
Profiles: Import Profile
Esto resuelve el caso de la incorporación de personas nuevas a un equipo. En lugar de entregar una lista de extensiones recomendadas y esperar que cada persona las instale, entregas un perfil completo con la configuración de formateo, los linters y los snippets del proyecto. La diferencia en tiempo de puesta en marcha es notable.
Una buena práctica es guardar el archivo exportado en el repositorio, en una carpeta de herramientas, y versionarlo. Cuando el equipo cambie una convención, se actualiza el archivo y todos lo reimportan. Si lo prefieres, puedes complementar el perfil con un archivo de recomendaciones de extensiones dentro del propio proyecto, como veremos más adelante.
Excluir ajustes y extensiones que no deben viajar
Algunos ajustes tienen sentido en una máquina y ninguno en otra. Un ejemplo típico es el tamaño de fuente: en un monitor de alta densidad usas una fuente de catorce puntos y en un portátil pequeño prefieres once. Otro es la ruta a un ejecutable concreto, o un ajuste de red que solo aplica en la oficina. Para estos casos, el editor ofrece listas de exclusión muy flexibles.
La forma más cómoda es abrir el editor de ajustes, pasar el ratón sobre el ajuste y usar el menú contextual para elegir la opción de no sincronizar esa clave. También puedes escribirlo a mano en settings.json.
{
"settingsSync.ignoredSettings": [
"editor.fontSize",
"terminal.integrated.fontSize",
"python.defaultInterpreterPath",
"window.zoomLevel"
],
"settingsSync.ignoredExtensions": [
"ms-vscode.cpptools",
"ms-azuretools.vscode-docker"
]
}
El primer arreglo evita que esas claves se suban o se sobrescriban desde la nube. El segundo impide que ciertas extensiones se instalen o desinstalen por efecto de la sincronización. Esto último resulta útil cuando una extensión pesada solo tiene sentido en un equipo de trabajo concreto.
Otra opción relevante es la de los atajos de teclado por plataforma. Los atajos pensados para macOS usan Cmd, y en Windows o Linux lo habitual es Ctrl. Si trabajas en sistemas distintos, activa la sincronización de atajos por plataforma para que cada sistema operativo conserve su propio conjunto.
{
"settingsSync.keybindingsPerPlatform": true
}
Con esta opción activa, los atajos de cada plataforma se guardan por separado y no se pisan entre sí. Si compartes un único archivo entre sistemas, vas a notar atajos que dejan de funcionar sin explicación aparente.
Ajustes por lenguaje y por espacio de trabajo
Conviene distinguir los tres niveles de configuración que maneja el editor: usuario, espacio de trabajo y carpeta. La sincronización afecta solo al nivel de usuario. Lo definido en la carpeta .vscode de un proyecto viaja con el proyecto, a través de Git, no a través de la cuenta. Esta separación es una ventaja: las reglas de equipo, como el ancho de sangría o el formateador, deben vivir en el repositorio para que todos las compartan, y las preferencias personales, como el tema o la fuente, deben quedarse en tu configuración de usuario.
Un ejemplo de ajustes de proyecto que conviene versionar sería este.
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
"[python]": {
"editor.defaultFormatter": "charliermarsh.ruff"
},
"files.eol": "\n"
}
Colocado en .vscode/settings.json dentro del repositorio, este archivo garantiza que cualquier persona que abra el proyecto obtenga el mismo comportamiento de guardado, sin depender de su sincronización personal.
Gestionar extensiones de forma reproducible
Las extensiones son la parte más difícil de mantener alineada. Con la sincronización activa se instalan solas, pero hay escenarios en los que necesitas una lista explícita: un equipo nuevo sin cuenta, un servidor, una imagen de contenedor o una documentación de arranque. La línea de comandos del editor permite listar e instalar extensiones, y eso abre la puerta a automatizar.
Para ver las extensiones instaladas, junto con su versión, ejecuta lo siguiente.
code --list-extensions --show-versions
La salida tiene un aspecto como este.
Los números de versión del ejemplo son ilustrativos y variarán en tu equipo. Para reconstruir el conjunto en otra máquina, puedes guardar la lista en un archivo y recorrerla con un bucle.
code --list-extensions > extensiones.txt
Y en el equipo destino:
xargs -n 1 code --install-extension < extensiones.txt
Este método no requiere cuenta ni conexión con el servicio de sincronización, y es perfecto para scripts de aprovisionamiento. Si trabajas con perfiles, añade el parámetro del perfil para instalar en el que corresponda.
xargs -n 1 code --profile "Web" --install-extension < extensiones-web.txt
Recomendaciones de extensiones por proyecto
Otra técnica complementaria consiste en declarar las extensiones recomendadas dentro del propio proyecto. El editor lee el archivo extensions.json de la carpeta .vscode y, al abrir el proyecto, ofrece instalar las que falten. No fuerza nada, pero deja claro qué herramientas espera el equipo.
{
"recommendations": [
"dbaeumer.vscode-eslint",
"esbenp.prettier-vscode",
"editorconfig.editorconfig"
],
"unwantedRecommendations": [
"hookyqr.beautify"
]
}
La lista de recomendaciones no depende de tu cuenta ni de tu perfil. Viaja con el repositorio y se aplica a todas las personas que lo abran, lo que la convierte en un complemento natural de la sincronización personal.
Entornos remotos: WSL, SSH, dev containers y Codespaces
Aquí es donde muchas personas se pierden, porque el editor funciona como un cliente que se comunica con un servidor remoto. Las extensiones de interfaz, como los temas, se ejecutan en el cliente, mientras que las que analizan código, como los servidores de lenguaje, se instalan y se ejecutan en el entorno remoto. La sincronización cubre el cliente, pero lo que ocurre dentro del contenedor o de la máquina remota requiere atención adicional.
Dev containers
Un dev container describe el entorno de desarrollo de un proyecto mediante un archivo devcontainer.json. Es el lugar ideal para fijar las extensiones y los ajustes que el proyecto necesita, de modo que cualquier persona obtenga exactamente lo mismo al abrir la carpeta dentro del contenedor.
mi-servicio/
├── .devcontainer/
│ ├── devcontainer.json
│ └── Dockerfile
├── .vscode/
│ ├── extensions.json
│ └── settings.json
├── src/
└── README.md
Un archivo mínimo que instala extensiones y define ajustes dentro del contenedor tendría esta forma.
{
"name": "servicio-api",
"build": {
"dockerfile": "Dockerfile"
},
"customizations": {
"vscode": {
"extensions": [
"dbaeumer.vscode-eslint",
"esbenp.prettier-vscode",
"ms-azuretools.vscode-docker"
],
"settings": {
"editor.formatOnSave": true,
"terminal.integrated.defaultProfile.linux": "bash"
}
}
},
"postCreateCommand": "npm install"
}
Observa que la clave customizations.vscode es la forma actual de declarar extensiones y ajustes. Las claves antiguas de primer nivel, como extensions y settings colgando directamente de la raíz, quedaron obsoletas, así que si encuentras ejemplos antiguos con esa estructura conviene migrarlos.
La combinación funciona así: las extensiones de la sincronización personal se mantienen en el cliente, y las declaradas en el archivo del contenedor se instalan dentro de él. Si quieres que una extensión personal se instale siempre en cada contenedor sin tocar el archivo de cada proyecto, el editor ofrece un ajuste de usuario para extensiones que deben instalarse en todos los contenedores.
{
"dev.containers.defaultExtensions": [
"eamodio.gitlens",
"usernamehw.errorlens"
]
}
Con esto, tus herramientas favoritas te acompañan a cualquier contenedor, sin imponérselas al resto del equipo.
SSH y WSL
El caso de las conexiones SSH es análogo. Existe un ajuste que lista las extensiones que se instalarán automáticamente en cada servidor remoto al que te conectes.
{
"remote.SSH.defaultExtensions": [
"ms-python.python",
"redhat.vscode-yaml"
]
}
Para WSL el comportamiento es parecido: el editor instala en la distribución las extensiones que necesitan ejecutarse allí. Una buena práctica es mantener el archivo de recomendaciones del proyecto actualizado, porque es la fuente que todos los entornos consultan.
Codespaces y entornos en la nube
Los entornos alojados en la nube también admiten la sincronización de ajustes. Si inicias sesión con tu cuenta de GitHub en un espacio de código, puedes activar la sincronización y recibir tus preferencias. Hay una opción propia para configurar qué se sincroniza entre tu cuenta y estos espacios. Como el entorno es efímero, la sincronización evita volver a configurar el editor cada vez que se crea uno nuevo.
Alternativa basada en archivos y Git
Hay personas que prefieren controlar el proceso por completo. Si tu configuración vive en archivos, puedes versionarla con Git junto al resto de tus dotfiles. Es un método más manual, pero transparente, auditable y completamente independiente de cualquier servicio.
La idea consiste en mover los archivos de configuración a un repositorio y enlazarlos simbólicamente al directorio del editor. Un ejemplo en Linux sería este.
mkdir -p ~/dotfiles/vscode
mv ~/.config/Code/User/settings.json ~/dotfiles/vscode/
mv ~/.config/Code/User/keybindings.json ~/dotfiles/vscode/
ln -s ~/dotfiles/vscode/settings.json ~/.config/Code/User/settings.json
ln -s ~/dotfiles/vscode/keybindings.json ~/.config/Code/User/keybindings.json
Con los enlaces en su sitio, cualquier cambio que hagas desde el editor modifica directamente el archivo del repositorio, y puedes confirmarlo con Git como cualquier otro cambio.
cd ~/dotfiles
git add vscode
git commit -m "Ajusta formateo y atajos del editor"
git push
En otra máquina, clonas el repositorio y repites los enlaces. Para las extensiones, acompaña el repositorio de un archivo con la lista y del script de instalación que vimos antes.
La comparación entre ambos enfoques es clara. La sincronización integrada gana en comodidad, ya que no hay nada que hacer tras activarla, e incluye perfiles y estado de la interfaz. El método de archivos gana en control, historial detallado y capacidad de revisar cada cambio, y encaja mejor en equipos que ya gestionan sus dotfiles. Nada impide combinarlos: usar la sincronización para el día a día y mantener un respaldo versionado de los ajustes clave.
Una advertencia importante: si enlazas el archivo de ajustes y a la vez tienes la sincronización integrada activa para esa misma categoría, ambos mecanismos pueden pelearse. Elige uno por categoría, o desactiva la categoría correspondiente en la sincronización.
Conflictos y fusiones: cómo decidir con criterio
Cuando dos máquinas modifican el mismo ajuste antes de sincronizarse, aparece un conflicto. El editor no sobrescribe en silencio: abre una vista de comparación con ambas versiones y te pide que elijas. Para ajustes y atajos utiliza un editor de fusión, donde ves el valor local, el remoto y el resultado final, y puedes aceptar uno u otro, o editar a mano el resultado.
Para reducir la frecuencia de conflictos, aplica estas costumbres. Cambia los ajustes en una sola máquina cuando sea posible y deja que se sincronicen antes de tocar nada en otra. Evita editar settings.json en dos ventanas distintas a la vez. Revisa los avisos de conflicto el mismo día en que aparezcan, porque un conflicto sin resolver detiene la sincronización de esa categoría. Y utiliza los comentarios dentro del archivo de ajustes para anotar por qué existe cada valor no evidente.
Si resuelves mal un conflicto, no pasa nada irreparable. La vista de datos sincronizados conserva un historial de versiones anteriores. Puedes abrirla con el comando de mostrar datos sincronizados, elegir la categoría y restaurar una versión previa. Esta posibilidad es el motivo por el que merece la pena confiar en la función en lugar de guardar copias manuales a diario.
Otro escenario delicado es la convivencia entre la edición estable y la edición Insiders. Por defecto usan servicios de sincronización separados, de modo que no comparten datos. Se puede apuntar Insiders al servicio de la edición estable, pero como Insiders recibe cambios antes, es posible que escriba datos en un formato que la estable no entiende; en ese caso, la sincronización de la estable se desactiva por seguridad. Si usas ambas, lo más sensato es mantenerlas separadas.
Solución de problemas habituales
Aunque la función es estable, hay síntomas que se repiten. Esta sección reúne los más comunes con su causa probable y su remedio.
La sincronización no arranca o se detiene
Abre el registro con el comando correspondiente y busca mensajes de error. Las causas típicas son una sesión caducada, una conexión bloqueada por un proxy corporativo o un conflicto sin resolver. Cierra sesión desde el icono de cuentas y vuelve a iniciar. Si estás detrás de un proxy, comprueba que el editor tiene configurado el proxy del sistema y que permite el tráfico hacia el servicio de sincronización.
Settings Sync: Show Log
Las extensiones no se instalan en el segundo equipo
Comprueba que la categoría de extensiones esté marcada en la configuración de sincronización. Verifica también que la extensión no figure en la lista de exclusión y que esté disponible para la plataforma del equipo destino: algunas extensiones solo existen para ciertos sistemas operativos o arquitecturas, y el editor no las instala donde no son compatibles.
Los ajustes cambian de valor de forma inesperada
Suele deberse a un ajuste que sí debería haberse excluido, como la fuente o el nivel de zoom. Añádelo a la lista de exclusión y revisa el historial de datos sincronizados para recuperar el valor anterior. Si el problema se repite, activa los atajos por plataforma y revisa que no estés compartiendo valores dependientes del sistema operativo.
Los datos remotos quedaron dañados o inconsistentes
Como último recurso puedes borrar los datos almacenados en la nube y empezar de nuevo. Desde la configuración de la sincronización encontrarás la opción para limpiar los datos remotos. Antes de usarla, haz una copia de tu carpeta de usuario local, porque tras la limpieza la nube quedará vacía y la siguiente subida tomará tu estado actual como referencia.
Settings Sync: Reset Synced Data
Aparece un aviso de versión incompatible
Ocurre cuando un equipo con una versión más reciente escribió datos que otro más antiguo no comprende. La solución es actualizar el editor en el equipo atrasado. Mantener todas las instalaciones razonablemente al día evita este tipo de avisos.
Un perfil no aparece en otra máquina
Verifica que la categoría de perfiles esté activa en ambos equipos y que ambas sincronizaciones hayan terminado. Si el perfil se creó hace unos segundos, espera a que se complete la siguiente sincronización o fuerza una desde el menú de la sincronización. Comprueba, además, que ambas instalaciones usen el mismo servicio y la misma cuenta.
Seguridad y privacidad de tu configuración
Un archivo de ajustes parece inofensivo, pero a menudo contiene más información de la que imaginas. Estas son las precauciones que conviene tomar.
La primera es no guardar secretos jamás en settings.json. Los tokens de acceso, las claves de API y las contraseñas no deben escribirse nunca en los ajustes del editor. Si una extensión necesita una credencial, utiliza el almacenamiento seguro que ofrece el propio editor o una variable de entorno. Los ajustes que sí se sincronizan viajan a un servicio externo, y aunque el tráfico va cifrado, no hay razón para exponer credenciales ahí. Recuerda que, si exportas un perfil y lo compartes, estarías compartiendo también cualquier dato sensible que contenga.
La segunda precaución es revisar las rutas y los nombres de servidor. Un ajuste que apunta a un host interno de tu empresa, o una ruta con el nombre de un cliente, revela información de tu organización. Si trabajas con proyectos confidenciales, excluye esas claves de la sincronización y colócalas en los ajustes del espacio de trabajo, que no salen de tu repositorio.
La tercera es desconfiar de las extensiones. Sincronizar extensiones significa que una extensión que instales en una máquina aparecerá en todas. Instala solo extensiones de editores de confianza, revisa el número de descargas y el historial de actualizaciones, y desactiva las que no uses. Una extensión maliciosa instalada en un equipo se replicaría en el resto sin que lo notes. En equipos corporativos, valora restringir las extensiones permitidas con las políticas que ofrece el editor.
La cuarta es proteger la cuenta. Dado que el acceso a la sincronización depende de tu cuenta de Microsoft o de GitHub, activa la verificación en dos pasos. Quien controle tu cuenta podría recuperar tus ajustes y la lista de extensiones. Si sospechas de un acceso indebido, cierra todas las sesiones desde la configuración de la cuenta y limpia los datos remotos.
La quinta es el cifrado. Los datos viajan por canales seguros y se almacenan cifrados, pero el modelo de confianza es el de un servicio gestionado. Si tus requisitos de privacidad no permiten ese modelo, el método de archivos con Git en un repositorio privado y bajo tu control es la alternativa razonable. Incluso en ese caso, mantén fuera del repositorio cualquier secreto.
Buenas prácticas para mantener el entorno ordenado
Una vez que todo funciona, el reto es que siga funcionando. Estas costumbres ayudan a conservar un entorno limpio y predecible.
Revisa periódicamente la lista de extensiones. Con el tiempo se acumulan herramientas que ya no usas, y cada una consume memoria y arranque. Desinstalar una extensión en una máquina la quitará de todas, así que haz la limpieza con calma. Si notas lentitud tras sincronizar muchas extensiones, el artículo sobre cómo optimizar el rendimiento de VS Code en 2026 detalla cómo medir el consumo de cada una y qué ajustes aligeran el editor.
Documenta tus decisiones. Un comentario junto a un ajuste poco evidente te ahorrará dudas dentro de seis meses. El archivo de ajustes admite comentarios, así que úsalos sin miedo.
Empieza por un conjunto pequeño. Si estás configurando el editor desde cero para un flujo de trabajo concreto, como el desarrollo de interfaces y servicios, conviene seguir una guía ordenada como la de configurar VS Code para desarrollo web paso a paso, y activar la sincronización cuando la base esté estable. Así evitas propagar por todas partes ajustes que luego tendrás que deshacer.
Usa los perfiles con criterio. Más no es mejor: tres o cuatro perfiles bien definidos son manejables, mientras que quince acaban siendo una fuente de confusión. Dale a cada perfil un nombre descriptivo y un propósito claro.
Mantén los ajustes de equipo en el repositorio y los personales en tu cuenta. Esta división evita el clásico problema de que algo funciona en una máquina y no en otra, y permite que una persona nueva se incorpore sin ceremonia.
Por último, prueba tu proceso de recuperación. De poco sirve tener sincronización si nunca has verificado que puedes reconstruir el entorno en una máquina limpia. Una vez al año, o cuando cambies de equipo, hazlo con calma: instala el editor, activa la sincronización y comprueba que todo aparece. Si algo falta, corrígelo mientras no hay prisa.
Un flujo completo de ejemplo
Para cerrar la parte práctica, veamos un escenario realista que reúne lo anterior. Una desarrolladora trabaja con un portátil personal, un equipo de oficina y un contenedor por proyecto. Quiere que su apariencia y sus atajos sean idénticos en todas partes, que cada proyecto tenga sus reglas y que nada sensible se filtre.
Primero activa la sincronización en el portátil y selecciona todas las categorías. Después crea tres perfiles: uno de desarrollo web, otro de datos y otro de escritura. Excluye la fuente, el zoom y las rutas de intérpretes con la lista de exclusión, y activa los atajos por plataforma porque combina macOS y Linux.
Luego, en cada proyecto, versiona la carpeta .vscode con las reglas de formateo y las recomendaciones de extensiones, y añade un devcontainer.json con las herramientas imprescindibles. En sus ajustes de usuario declara las extensiones personales que quiere en todos los contenedores.
En el equipo de oficina inicia sesión con la misma cuenta, elige fusionar y revisa los conflictos. Para la conexión por SSH a los servidores de pruebas, declara las extensiones por defecto del remoto. Finalmente, guarda una copia exportada del perfil de desarrollo web en el repositorio del equipo, para que sus compañeros lo importen si lo desean.
El resultado es un entorno coherente, con responsabilidades claras: lo personal viaja con la cuenta, lo del proyecto viaja con el repositorio y lo del entorno viaja con el contenedor. Cada capa tiene su lugar y ninguna pisa a las demás.
Conclusiones
Mantener el mismo editor en todos tus equipos ya no exige trucos ni extensiones externas. La sincronización integrada cubre ajustes, atajos, snippets, tareas, extensiones y perfiles con una activación de pocos minutos, y te protege con un historial de versiones y un asistente de fusión cuando surgen diferencias.
El punto de partida es entender qué categorías viajan y cuáles no, y excluir con criterio lo que depende de la máquina. Los perfiles aportan la pieza que faltaba: contextos aislados que se sincronizan y se pueden exportar para compartirlos con un equipo. Para los entornos remotos, el archivo del contenedor y las recomendaciones del proyecto fijan lo que importa al equipo, mientras que tus preferencias personales te acompañan mediante los ajustes de extensiones por defecto.
Si necesitas más control, el método de archivos con Git es una alternativa sólida, siempre que no lo mezcles con la sincronización integrada en la misma categoría. Y en cualquiera de los dos casos, aplica las precauciones de seguridad: sin secretos en los ajustes, con extensiones de confianza y con la cuenta protegida por verificación en dos pasos.
Dedica una tarde a ordenar tu configuración, prueba la recuperación en una máquina limpia y habrás eliminado una de las pequeñas fricciones que más tiempo roban al trabajo diario. A partir de ahí, cambiar de equipo será tan simple como iniciar sesión y esperar a que el editor haga el resto.
