NPM: ¿cómo instalar una versión específica de un módulo?

NPM (Node Package Module) es el gestor de paquetes de Node JS más utilizado para instalar librerías en proyectos de JavaScript. En muchas ocasiones necesitamos instalar una versión específica de una librería o módulo, hay varias opciones para hacer esto. Pero primero empecemos con el comando básico del CLI de NPM:

npm install react

Este comando instala en el directorio donde nos encontremos la última versión disponible de React.

Instalar una versión específica

Si conoces la versión exacta del paquete que necesitas, puedes agregarla al nombre del paquete después del carácter @:

npm install [email protected]

Puedes buscar la última versión de cualquier paquete de NPM en npmjs.com.

Usar rangos semánticos

Si no conoces la versión exacta del paquete, NPM permite usar rangos semánticos para definir la versión. Por ejemplo:

npm install react@^16.0.0

Este comando instalará la última versión 16.x.x. Puedes encontrar más información sobre la sintaxis del control de versiones semántico en docs.npmjs.com.

Flags útiles

Por defecto, los comandos anteriores agregan los módulos instalados a la lista de dependencias en el archivo package.json. Esto pasa en las últimas versiones de NPM. Si no se están agregando los módulos a la lista de dependencias, puedes usar el flag --save o -S.

También puedes usar el flag --save-dev, abreviado -D, para agregar un módulo a la lista de dependencias de desarrollo.

Si instalas un módulo sin definir una versión específica (es decir, sin ninguna versión o usando un rango semántico), NPM agregará el rango semántico al package.json tal cual. Para evitar esto, usa el flag --save-exact adicionalmente. Este flag obligará a NPM a almacenar la versión exacta del módulo en package.json.

Ejemplos

1. Instalar la última versión y guardar la versión exacta en las dependencias del package.json:

npm install react --save --save-exact

2. Instalar la última versión y guardar la versión exacta en las dependencias de desarrollo del package.json:

npm install react --save-dev --save-exact

3. Instalar la última versión y guardar el rango semántico en las dependencias en package.json. Por ejemplo: “react”:“^16.14.0”:

npm install react

--save, --save-exact, --save-dev obviamente no funcionan junto con el flag -g que instala el módulo a nivel global.