Guía completa para instalar y usar Visual Studio Code en Ubuntu (edición 2025)

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

Visual Studio Code (en adelante referido como VS Code) es un editor de código fuente ligero pero altamente potente. Proporcionado por Microsoft, es ampliamente respaldado por desarrolladores de todo el mundo gracias a su base de código abierto y excelente extensibilidad. Además de Windows y macOS, se ejecuta de manera estable en sistemas operativos basados en Linux.

Entre ellos, Ubuntu es una de las distribuciones de Linux más utilizadas a nivel global. Ofrece lanzamientos oficiales de Soporte a Largo Plazo (LTS), proporcionando una fuerte estabilidad y seguridad. Ubuntu es gratuito para usar y se beneficia de un ecosistema rico en paquetes y un fuerte soporte comunitario, lo que lo hace adecuado tanto para el desarrollo individual como para el uso profesional.

Las ventajas de usar VS Code en Ubuntu incluyen:

• Rendimiento ligero y rápido : Se ejecuta sin problemas incluso en máquinas de especificaciones bajas o entornos en la nube
• Ecosistema extenso de extensiones : Agrega fácilmente soporte para idiomas, integración con Git, funciones de desarrollo remoto y más
• Consistencia multiplataforma : La misma experiencia de usuario en diferentes sistemas operativos
• Soporte oficial : Microsoft proporciona paquetes oficiales para Ubuntu con una gestión de actualizaciones fácil

Este artículo explica pasos prácticos en orden, desde la instalación de VS Code en Ubuntu hasta la localización en japonés, la configuración del entorno de desarrollo, el desarrollo remoto y el uso de contenedores. Ya sea que seas nuevo en Ubuntu o estés considerando migrar desde otro editor, esta guía te ayudará a construir un entorno completo de VS Code en el menor tiempo posible.

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

Al instalar VS Code en Ubuntu, hay tres métodos principales disponibles. Compara sus características, ventajas y desventajas para elegir el que mejor se adapte a tus necesidades.

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

Características

• Distribuido en el formato Snap, el sistema de gestión de paquetes estándar de Ubuntu.
• Se puede instalar con un solo clic desde el Centro de software de Ubuntu.
• Desde la terminal, la instalación se realiza usando sudo snap install --classic code .

Ventajas

• Instalación fácil mediante GUI, ideal para principiantes.
• Actualizaciones automáticas mejoran la seguridad y aseguran el acceso a las últimas funciones.

Desventajas

• Debido al sandboxing, se han reportado problemas de compatibilidad con IME o temas.
• El inicio y la respuesta pueden sentirse ligeramente más lentos.

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

Características

• Usa el repositorio APT oficial de Microsoft para gestionar VS Code con apt .
• Después de registrar el repositorio usando un archivo .deb, la gestión se realiza con sudo apt update && sudo apt install code .

Ventajas

• Integrado con la gestión APT estándar para actualizaciones consistentes del sistema.
• Alta compatibilidad con métodos de entrada en japonés y otras funciones principales.
• Control simple y claro de actualizaciones.

Desventajas

• El registro inicial del repositorio requiere pasos adicionales.
• Puede sentirse menos accesible para usuarios acostumbrados solo a instalaciones GUI.

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 independiente usando el paquete DEB oficial

Características

• Descarga el paquete .deb directamente desde el sitio web oficial de Microsoft.
• Instala usando sudo apt install ./code_*.deb , lo que resuelve automáticamente las dependencias.

Ventajas

• Conveniente para entornos offline o con redes restringidas.
• No requiere registro de repositorio para la instalación inicial.

Desventajas

• Las actualizaciones automáticas requieren la configuración manual del repositorio después.
• Menos conveniente para el mantenimiento a largo plazo en comparación con los métodos Snap o APT.

2-4. ¿Qué método debes elegir?

• Facilidad de uso / Enfocado en GUI → Snap (Centro de software de Ubuntu)
• Estabilidad / Entrada en japonés y extensibilidad → APT (Repositorio oficial)
• Instalación única / Configuración mínima → DEB oficial (Independiente)

answer.Para el desarrollo diario con uso a largo plazo, el método APT (oficial de Microsoft) ofrece el mejor equilibrio y una gestión de actualizaciones sencilla. Snap es conveniente para pruebas rápidas o uso de prueba, mientras que el paquete DEB oficial es ideal para entornos restringidos o de verificación.

