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.

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

npm install react@16.14.0

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

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.

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, use el flag --save-exact adicionalmente. Este flag obligará a NPM a almacenar la versión exacta del módulo en package.json.

Ejemplos:

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

npm install react --save --save-exact

2. Instala la última versión y guarda la versión exacta en las dependencias de desarrollo del package.json

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

3. Instala la última versión y guarda 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.