Saltar al contenido principal
VS Code

Solución: 'The terminal process failed to launch' en VS Code

¿VS Code no abre la terminal integrada? Soluciones para Windows, Mac y Linux: PATH corrupto, shell por defecto, permisos y perfiles rotos.

Error: The terminal process failed to launch

¿Por qué ocurre?

VS Code no puede iniciar el proceso de shell configurado como terminal por defecto. Las causas más comunes: la ruta al shell (PowerShell, bash, zsh) es incorrecta, el perfil de terminal tiene una variable de entorno corrupta, un antivirus bloquea la ejecución, o la configuración de VS Code tiene un shell profile roto tras una actualización.

Solución paso a paso

Solución rápida — Resetea la terminal por defecto:

1. Abre Ctrl+Shift+P → busca Terminal: Select Default Profile 2. Selecciona PowerShell (Windows) o bash/zsh (Mac/Linux) 3. Cierra todas las terminales abiertas y abre una nueva con ` Ctrl+ `

Si sigue fallando — Verifica la configuración en settings.json:

// Abre con Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"
// Busca y elimina o corrige estas líneas:

// ❌ Ruta incorrecta o que ya no existe "terminal.integrated.shell.windows": "C:\\ruta\\que\\no\\existe.exe"

// ✅ Usa la configuración moderna (profiles) "terminal.integrated.defaultProfile.windows": "PowerShell", "terminal.integrated.profiles.windows": { "PowerShell": { "source": "PowerShell", "icon": "terminal-powershell" }, "Command Prompt": { "path": "C:\\Windows\\System32\\cmd.exe" } }

En Mac/Linux:

"terminal.integrated.defaultProfile.osx": "zsh",
"terminal.integrated.defaultProfile.linux": "bash"

Si el problema es el PATH:

# Windows — verifica que PowerShell funciona fuera de VS Code
powershell -Command "echo 'OK'"

# Si da error, reinstala PowerShell o repara la variable PATH: # Panel de control → Sistema → Variables de entorno # Verifica que C:\Windows\System32\WindowsPowerShell\v1.0 está en PATH

Si un antivirus bloquea la terminal:

1. Añade VS Code a las excepciones del antivirus 2. Ruta típica: C:\Users\TU_USUARIO\AppData\Local\Programs\Microsoft VS Code\Code.exe`

Último recurso — Resetea toda la configuración de terminal:

// En settings.json, elimina TODAS las líneas que empiecen por:
// "terminal.integrated."
// Luego reinicia VS Code

Cómo evitarlo en el futuro

No edites manualmente las rutas de shell en settings.json — usa el selector de perfiles de VS Code. Si cambias de versión de PowerShell o instalas WSL, selecciona de nuevo el perfil por defecto. Mantén VS Code actualizado porque las claves de configuración de terminal cambian entre versiones.

VS CodeErrorTerminal

¿Quieres que una IA te ayude? Genera el prompt perfecto para tu error:

Generador de Prompts

¿Necesitas desarrollo a medida?

Apps web, IA, módulos ERP — cuéntame tu proyecto.