Cómo instalar y configurar Visual Studio Code en Ubuntu: Guía completa para desarrolladores

1. Introducción: ¿Por qué usar VS Code en Ubuntu?

• Ligero y rápido: funciona cómodamente incluso en equipos de bajos recursos o entornos en la nube.
• Amplias extensiones: permite añadir fácilmente soporte para múltiples lenguajes, integración con Git y desarrollo remoto.
• Multiplataforma: asegura una experiencia consistente entre distintos sistemas operativos.
• Soporte oficial: Microsoft ofrece paquetes oficiales para Ubuntu, con actualizaciones sencillas.

2. Comparación de métodos de instalación: Snap / apt (repositorio de Microsoft) / DEB oficial

2-1. Snap (Centro de software o CLI)

• Distribuido en formato “Snap”, ampliamente utilizado como sistema estándar de gestión de paquetes en Ubuntu.
• Se puede instalar con un solo clic desde el Centro de software de Ubuntu.
• En la terminal basta con ejecutar sudo snap install --classic code para instalarlo.

• Fácil de obtener mediante interfaz gráfica (ideal para principiantes).
• Se actualiza automáticamente, lo que garantiza seguridad y acceso rápido a nuevas funciones.

• Al usar un sistema sandbox diferente al método tradicional, pueden surgir problemas de compatibilidad con IME o temas.
• En algunos casos, el arranque o la respuesta puede sentirse un poco más lenta.

2-2. apt (a través del repositorio oficial de Microsoft)

• Consiste en usar el repositorio APT oficial de Microsoft para gestionar VS Code con apt.
• Se registra el repositorio mediante un archivo .deb inicial y luego se gestiona normalmente con sudo apt update && sudo apt install code.

• Al integrarse con APT, la actualización y gestión se realizan de forma armoniosa con el sistema.
• Alta compatibilidad con la entrada de texto en japonés y otras funciones básicas, ofreciendo estabilidad.
• Control de actualizaciones sencillo y fácil de comprender.

• Requiere registrar el repositorio en la configuración inicial, lo que implica un paso adicional.
• Para quienes prefieren la instalación vía GUI, puede parecer un poco más complejo.

Linux Software Repository for Microsoft Products

Learn how to install Microsoft products on Linux using the p…

Technically Impossible

Microsoftレポジトリを登録し、Edge、VSCode、PowerShellを”apt install”する。 - Technically Impossible

Ubuntuでのパッケージ・マネジャーと言えば”apt”だが、そのレポジトリでVSCodeは提供されていない。Ubunt…

2-3. Instalación individual con archivo DEB oficial

• Descarga directa del paquete .deb desde el sitio oficial de Microsoft.
• Con el comando sudo apt install ./code_*.deb se instalan automáticamente las dependencias necesarias.

• Práctico en entornos sin conexión o con redes restringidas.
• No requiere registrar repositorio, útil si solo quieres realizar la instalación inicial rápidamente.

• Después de la instalación inicial, para recibir actualizaciones automáticas es necesario configurar el repositorio manualmente.
• Comparado con Snap o apt, requiere un poco más de esfuerzo para el mantenimiento continuo.

2-4. ¿Cuál método elegir? Diagrama de decisión

• Facilidad / uso con GUI → Snap (Centro de software de Ubuntu)
• Estabilidad / compatibilidad con entrada en japonés y extensiones → apt (repositorio oficial)
• Instalación rápida / mínima configuración → DEB oficial (individual)

3. Procedimiento A: Instalación con DEB oficial → integración con apt (recomendado)

3-1. Descargar el archivo DEB desde el sitio oficial

1. Accede en el navegador a la página oficial de descargas de Visual Studio Code.
2. Haz clic en el botón correspondiente a “.deb” (para Debian y Ubuntu) para descargar el archivo.

3-2. Instalar desde la terminal

cd ~/Descargas
sudo apt install ./code_*.deb

• Al pasar directamente el archivo .deb a apt install, las dependencias necesarias se resuelven automáticamente.
• Durante este proceso también se registra automáticamente el repositorio APT de Microsoft.

3-3. Verificar la instalación

code --version

3-4. Método de actualización

sudo apt update
sudo apt upgrade

3-5. Método de desinstalación (referencia)

sudo apt remove code
sudo apt autoremove

4. Procedimiento B: Instalación con Snap (GUI / CLI)

4-1. Instalación desde el Centro de software (GUI)

