为什么执行npm install缺包、需要sudo权限才能正常安装所有依赖？

出现该问题的核心原因是文件/目录权限不匹配，本质是当前登录用户没有对npm依赖写入目录的修改权限，常见触发场景如下：

• 此前曾经使用sudo执行过项目内的npm install，导致当前项目下node_modules目录、package-lock.json文件的所有者为root用户，普通用户无写入权限，无权限的依赖会静默安装失败，不会抛出明显报错
• npm全局缓存目录~/.npm的所有者为root，普通用户执行安装时无法写入缓存，导致依赖拉取不完整
• 项目所在的上级目录设置了不合理的权限规则，限制了当前用户的写入权限

按顺序执行以下命令即可修复：

1. 修复npm全局缓存目录的所有者权限

sudo chown -R $(whoami) ~/.npm

2. 删除当前项目内遗留的权限异常文件和目录

sudo rm -rf node_modules package-lock.json

3. 修复当前项目所有文件的所有者为当前登录用户

sudo chown -R $(whoami) .

4. 重新执行普通用户身份的安装命令即可正常完成

npm install

• 不要随意使用sudo执行本地项目的npm install，会持续污染目录权限
• 如果存在全局npm包安装需要sudo的问题，可以修改npm全局安装路径到当前用户目录，避免权限问题：
  • 执行npm config set prefix ~/.npm-global设置全局安装目录
  • 将export PATH=$PATH:~/.npm-global/bin添加到当前用户的shell配置文件（~/.bashrc、~/.zshrc等）中生效，后续全局安装包无需加sudo

内容的提问来源于stack exchange，提问作者Tomas Jansson