Avez-vous déjà rencontré cette situation ? Pour économiser de l’espace sur l’ordinateur, vous configurez le store de pnpm sur un disque externe, mais un jour vous n’avez pas apporté le disque, ou vous voulez changer l’emplacement de stockage, et pnpm commence à lancer des erreurs disant qu’il ne peut pas trouver le répertoire ? Même rebrancher le disque semble étrange ?
Ceci est en fait lié au principe de fonctionnement unique de pnpm. Aujourd’hui, parlons du mécanisme “Store” de pnpm et de la façon de le sauver lorsqu’il “perd la connexion” !
Comment pnpm économise-t-il exactement de l’espace ?
Avant de commencer à réparer, passons rapidement en revue la magie de l’économie d’espace de pnpm.
Contrairement à npm qui copie un ensemble complet de paquets dans le node_modules de chaque projet, pnpm utilise Content-addressable store (Magasin adressable par contenu) et Hard Links (Liens physiques).
La façon dont pnpm fonctionne est que tous les fichiers de paquets n’existent en fait que dans un “grand entrepôt” sur votre ordinateur, et votre répertoire de projet ne fait que créer un lien vers cet entrepôt. Cela permet non seulement d’économiser de l’espace disque, mais rend également l’installation étonnamment rapide.
| Élément | pnpm | npm |
|---|---|---|
| Méthode de Stockage | Global Store + Hard Links | Copie indépendante par projet |
| Utilisation de l’Espace | Très faible (ne stocke qu’une seule copie par version) | Élevé (copies dupliquées) |
| Vitesse d’Installation | Rapide (crée juste des liens) | Lent (a besoin d’extraire et d’écrire) |
Pourquoi le disque externe cause-t-il des erreurs pnpm ?
Lorsque vous configurez le pnpm store sur un disque externe pour économiser de l’espace SSD local, des pièges potentiels apparaissent :
| Situation | Description |
|---|---|
| Chemin Invalide | Lorsque le disque n’est pas branché, pnpm ne peut pas trouver le store-dir configuré à l’origine, et l’installation signalera directement une erreur et quittera. |
| Crash de Hard Link | Parce que les Hard Links ne peuvent pas traverser les partitions, si votre projet est sur le Disque A et le store est sur le Disque B, pnpm est forcé d’utiliser la copie, ce qui perd l’avantage original et peut même causer des erreurs d’exécution en raison de chemins de cache désordonnés. |
Face à cette situation, nous devons “calibrer” manuellement.
Solution 1 : Calibrer, Reconfigurer le Chemin du Store
Si vous décidez de changer l’emplacement du store, le moyen le plus direct est de dire à pnpm où se trouve le nouveau store. Vous pouvez utiliser la commande suivante :
pnpm config set store-dir <votre_nouveau_chemin_de_répertoire>
Par exemple, configurer le pnpm store sur ~/.pnpm-store sous le répertoire home de l’utilisateur :
pnpm config set store-dir ~/.pnpm-store
Si vous n’êtes pas sûr de l’endroit où le store actuel est configuré, vous pouvez d’abord le demander :
pnpm store path
Une fois le paramétrage terminé, pnpm saura où récupérer les paquets à partir de maintenant.
Solution 2 : Recommencer, Reconstruire les Liens
Parfois, après avoir changé le chemin, le projet a encore quelques vieilles erreurs résiduelles. À ce moment-là, “recommencer” est généralement le remède le plus efficace :
| Étape | Description |
|---|---|
| 1 | Supprimez le dossier node_modules dans le projet. |
| 2 | Supprimez pnpm-lock.yaml (si c’est une erreur étrange causée par des chemins, il est recommandé de régénérer également le fichier de verrouillage). |
| 3 | Exécutez pnpm install pour reconstruire les liens. |
Cela force pnpm à tirer les liens corrects du store vers votre projet en fonction de votre dernière configuration.
Comment allouer pour que ce soit le plus fluide ?
Si vous basculez souvent entre différents environnements, ou si vous vous inquiétez de l’instabilité du disque externe, la configuration idéale est : Gardez le pnpm store sur le SSD local, et le code du projet peut être sur le disque externe.
Pourquoi ? Parce que le store ne change généralement pas trop souvent, et bien qu’il ait du volume, la somme totale répartie entre les projets est en fait beaucoup plus petite que npm. Garder l’entrepôt sur un chemin local stable (par exemple, la valeur par défaut de macOS ~/Library/pnpm/store) vous permet d’initialiser de nouveaux projets ailleurs en douceur même sans le disque externe.
Ce concept de développement Stateless (Sans état) rend votre environnement de développement plus flexible !
Conclusion : Garder le Store Stable Économise des Ennuis
La clé de la gestion du pnpm store réside dans le mot “stabilité”. Si vous rencontrez des problèmes de chemin, vous pouvez faire ceci :
| Étape | Description |
|---|---|
| 1 | Vérifiez et changez d’abord le paramètre store-dir. |
| 2 | Nettoyez les vieux paquets : pnpm store prune (cela vous aide à effacer les fichiers de paquets que personne n’utilise, amincissant le disque dur) |
| 3 | Réinstallez les paquets pnpm install |
J’espère que cet article aidera tout le monde à sortir du fossé du chemin pnpm et à profiter du plaisir du développement à grande vitesse !