1. Abre el menú de Aplicaciones y selecciona Ubuntu Software.
2. Escribe en la barra de búsqueda “Visual Studio Code” o “code”.
3. Selecciona “Visual Studio Code” de la lista de resultados y haz clic en el botón Instalar.
4. Introduce tu contraseña y espera a que finalice la instalación.

4-2. Instalación desde la línea de comandos (CLI)

sudo snap install --classic code

• La opción --classic es necesaria para otorgar permisos de acceso al sistema de archivos.
• La descarga e instalación suelen completarse en pocos minutos.

4-3. Verificación de la instalación

code --version

4-4. Actualización y desinstalación

• La versión Snap se actualiza automáticamente, por lo que no es necesario hacerlo manualmente.
• Para desinstalarla, ejecuta:

sudo snap remove code

4-5. Precauciones con la versión Snap

• Entrada en japonés: en algunos entornos se han reportado problemas con IME. Si ocurre, cambia a la instalación DEB → APT mencionada antes.
• Velocidad de inicio: debido a la estructura sandbox de Snap, puede haber una ligera demora en el arranque inicial.

5. Configuración inicial: localización al japonés, fuentes y ajustes de visualización

5-1. Localización al japonés (instalación de Japanese Language Pack)

1. Inicia VS Code y haz clic en el icono de Extensiones en la barra lateral.
2. En la barra de búsqueda escribe Japanese Language Pack.
3. Instala la extensión Japanese Language Pack for Visual Studio Code.
4. Después de la instalación, aparecerá un mensaje emergente en la parte inferior derecha preguntando si deseas cambiar el idioma. Haz clic en [Change Language].
5. Reinicia VS Code y la interfaz se mostrará en japonés.

5-2. Configuración de fuentes

1. En el menú selecciona [Archivo] → [Preferencias] → [Configuración].
2. En la barra de búsqueda escribe “font family”.
3. Configura la fuente que prefieras, por ejemplo: Cascadia Code, Fira Code, Noto Sans Mono CJK JP.

5-3. Ajustes de visualización (tema e iconos)

• Cambio de tema: usa Ctrl+K → Ctrl+T para abrir el selector de temas y elige el esquema de color que prefieras.
• Tema de iconos: abre la paleta de comandos Ctrl+Shift+P, escribe File Icon Theme y selecciona un paquete de iconos para identificar mejor los tipos de archivo.

5-4. Configuraciones iniciales recomendadas

• Mostrar números de línea: establece editor.lineNumbers en on.
• Formato automático al guardar: habilita editor.formatOnSave.
• Guardado automático: configura files.autoSave en afterDelay con un tiempo corto de retardo.

6. Extensiones más utilizadas y configuraciones básicas (en los primeros 10 minutos)

6-1. Extensiones imprescindibles

1. Japanese Language Pack for Visual Studio Code

• Extensión esencial para mostrar la interfaz en japonés (ya explicada en la sección anterior).

1. Python

• Indispensable para desarrollo en Python. Permite linting (análisis de calidad), autocompletado y depuración.
• Combinada con la extensión Jupyter, habilita el trabajo en cuadernos interactivos.

1. C/C++

• Proporciona autocompletado, depuración y resaltado de sintaxis para C y C++.
• Se recomienda usarla junto con el paquete build-essential.

1. GitLens

• Muestra de forma visual el historial y las diferencias en Git. Muy útil en trabajo colaborativo.

1. Remote Development Pack

• Permite trabajar directamente en servidores SSH, contenedores Docker o WSL.
• Se explicará con más detalle en la sección de “Desarrollo remoto”.

1. Prettier – Code Formatter

• Formatea automáticamente el código. Compatible con JavaScript, TypeScript, HTML y CSS.

6-2. Configuraciones iniciales recomendadas

• Formato automático al guardar

  "editor.formatOnSave": true

• Tamaño de tabulación e indentación

  "editor.tabSize": 4,
  "editor.insertSpaces": true

• Línea en blanco al final del archivo

  "files.insertFinalNewline": true

• Mostrar números de línea

  "editor.lineNumbers": "on"

• Eliminar espacios en blanco innecesarios

  "files.trimTrailingWhitespace": true

6-3. Activar la sincronización de configuración (Settings Sync)

7. Configuración mínima de entornos por lenguaje

7-1. Entorno para Python

1. Instalar Python y herramientas de entornos virtuales

   sudo apt update
   sudo apt install python3 python3-venv python3-pip

