El package.json
Todo proyecto de JavaScript tiene un package.json en su raíz. Se crea con npm init -y y describe el proyecto:
{
"name": "tienda",
"version": "1.0.0",
"type": "module",
"scripts": {
"dev": "vite",
"build": "vite build",
"test": "vitest",
"lint": "eslint ."
},
"dependencies": {
"hono": "^4.7.0"
},
"devDependencies": {
"vite": "^7.0.0",
"vitest": "^3.2.0"
},
"engines": { "node": ">=22" }
}
dependencies: lo que el programa necesita para funcionar.devDependencies: lo que solo se usa para desarrollar (pruebas, empaquetador, linter).scripts: comandos con nombre; se ejecutan connpm run dev,npm test…
Instalar y actualizar
npm install hono # agrega a dependencies
npm install -D vitest # agrega a devDependencies
npm install # instala todo lo que dice el package.json
npm ci # instala EXACTAMENTE lo del lockfile (para integración continua)
npm uninstall hono
npm outdated # qué tiene versiones nuevas
npm update # actualiza dentro de los rangos permitidos
Todo se instala en la carpeta node_modules, que nunca se sube al repositorio (va en el .gitignore).
Versionado semántico
Las versiones tienen tres números: MAYOR.MENOR.PARCHE.
- Parche (1.4.3): corrige errores, sin cambios en la API.
- Menor (1.5.0): agrega funciones, sin romper lo existente.
- Mayor (2.0.0): puede romper cosas.
Los rangos del package.json dicen qué versiones aceptas:
| Rango | Acepta |
|---|---|
"1.4.2" |
Solo esa |
"~1.4.2" |
Parches: 1.4.x desde 1.4.2 |
"^1.4.2" |
Menores y parches: 1.x.y desde 1.4.2 (el de por defecto) |
"*" o "latest" |
Cualquiera (evítalo) |
El lockfile
Con rangos, dos personas que instalan en días distintos pueden recibir versiones distintas. El lockfile (package-lock.json, pnpm-lock.yaml, bun.lock) guarda la versión exacta de cada paquete del árbol entero, dependencias de dependencias incluidas. Súbelo al repositorio: así todos, y el servidor, instalan lo mismo.
npx
npx ejecuta el programa de un paquete sin instalarlo de forma global:
npx eslint . # usa el de node_modules, o lo descarga
npx create-vite@latest mi-proyecto # crea un proyecto nuevo
Otros gestores
- pnpm: guarda cada versión de cada paquete una sola vez en el disco y la enlaza en cada proyecto: instala rápido y ocupa mucho menos. Es más estricto: no deja usar paquetes que no declaraste.
- Yarn: el primer competidor de npm; muchas de sus ideas, como el lockfile, se adoptaron después en npm.
- Bun: su
bun installes el más rápido.
Con Corepack o el campo packageManager del package.json, el proyecto fija qué gestor y qué versión se usa.
Resumen
- El
package.jsondescribe el proyecto: dependencias,devDependencies, scripts y requisitos. - Versionado semántico MAYOR.MENOR.PARCHE;
^acepta menores y parches,~solo parches. - El lockfile fija las versiones exactas de todo el árbol: súbelo al repositorio; en integración continua,
npm ci. npxejecuta paquetes sin instalarlos; pnpm y Bun son alternativas más rápidas.- Cada dependencia es código ajeno con tus permisos: elige con cuidado.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Paquetes y versiones
Resuelto
Elige una respuesta en cada pregunta.
¿Qué permite el rango
"^1.4.2"en unpackage.json?¿Para qué sirve el lockfile (
package-lock.json,pnpm-lock.yaml)?¿Qué va en
devDependencies?¿Qué ventaja principal tiene pnpm sobre npm?
Ordena la salida: Qué versiones cumplen
Resuelto
Un verificador de rangos de versiones simplificado. Ordena lo que aparecería en la consola.
1// Un verificador de rangos simplificado (el real es el paquete "semver")2function cumple(version, rango) {3 const [ma, mi, pa] = version.split(".").map(Number);4 const [rma, rmi, rpa] = rango.slice(1).split(".").map(Number);5 if (rango[0] === "^") return ma === rma && (mi > rmi || (mi === rmi && pa >= rpa));6 if (rango[0] === "~") return ma === rma && mi === rmi && pa >= rpa;7 return version === rango;8}9 10console.log(cumple("1.9.0", "^1.4.2"));11console.log(cumple("2.0.0", "^1.4.2"));12console.log(cumple("1.4.9", "~1.4.2"), cumple("1.5.0", "~1.4.2"));13console.log(["1.4.2", "1.10.0", "1.9.3"].filter((v) => cumple(v, "^1.4.2")).length);Consola, de arriba abajo
- true false
- true
- 3
- false
Con ^, todo lo de la misma versión mayor sirve. Con ~, solo los parches de la misma menor. Y las versiones se comparan como números: 1.10.0 es mayor que 1.9.3. (El paquete real trata aparte las versiones 0.x, donde ^ es más estricto.)
Detective: Un árbol de dependencias imposible
Resuelto
Después de actualizar React, npm install se niega a instalar. Encuentra la línea del package.json que causa el conflicto y elige qué hacer.
Consola
npm error code ERESOLVE npm error ERESOLVE unable to resolve dependency tree npm error npm error While resolving: tienda@1.0.0 npm error Found: react@19.1.0 npm error node_modules/react npm error react@"^19.1.0" from the root project npm error npm error Could not resolve dependency: npm error peer react@"^18.0.0" from mi-calendario@2.3.1 npm error node_modules/mi-calendario npm error mi-calendario@"^2.3.1" from the root project
Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?