Basado en esta comparación, la siguiente sección explica el procedimiento de instalación recomendado usando el método “DEB oficial → integración APT” con ejemplos concretos de comandos.

3. Procedimiento A: Instalar vía DEB oficial con integración APT (Recomendado)

En esta sección, instalarás VS Code usando el paquete .deb oficial recomendado por Microsoft, al mismo tiempo que registras el repositorio APT para garantizar el acceso continuo a las versiones más recientes. Este método ofrece alta estabilidad para la entrada de japonés y ayuda a evitar problemas de compatibilidad de IME que a veces se reportan con la versión Snap.

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

1. Abre tu navegador y visita la página oficial de descarga de Visual Studio Code .
2. Haz clic en el botón .deb (para Debian/Ubuntu) para descargar el paquete.

3-2. Instalar vía Terminal

Si el archivo descargado se encuentra en ~/Downloads, ejecuta los siguientes comandos:

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

• Pasar el archivo .deb directamente a apt install resuelve automáticamente las dependencias requeridas.
• Este proceso también registra el repositorio APT de Microsoft.

3-3. Verificar la instalación

Comprueba la versión instalada usando el siguiente comando:

code --version

Alternativamente, busca “Visual Studio Code” en el menú de aplicaciones y ejecútalo.

3-4. Actualizar VS Code

Una vez registrado el repositorio APT, VS Code se actualizará junto con las actualizaciones del sistema:

sudo apt update
sudo apt upgrade

3-5. Desinstalación (Referencia)

Si necesitas eliminar VS Code, ejecuta:

sudo apt remove code
sudo apt autoremove

Con esta configuración, podrás seguir usando la última versión de VS Code con un mantenimiento mínimo.

4. Procedimiento B: Instalar usando Snap (GUI / CLI)

Snap es el formato de distribución de paquetes estándar de Ubuntu y permite la instalación a través del Centro de Software (GUI) o mediante simples operaciones en la línea de comandos. Es particularmente conveniente para principiantes o para quienes desean una configuración rápida sin una configuración detallada.

4-1. Instalar desde el Centro de Software (GUI)

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

4-2. Instalar desde la línea de comandos (CLI)

Abre una terminal y escribe el siguiente comando:

sudo snap install --classic code

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

4-3. Verificar la instalación

code --version

O bien, lanza “Visual Studio Code” desde el menú de aplicaciones.

4-4. Actualizaciones y eliminación

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

  sudo snap remove code
  

4-5. Notas sobre la versión Snap

• Entrada de japonés: Dependiendo del entorno y la configuración del IME, se han reportado problemas de entrada. Cambiar al método DEB → APT suele resolver estos problemas.
• Velocidad de inicio: Debido a la estructura de sandboxing de Snap, el primer lanzamiento puede ser ligeramente más lento.

5. Configuración inicial: Localización, fuentes y ajustes de pantalla

Después de instalar VS Code en Ubuntu, los primeros pasos deben ser la localización y la optimización de la legibilidad. Una configuración adecuada en esta etapa hace que el desarrollo futuro sea mucho más fluido.

5-1. Localización (Instalación del paquete de idioma japonés)

1. Inicia VS Code y haz clic en el icono de Extensiones (icono de cuatro cuadrados) en el lateral izquierdo.
2. Escribe Japanese Language Pack en la barra de búsqueda.
3. Instala “Japanese Language Pack for Visual Studio Code”.
4. Tras la instalación, haz clic en [Change Language] en la ventana emergente que aparece en la esquina inferior derecha.
5. Reinicia VS Code para aplicar la interfaz en japonés.

Para cambiar el idioma manualmente, abre la paleta de comandos con Ctrl+Shift+P (o F1), escribe Configure Display Language y selecciona ja.

5-2. Configuración de fuentes

Para programar, se recomiendan fuentes monoespaciadas que distingan claramente entre caracteres de ancho completo y medio.

1. Abre [File] → [Preferences] → [Settings].
2. Escribe “font family” en la barra de búsqueda.
3. Define la fuente que prefieras (p. ej., Cascadia Code, Fira Code, Noto Sans Mono CJK JP).

Usar fuentes con ligaduras habilitadas mejora la claridad visual de símbolos como => y ===.

5-3. Ajustes de visualización (temas e íconos)

• Selección de tema: pulsa Ctrl+K → Ctrl+T para abrir el selector de temas.
• Temas de íconos: usa Ctrl+Shift+P → File Icon Theme para cambiar el conjunto de íconos.

