Cómo configurar el workspace de vscode

Si estás usando Visual Studio Code (VS Code) y quieres que el workspace quede configurado dentro del folder del proyecto, normalmente se hace creando un archivo .code-workspace o guardando la configuración dentro del directorio .vscode.

¿Qué son los settings en VS Code?

Los settings son la forma en la que VS Code configura su comportamiento: temas, fuentes, reglas de editor, plugins, formateadores, etc.

Pueden estar escritos en JSON o manipulados desde la interfaz gráfica (GUI). Ambos modifican los mismos archivos.

Tipos de settings (Niveles)

1️⃣ User Settings (Configuración de usuario)

Afectan a todo VS Code.
Siempre se aplican, a menos que otro nivel las sobreescriba.
Archivo:
- En Linux: ~/.config/Code/User/settings.json
- Windows: %APPDATA%\Code\User\settings.json
- Mac: ~/Library/Application Support/Code/User/settings.json

2️⃣ Workspace Settings (Configuración del proyecto)

Solo afectan al proyecto abierto.
Útiles para configurar formateo, reglas de linting, o plugins específicos del repo.
Archivo:
- .vscode/settings.json dentro del proyecto.

3️⃣ Folder Settings (si tienes multi-root workspace)

Si usas un workspace tipo .code-workspace, puedes tener ajustes por carpeta.
Archivo:
- Dentro del .code-workspace secciones por carpeta.

4️⃣ Remote Settings (SSH, Dev Containers, Codespaces)

Configuraciones que se aplican cuando trabajas en entornos remotos.
Permiten tener un editor más adaptado al host remoto.

Cómo configurar el workspace de vscode en el folder del proyecto

Opción 1: Configurar el workspace dentro del proyecto (recomendado para proyectos individuales)

Paso 1: Abre el proyecto

En VS Code: File → Open Folder

Selecciona la carpeta raíz del proyecto.

Ejemplo:

mi-proyecto/

Paso 2: Guarda el Workspace

Ve a: File → Save Workspace As...

Guárdalo dentro del proyecto.

Ejemplo:

mi-proyecto/
├── .vscode/
├── src/
├── pom.xml
├── application.properties
└── mi-proyecto.code-workspace

Paso 3: Configura el workspace

Se creará algo como:

mi-proyecto.code-workspace

{
  "folders": [
    {
      "path": "."
    }
  ],
  "settings": {
    "editor.tabSize": 4,
    "files.autoSave": "afterDelay",
    "java.configuration.updateBuildConfiguration": "automatic"
  }
}

Con esto el workspace siempre abrirá ese proyecto.

Para abrirlo: File → Open Workspace from File

Opción 2: Configuración persistente usando `.vscode` (la más común)

Dentro del proyecto crea:

mi-proyecto/
└── .vscode/
    ├── settings.json
    ├── launch.json
    └── tasks.json

settings.json

Configuración local del proyecto:

{
    "java.configuration.updateBuildConfiguration": "automatic",
    "editor.formatOnSave": true,
    "files.exclude": {
        "**/target": true
    }
}

launch.json (debug)

Para Java + Micronaut + Maven:

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "java",
            "name": "Debug Micronaut",
            "request": "launch",
            "mainClass": "com.example.Application"
        }
    ]
}

tasks.json (ejecutar Maven)

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "run-micronaut",
            "type": "shell",
            "command": "./mvnw mn:run"
        }
    ]
}

Para verificar que VS Code está usando el workspace del proyecto

Abre terminal integrada:

pwd

Debe mostrar:

/home/oscar/mi-proyecto

Y revisa:

Explorer
↓
.vscode/

Si aparece ahí, la configuración quedó ligada al proyecto y no global.

Paso 2: Guarda el Workspace

Comentario