• python3-venv: permite crear entornos virtuales aislados para cada proyecto.
• pip: gestor de paquetes de Python.

1. Instalar extensiones en VS Code

• Instala la extensión oficial Python.
• Si lo necesitas, añade también la extensión Jupyter para trabajar en formato de cuadernos interactivos.

1. Crear y activar un entorno virtual

   python3 -m venv .venv
   source .venv/bin/activate

4. Configurar linting y formateo (ejemplo con ruff y black)

   pip install ruff black

7-2. Entorno para C/C++

1. Instalar compiladores y paquetes necesarios

   sudo apt update
   sudo apt install build-essential gdb

• Incluye los compiladores gcc/g++ y el depurador gdb.

1. Instalar extensiones en VS Code

• Instala la extensión oficial C/C++.
• Opcionalmente añade CMake Tools si tu proyecto lo requiere.

1. Configurar tareas de compilación

• Abre la paleta de comandos con Ctrl+Shift+P, selecciona Tasks: Configure Default Build Task y elige g++ build active file.
• Ahora podrás compilar el archivo C/C++ actual con Ctrl+Shift+B.

1. Añadir configuración de depuración

• Pulsa F5 y selecciona C++ (GDB/LLDB).
• Esto generará .vscode/launch.json para usar puntos de interrupción y observar variables.

7-3. Pruebas de funcionamiento

print("Hello, Python on Ubuntu!")

#include <iostream>
using namespace std;

int main() {
    cout << "Hello, C++ on Ubuntu!" << endl;
    return 0;
}

8. Desarrollo remoto: Remote SSH / Dev Containers / Codespaces

8-1. Remote SSH

1. Instala la extensión Remote Development Pack (incluye “Remote – SSH”).
2. Edita tu archivo ~/.ssh/config para añadir la información de conexión. Ejemplo:

   Host miservidor
       HostName 192.168.0.50
       User ubuntu
       IdentityFile ~/.ssh/id_rsa

3. Abre la paleta de comandos (Ctrl+Shift+P), selecciona Remote-SSH: Connect to Host y elige miservidor.

• Permite editar, ejecutar y depurar sin iniciar sesión manual en el servidor.
• Evita modificar tu entorno local y facilita el desarrollo dependiente de un servidor específico.

8-2. Dev Containers

1. Instala Docker y Docker Compose en Ubuntu.
2. Instala la extensión Dev Containers en VS Code.
3. Crea el archivo .devcontainer/devcontainer.json en tu proyecto y define la configuración. Ejemplo:

   {
       "name": "Python Dev",
       "image": "python:3.11",
       "features": {},
       "settings": {
           "terminal.integrated.shell.linux": "/bin/bash"
       }
   }

4. Abre la paleta de comandos y selecciona Dev Containers: Reopen in Container.

• Aísla completamente dependencias y herramientas por proyecto.
• Garantiza que todo el equipo trabaje con un entorno idéntico, asegurando reproducibilidad.

8-3. GitHub Codespaces

1. Accede al repositorio en GitHub, haz clic en Code → Codespaces → New codespace.
2. En segundos se creará un entorno de desarrollo en la nube con VS Code disponible en el navegador.
3. Si lo prefieres, también puedes conectarte desde tu VS Code local.

• Posibilita desarrollo completo desde PCs de bajos recursos o incluso dispositivos móviles.
• Permite trabajar desde cualquier lugar con acceso a Internet manteniendo siempre el mismo entorno.

9. Problemas frecuentes y soluciones

9-1. No se puede escribir en japonés / conversión inestable

• En la versión Snap de VS Code pueden ocurrir incompatibilidades con el IME (sistema de entrada en japonés).
• En algunos casos, el método de entrada no funciona correctamente dentro del entorno sandbox.

• Desinstalar la versión Snap e instalar la versión DEB oficial (con APT).
• Reconfigurar fcitx o ibus si es necesario.

9-2. Inicio lento o rendimiento bajo

• El proceso de inicialización sandbox en Snap o la carga de muchas extensiones puede ralentizar el arranque.
• Demasiadas extensiones activas al mismo tiempo.

• Inicia con la opción code --disable-extensions para identificar extensiones problemáticas y desinstalarlas.
• Cambiar de Snap a la versión DEB puede mejorar la velocidad.

9-3. Algunas extensiones no funcionan

• Dependencias faltantes en la versión de Ubuntu.
• Falta de permisos en entornos remotos o contenedores.