5-4. Configuraciones iniciales recomendadas adicionales

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

El entorno de trabajo básico ya está listo. La siguiente sección presenta extensiones esenciales y ejemplos de configuración para mejorar aún más la productividad.

6. Extensiones de uso frecuente y configuración básica (configuración en los primeros 10 minutos)

Una de las mayores fortalezas de VS Code es su capacidad para añadir funcionalidades mediante extensiones. Esta sección muestra las extensiones esenciales que debes instalar inmediatamente después de la configuración en Ubuntu, junto con los ajustes básicos que aumentan considerablemente la eficiencia del desarrollo.

6-1. Extensiones esenciales

1. Japanese Language Pack for Visual Studio Code
   * Extensión obligatoria para la visualización de la UI en japonés, explicada anteriormente.

2. Python
   * Fundamental para el desarrollo en Python, ofrece linting, autocompletado y depuración.
   * Cuando se combina con la extensión Jupyter, también se soporta el desarrollo estilo cuaderno.

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

4. GitLens
   * Muestra visualmente el historial de Git y los diffs, resultando extremadamente útil para el trabajo en equipo y el seguimiento de cambios.

5. Remote Development Pack
   * Un paquete integrado que permite desarrollar mediante SSH, dentro de contenedores Docker o en WSL.
   * Se detalla con mayor profundidad en la sección de Desarrollo Remoto.

6. Prettier – Code Formatter
   * Formatea el código automáticamente. Soporta JavaScript, TypeScript, HTML y CSS.

6-2. Configuraciones iniciales

• Formato al guardar

  "editor.formatOnSave": true
  

Esto garantiza un formato consistente cada vez que guardas un archivo.

• Ancho de tabulación e indentación

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

Ajusta estos valores para que coincidan con las normas de codificación de tu equipo.

• Insertar salto de línea final

  "files.insertFinalNewline": true
  

• Mostrar números de línea

  "editor.lineNumbers": "on"
  

• Eliminar espacios en blanco finales

  "files.trimTrailingWhitespace": true
  

6-3. Activar la sincronización de configuraciones

Inicia sesión con una cuenta de VS Code (Microsoft o GitHub) y habilita Settings Sync para sincronizar automáticamente configuraciones y extensiones entre varios equipos o después de reinstalar el editor.

En este punto, el entorno de desarrollo principal está esencialmente completo.

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

Esta sección explica cómo configurar rápidamente entornos de desarrollo para Python y C/C++, que son los más usados en Ubuntu. Al añadir estas configuraciones a una instalación nueva de VS Code, podrás comenzar a desarrollar de forma práctica de inmediato.

7-1. Configuración del entorno Python

1. Instalar Python y herramientas de entorno virtual

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

• python3-venv proporciona entornos aislados por proyecto.
• pip es el gestor de paquetes.

1. Instalar extensiones de VS Code

• Instala la extensión oficial Python.
• Opcionalmente instala Jupyter para flujos de trabajo basados en notebooks.

1. Crear y activar un entorno virtual

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

VS Code detecta automáticamente el entorno virtual y lo muestra en el menú de selección del intérprete.

4. Configuración de lint y formato (ejemplo: ruff y black)

   pip install ruff black
   

Configura VS Code para ejecutar black para el formateo y ruff para el análisis estático al guardar.

7-2. Configuración del entorno C/C++

1. Instalar compiladores y paquetes esenciales

   sudo apt update
   sudo apt install build-essential gdb
   

• Incluye gcc, g++ y el depurador gdb.

1. Instalar extensiones de VS Code

• Instala la extensión oficial C/C++.
• Opcionalmente añade CMake Tools.

1. Configurar tareas de compilación

• Abre la paleta de comandos (Ctrl+Shift+P) y selecciona “Tasks: Configure Default Build Task”.
• Elige g++ build active file.
• Esto permite compilar el archivo actual con Ctrl+Shift+B.

1. Configurar depuración

• Pulsa F5 y selecciona “C++ (GDB/LLDB)”.
• Se crea un archivo .vscode/launch.json, habilitando la depuración basada en puntos de interrupción.

7-3. Verificación y ejecución de pruebas

Ejemplo en Python

print("Hello, Python on Ubuntu!")

Ejemplo en C++

#include <iostream>
using namespace std;

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

