npm y package.json: dependencias y scripts

npm (Node Package Manager) gestiona las dependencias y los scripts del proyecto. Lee package.json para saber qué debe instalar y escribe package-lock.json para registrar las versiones exactas. En el registro de npm se han publicado más de dos millones de paquetes.

npm init -y crea un package.json con valores predeterminados. La opción -y acepta todos los valores predeterminados sin mostrar preguntas.

Campos principales: name, version, description, main (punto de entrada), scripts, dependencies, devDependencies.

npm install package añade el paquete a dependencies. npm install -D package lo añade a devDependencies (no es necesario en producción). npm install sin argumentos instala todo lo indicado en package.json.

npm usa semver: major.minor.patch. El prefijo ^ permite actualizaciones compatibles (con la misma versión major). El prefijo ~ permite únicamente actualizaciones de patch. Las versiones exactas no llevan prefijo.

Defina comandos en el campo scripts. Ejecútelos con npm run scriptname. Los scripts integrados (test, start) se ejecutan directamente con npm test o npm start.

npm run ejecuta un script de package.json. npx ejecuta un paquete de node_modules o lo descarga y ejecuta temporalmente; resulta útil para comandos puntuales como npx create-vite@latest.

package-lock.json registra la versión exacta de cada paquete instalado (y de sus dependencias transitivas). Confírmelo en el control de versiones para garantizar que todos los desarrolladores y la integración continua usen versiones idénticas. Nunca lo edite manualmente.

Nunca confirme node_modules: puede ocupar cientos de MB. Añádalo siempre a .gitignore. Cualquiera puede restaurarlo con npm install.

npm update actualiza los paquetes dentro de su rango de semver. npm outdated muestra qué paquetes se pueden actualizar. npm uninstall package elimina un paquete.

Alternativas a npm: yarn (más rápido, espacios de trabajo, Plug'n'Play) y pnpm (almacén de enlaces simbólicos eficiente en disco, dependencias estrictas y mayor velocidad en monorepos). Los comandos principales son similares en los tres.

¿Qué hace la opción -D al ejecutar npm install -D jest?

npm init crea package.json. -D añade el paquete a devDependencies. ^ en semver indica actualizaciones compatibles. Los scripts ejecutan comandos con npm run. package-lock.json registra las versiones exactas; inclúyalo en el control de versiones. node_modules debe incluirse en .gitignore. npx ejecuta comandos de paquetes puntuales.