• Instala los paquetes necesarios con sudo apt install.
• Verifica permisos en las rutas a las que la extensión necesita acceder.

9-4. Problemas en entornos Wayland (pantalla o entrada inestables)

• VS Code suele ejecutarse sobre XWayland, y el soporte nativo Wayland aún no está completamente maduro.

• En la pantalla de inicio de sesión selecciona Xorg como sesión.
• O inicia con el siguiente comando:

  code --ozone-platform=x11

9-5. Desinstalación completa

• Versión DEB:

  sudo apt remove code
  sudo apt autoremove
  rm -rf ~/.config/Code

• Versión Snap:

  sudo snap remove code
  rm -rf ~/.config/Code

10. Seguridad y políticas de actualización

10-1. Comportamiento de actualización según el método de instalación

1. Versión APT (repositorio oficial)

• Como se registra el repositorio oficial de Microsoft, al ejecutar sudo apt update && sudo apt upgrade se actualiza junto con el sistema.
• Incluye parches de seguridad y nuevas funciones, equilibrando estabilidad y actualidad.

1. Versión Snap

• Snapd gestiona las actualizaciones automáticas, sin intervención del usuario.
• No obstante, el momento de la actualización depende del programador de Snapd y puede no reflejarse de inmediato.

1. Instalación DEB individual (sin repositorio)

• No se actualiza automáticamente.
• Cuando necesites una versión nueva deberás descargarla de nuevo desde el sitio oficial e instalarla manualmente.

10-2. Recomendaciones de seguridad

• Descargar solo de fuentes oficiales: usa siempre la página oficial o el repositorio oficial de Microsoft.
• Evita PPAs no oficiales o paquetes de terceros, ya que pueden estar manipulados o contener malware.
• Selección de extensiones: revisa la reputación del autor y las valoraciones antes de instalar. Evita extensiones de origen desconocido.
• Desconfía de extensiones que no se actualicen desde hace mucho tiempo, pues podrían tener vulnerabilidades.
• Gestión de permisos: si usas Remote SSH o Dev Containers, controla rigurosamente los permisos y las claves públicas.
• En Docker, evita abrir puertos innecesarios o usar contenedores con privilegios de root de forma habitual.

10-3. Frecuencia recomendada de actualización

• Si buscas estabilidad: actualiza cada pocas semanas, siguiendo el ciclo de versiones LTS de Ubuntu.
• Si quieres probar nuevas funciones: revisa semanalmente las actualizaciones e instala la última versión.
• Con Snap: confía en las actualizaciones automáticas, pero si surge un error puedes retroceder manualmente con sudo snap revert code.

11. Conclusión: el entorno Ubuntu × VS Code más rápido y listo para usar

11-1. Pasos para la configuración más rápida

1. Instalación

• Si priorizas estabilidad y facilidad de actualización, usa la opción DEB oficial → con integración en APT.
• Si solo quieres probar rápidamente, la versión Snap también es válida (aunque puede haber problemas con la entrada en japonés).

1. Configuración inicial

• Instala el Japanese Language Pack para habilitar la interfaz en japonés.
• Ajusta fuentes y temas a tu preferencia.
• Activa configuraciones básicas como formato automático y números de línea.

1. Instalación de extensiones esenciales

• Python, C/C++, GitLens, Remote Development Pack, Prettier, entre otras.
• Activa Settings Sync para mantener el mismo entorno en varios equipos.

1. Preparar entornos de desarrollo

• Python: instala python3-venv, configura el formateo y linting.
• C/C++: instala build-essential, configura tareas de compilación y depuración.

1. Configurar desarrollo remoto

• Conéctate a servidores mediante Remote SSH.
• Usa Dev Containers para aislar proyectos.
• Explora Codespaces en GitHub para desarrollo en la nube.

1. Seguridad y actualizaciones

• Descarga únicamente de fuentes oficiales.
• Limita las extensiones a las de confianza.
• Ejecuta periódicamente apt upgrade o confía en las actualizaciones automáticas de Snap.

11-2. Cómo aprovechar este artículo

• Si es tu primera vez con Ubuntu, siguiendo este orden tendrás un entorno listo en menos de una hora.
• Si vienes de otro editor, VS Code te permitirá aumentar tu productividad gracias a sus extensiones y soporte para desarrollo remoto.
• Si enfrentas problemas, revisa la sección 9 de resolución de problemas para solucionarlos rápidamente.

FAQ (Preguntas frecuentes)