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.