Cómo crear y gestionar snippets de código en VS Code

Por Sayaib SarkarActualizado el 4 min de lectura

En esta página 5 secciones

Respuesta corta: VS Code incluye snippets de serie: ejecuta Snippets: Configure Snippets, elige un lenguaje o un archivo del proyecto y escribe cada snippet como JSON con un prefix y un body. Para ir más rápido, selecciona código y guárdalo como snippet en unos segundos con Create Snippet de DevSnip Pro, y usa sus snippets ds- para Spring Boot, ASP.NET Core, FastAPI, React, Next.js, Flutter y SwiftUI.

Un buen snippet ahorra más que pulsaciones. Guarda la versión de un patrón que ya has depurado: el gestor de errores con los códigos de estado correctos, la prueba con la configuración correcta, el envoltorio de fetch que comprueba response.ok.

Dónde guarda VS Code los snippets

ÁmbitoArchivoÚsalo para
Un lenguajetypescript.json en tu carpeta de snippets de usuarioSnippets personales para un lenguaje
Global*.code-snippets en tu carpeta de snippets de usuarioSnippets personales para varios lenguajes
Proyecto.vscode/*.code-snippets en el repositorioSnippets del equipo, versionados con el código

Abre cualquiera de ellos con Snippets: Configure Snippets (en versiones antiguas, Preferences: Configure User Snippets) desde la Paleta de comandos, Ctrl/Cmd+Shift+P.

Escribe un snippet a mano

Un snippet es una entrada con nombre que tiene el texto que escribes (prefix), las líneas que inserta (body) y una description opcional que se muestra en IntelliSense:

JSON
{
  "Express route handler": {
    "prefix": "exroute",
    "scope": "javascript,typescript",
    "body": [
      "router.${1|get,post,put,delete|}('/${2:path}', async (req, res, next) => {",
      "  try {",
      "    $0",
      "  } catch (err) {",
      "    next(err);",
      "  }",
      "});"
    ],
    "description": "Async Express route that passes errors to next()"
  }
}

La sintaxis que hace útiles los snippets:

  • $1, $2… son tabulaciones: Tab salta entre ellas y $0 es donde termina el cursor.
  • ${1:path} es un marcador con texto por defecto que puedes sobrescribir.
  • ${1|get,post,put,delete|} es una elección: una lista desplegable de valores.
  • Las variables como $TM_FILENAME_BASE, $CURRENT_YEAR y $CLIPBOARD insertan contexto. ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/} convierte user-card en UserCard.
  • scope (en los archivos .code-snippets) limita un snippet a algunos lenguajes.

Dentro de body, escapa un $ literal como \\$, y } dentro de un marcador como \\}.

Guarda un snippet a partir del código seleccionado

Escribir JSON a mano, con sus comillas escapadas, es la parte lenta. Con DevSnip Pro:

  1. Selecciona el código que quieres reutilizar.
  2. Ejecuta DevSnip Pro: Create Snippet.
  3. Escribe el prefijo que usarás, un nombre y una descripción opcional.
  4. Recarga la ventana cuando se te pida. VS Code carga los snippets aportados al iniciarse.

Después, el snippet aparece en IntelliSense en ese lenguaje (hay 39 compatibles). Si otro de tus snippets ya usa ese prefijo, se te pregunta antes, para que no acabes con dos que aparecen a la vez. DevSnip Pro: Saved Snippets lista todo lo que has guardado y elimina lo que ya no usas.

Usa snippets de frameworks listos para usar

Escribe ds- en un archivo compatible, o ejecuta DevSnip Pro: Framework Snippets para elegir de una lista. Hay 56, y cada uno se expandió con VS Code y después se compiló (y se ejecutó, cuando el framework lo permite), así que funcionan tal cual se insertan:

  • Spring Boot: ds-rest-controller, ds-service, ds-entity, ds-repository, ds-controller-advice, ds-webmvctest, ds-junit
  • ASP.NET Core: ds-minimal-api, ds-api-controller, ds-exception-handler, ds-dbcontext, ds-xunit, ds-webapp-test
  • Python: ds-fastapi-app, ds-fastapi-router, ds-pydantic, ds-flask-route, ds-django-view, ds-pytest, ds-pytest-fixture
  • React y Next.js: ds-rfc, ds-hook, ds-context, ds-next-page, ds-next-route, ds-server-action, ds-rtl
  • TypeScript y Node.js: ds-express-router, ds-express-error, ds-zod, ds-fetch-json, ds-vitest
  • Flutter y SwiftUI: ds-stless, ds-stful, ds-future-builder, ds-swiftui-view, ds-view-model

Java, C#, Python y Swift también tienen un snippet ds-logger. Crea el logger que después usa Insert Debug Log para sus líneas de depuración.

Mantén útil tu colección de snippets

  • Nombra los prefijos por lo que crean, no por su procedencia: exroute es mejor que snippet3. Un inicio común (como ds-) los agrupa en IntelliSense.
  • Mantén los snippets pequeños. Un snippet que genera un archivo entero es difícil de adaptar; cuando necesitas un recurso completo, encaja mejor un generador. API Resource Scaffolder de DevSnip Pro crea una API CRUD validada con paginación para Express, NestJS, Next.js, Fastify, Spring Boot, ASP.NET Core o FastAPI.
  • Comparte los snippets del equipo en el repositorio. Un archivo .vscode/project.code-snippets se versiona y se revisa como el código, y todo el que abre el proyecto lo tiene.
  • Haz limpieza. Si llevas meses sin usar un snippet, bórralo para que los que sí usas sean más fáciles de encontrar.

Pruébalo en tu propio editor

Gratis, sin cuenta y en local. Para VS Code 1.93+ e IDE de JetBrains en Windows, macOS o Linux.

code --install-extension sayaib.hue-console