NPM
NPM signifie :
Node Package Manager
NPM permet d’installer et gérer des packages JavaScript.
Un package est une librairie ou un outil réutilisable.
NPM est inclus automatiquement avec Node.js.
1. Pourquoi utiliser NPM
Les projets modernes utilisent énormément de packages.
Exemples :
- React
- Vitest
- Vite
- Express
- Tailwind CSS
NPM permet d’installer ces outils facilement.
2. Vérifier l’installation
Pour vérifier que Node.js et NPM sont installés :
node -v
npm -v
Ces commandes affichent la version installée.
3. Initialiser un projet
Pour créer un projet NPM :
npm init
NPM pose plusieurs questions puis crée un fichier :
package.json
4. npm init -y
Pour utiliser les valeurs par défaut automatiquement :
npm init -y
Cette commande crée rapidement le fichier package.json.
5. package.json
Le fichier package.json contient les informations du projet.
{
"name": "my-project",
"version": "1.0.0",
"scripts": {
}
}
Ce fichier est extrêmement important dans les projets modernes.
6. Installer un package
Pour installer une librairie :
npm install vite
Ou version courte :
npm i vite
7. node_modules
Après une installation, NPM crée un dossier :
node_modules
Ce dossier contient tous les packages installés.
Il peut devenir très gros.
8. package-lock.json
NPM crée aussi :
package-lock.json
Ce fichier verrouille les versions exactes des dépendances.
Cela aide à reproduire le même environnement sur d’autres machines.
9. Dépendances normales
Une dépendance normale est utilisée directement dans l’application.
npm install express
Le package apparaît dans :
"dependencies"
10. Dépendances de développement
Certains outils servent uniquement au développement.
npm install -D vitest
Ou :
npm install --save-dev vitest
Le package apparaît dans :
"devDependencies"
11. Scripts NPM
package.json peut contenir des scripts.
{
"scripts": {
"dev": "vite",
"test": "vitest"
}
}
Ensuite :
npm run dev
npm run test
12. Installer toutes les dépendances
Après avoir cloné un projet, on installe les dépendances avec :
npm install
NPM lit package.json puis installe tout automatiquement.
13. Désinstaller un package
npm uninstall vite
Le package est supprimé du projet.
14. Mettre à jour un package
npm update
Cette commande met à jour les dépendances.
15. npm run
npm run permet d’exécuter un script défini dans package.json.
npm run dev
Ici, NPM lance le script :
"dev": "vite"
16. Exemple concret
project/
│
├── node_modules/
├── package.json
├── package-lock.json
└── src/
Cette structure est très commune dans les projets JavaScript modernes.
17. NPM et les projets modernes
NPM est utilisé dans presque tous les projets JavaScript modernes :
- React
- Vue
- Vite
- Node.js
- Vitest
- Tailwind
18. Erreur fréquente
Plusieurs débutants suppriment manuellement :
node_modules
Mais ce dossier peut être recréé facilement avec :
npm install
19. Bonnes pratiques
- Utiliser npm init -y pour démarrer rapidement
- Installer les outils de développement avec -D
- Ne pas modifier node_modules manuellement
- Utiliser des scripts NPM
- Garder package.json propre et organisé
Résumé rapide
| Commande | Utilité |
|---|---|
| npm init | Créer un projet NPM |
| npm init -y | Créer rapidement package.json |
| npm install | Installer des packages |
| npm install -D | Installer une dépendance dev |
| npm uninstall | Supprimer un package |
| npm run | Exécuter un script |
| package.json | Configuration du projet |
| node_modules | Contient les packages |
| package-lock.json | Verrouiller les versions |