Guarda el archivo, compila C++ con Ctrl+Shift+B y ejecuta el ejecutable generado para verificar la funcionalidad.

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

VS Code permite un desarrollo cómodo no solo en máquinas locales, sino también en servidores remotos y entornos contenedorizados. En Ubuntu, combinar estas funciones mejora significativamente la flexibilidad y reproducibilidad.

8-1. Remote SSH

Visión general

Edita y ejecuta código ubicado en un servidor remoto directamente desde tu VS Code local. Un servidor de VS Code se ejecuta en el host remoto, ofreciendo una experiencia similar a la local.

Procedimiento

1. Instala el Remote Development Pack (incluye Remote – SSH).
2. Añade los detalles de conexión a ~/.ssh/config. Ejemplo:

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

3. Abre la paleta de comandos y selecciona “Remote-SSH: Connect to Host”, luego elige myserver.

Ventajas

• Edita, ejecuta y depura código sin iniciar sesión directamente en el servidor.
• Mantén los entornos locales limpios mientras desarrollas proyectos específicos del servidor.

8-2. Dev Containers

Visión general

Utiliza contenedores Docker como entornos de desarrollo en VS Code. La configuración se almacena en un directorio .devcontainer, permitiendo que cualquiera trabaje con la misma configuración.

Procedimiento

1. Instala Docker y Docker Compose en Ubuntu.
2. Instala la extensión Dev Containers.
3. Crea .devcontainer/devcontainer.json en la raíz del proyecto. Ejemplo:

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

4. Selecciona “Dev Containers: Reopen in Container” desde la paleta de comandos.

Ventajas

• Aísla completamente dependencias y toolchains por proyecto.
• Garantiza entornos consistentes entre los miembros del equipo.

8-3. GitHub Codespaces

Visión general

Un entorno de VS Code basado en la nube provisto por GitHub. Accesible mediante el navegador, permite iniciar el desarrollo al instante sin configuración local.

1. Abre un repositorio de GitHub.
2. Selecciona “Code” → “Codespaces” → “New codespace”.
3. En segundos, se lanza un entorno en la nube con VS Code en el navegador.
4. Opcionalmente, conéctate desde VS Code local.

Ventajas

• Permite el desarrollo completo incluso en dispositivos de baja especificación.
• Trabaja desde cualquier lugar con un entorno consistente.

9. Problemas comunes y solución de problemas

Dependiendo del entorno y el método de instalación, pueden ocurrir varios problemas al usar VS Code en Ubuntu. Esta sección resume problemas comunes y soluciones.

9-1. La entrada en japonés no funciona o es inestable

Causas

• Problemas de compatibilidad con IME en la versión Snap.
• Métodos de entrada que no funcionan correctamente dentro de entornos de sandbox.

Soluciones

• Desinstala la versión Snap y reinstala usando el método oficial DEB (integrado con APT).
• Reconfigura fcitx o ibus si es necesario.

9-2. Inicio lento o bajo rendimiento

Causas

• Inicialización del sandbox de Snap o carga pesada de extensiones.
• Demasiadas extensiones innecesarias habilitadas.

Soluciones

• Inicia con code --disable-extensions para identificar extensiones problemáticas.
• Cambiar de Snap a DEB a menudo mejora el rendimiento.

9-3. Ciertas extensiones no funcionan

Causas

• Bibliotecas faltantes o incompatibilidades con la versión de Ubuntu.
• Problemas de permisos en entornos de contenedores o remotos.

Soluciones

• Instala las dependencias requeridas usando sudo apt install .
• Verifica los permisos de acceso para las rutas requeridas.

9-4. Problemas de visualización o entrada en Wayland

Causas

• VS Code a menudo se ejecuta a través de XWayland, y la compatibilidad nativa con Wayland no está completamente madura.

Soluciones

• Inicia sesión usando una sesión Xorg.
• O lanza con la siguiente opción:

  code --ozone-platform=x11
  

9-5. Desinstalación completa

Soluciones

• 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. Política de seguridad y actualizaciones

Para el uso a largo plazo de VS Code en Ubuntu, mantener la seguridad y la funcionalidad actualizada es esencial.

10-1. Comportamiento de actualizaciones por método de instalación

1. APT (Repositorio oficial)

• Las actualizaciones se aplican junto con las actualizaciones del sistema usando sudo apt update && sudo apt upgrade .
• Proporciona un buen equilibrio entre estabilidad y nuevas funciones.

1. Snap

• Actualizado automáticamente por snapd.
• El momento de la actualización depende de la programación de snapd.

1. DEB independiente (Sin repositorio)

• No hay actualizaciones automáticas.
• Se requiere reinstalación manual para nuevas versiones.

10-2. Consideraciones de seguridad

• Usa fuentes confiables
• Siempre descarga desde el sitio web oficial o repositorios de Microsoft.
• Evita PPAs no oficiales o paquetes de terceros.
• Selección de extensiones
• Verifica editores y reseñas.
• Evita extensiones que no se han actualizado en períodos largos.
• Gestión de permisos
• Gestiona estrictamente claves y permisos para Remote SSH y contenedores.
• Evita exposiciones innecesarias de puertos y contenedores root en Docker.

10-3. Frecuencia de actualización recomendada

• Enfocado en estabilidad : Actualiza cada pocas semanas alineado con los horarios de Ubuntu LTS.
• Enfocado en funciones : Verifica actualizaciones semanalmente.
• Usuarios de Snap : Confía en actualizaciones automáticas, considera revertir con sudo snap revert code si ocurren problemas.

11. Resumen: Construye un entorno Ubuntu × VS Code completamente usable rápidamente

Este artículo cubrió métodos de instalación, configuración inicial, entornos de lenguaje, desarrollo remoto, solución de problemas y seguridad. A continuación, hay una hoja de ruta concisa para una configuración rápida.

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

1. Instalación

• Elige DEB oficial → integración con APT para estabilidad y actualizaciones fáciles.
• Usa Snap para pruebas rápidas, notando posibles problemas con IME.

1. Configuración inicial

. Instala el Paquete de idioma japonés.
Ajusta fuentes y temas.
* Habilita el formato al guardar y la numeración de líneas.

1. Extensiones esenciales

• Python, C/C++, GitLens, Remote Development Pack, Prettier.
• Habilita la sincronización de configuraciones.

1. Configuración del entorno de lenguaje

• Python: entornos virtuales y herramientas de lint/format.
• C/C++: compilador, depurador, tareas de compilación y depuración.

1. Desarrollo remoto

• Remote SSH para desarrollo basado en servidor.
• Dev Containers para aislamiento de proyectos.
• GitHub Codespaces para flujos de trabajo en la nube.

1. Seguridad y actualizaciones

• Usa solo fuentes oficiales.
• Realiza actualizaciones periódicas mediante APT o Snap.

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

• Los usuarios nuevos de Ubuntu pueden conseguir un entorno de desarrollo totalmente funcional en una hora siguiendo esta guía paso a paso.
• Los usuarios que migran desde otros editores pueden mejorar considerablemente su eficiencia usando las extensiones y funciones remotas de VS Code.
• En caso de problemas, el Capítulo 9 ofrece soluciones rápidas de recuperación.

Preguntas frecuentes

P1. ¿Debo usar la versión Snap o la versión APT?
R. Para una estabilidad a largo plazo, se recomienda la versión APT (a través del DEB oficial). Snap es aceptable para pruebas a corto plazo, pero puede presentar diferencias en el comportamiento del IME y en la velocidad de inicio.

P2. ¿Cómo habilito la localización japonesa?
R. Instala “Japanese Language Pack for Visual Studio Code” y selecciona ja mediante Configure Display Language, luego reinicia.

P3. La entrada en japonés no funciona. ¿Qué debo hacer?
R. Si usas Snap, cambia a la versión DEB oficial. Además, verifica la configuración de ibus o fcitx.

P4. ¿Qué se necesita para iniciar el desarrollo en Python?
R. Instala Python, python3-venv y pip, y luego agrega la extensión de Python en VS Code.

P5. La compilación de C/C++ falla.
R. Instala build-essential y gdb, habilita la extensión de C/C++ y configura las tareas de compilación.

P6. ¿Cómo utilizo Remote SSH?
R. Instala el Remote Development Pack, configura ~/.ssh/config y conéctate mediante la paleta de comandos.

P7. ¿Qué son los Dev Containers?
R. Permiten usar contenedores Docker como entornos de desarrollo aislados definidos por .devcontainer.

P8. ¿Con qué frecuencia debo actualizar?
R. Para estabilidad, actualiza cada pocas semanas. Para nuevas funciones, actualiza semanalmente. Las actualizaciones de Snap se realizan automáticamente.