Mac系统如何运行npm install？Windows转Mac Node.js开发环境配置求助

npm 相关命令在 Mac 和 Windows 下没有语法差异，执行不生效基本都是环境配置、权限、依赖兼容性问题，按以下步骤排查即可：

基础环境校验 #

• 首先执行 node -v、npm -v 确认命令全局生效，如果提示找不到命令，需要把 node 执行路径添加到系统环境变量中
• Mac 下默认 npm 全局目录会有权限限制，不要用 sudo 执行 npm 安装命令，先执行以下命令修复权限：

  sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
  

• 确认当前终端工作路径已经切换到项目根目录，也就是包含 package.json 文件的文件夹，路径错误会直接导致 npm 命令无法识别项目配置

npm install 失效排查 #

• 先清理旧的异常依赖文件：执行 rm -rf node_modules package-lock.json yarn.lock 删除本地依赖文件夹和锁文件，避免旧文件冲突
• 如果项目对 node 版本有要求，建议用 nvm 管理多版本 node，安装 nvm 后在项目根目录执行 nvm use 即可自动匹配项目需要的 node 版本，规避版本不兼容问题
• 网络问题导致依赖下载失败的，可以切换 npm 国内镜像：执行 npm config set registry https://registry.npmmirror.com 后再重新执行安装

npm start 失效排查 #

• 先检查项目 package.json 中 scripts 字段是否配置了正确的 start 启动命令，确认无拼写错误
• MEAN 栈项目启动前需要先启动 MongoDB 服务，Mac 下可以执行 brew services start mongodb-community 后台启动 MongoDB，数据库未启动会直接导致项目启动失败
• 检查项目配置的端口是否被占用，执行 lsof -i:项目端口号 可以查看占用进程，终止对应进程后再重启项目即可

环境迁移通用注意事项 #

• Windows 上安装的全局工具类依赖（比如 @angular/cli 等）需要在 Mac 环境下重新全局安装，不能直接拷贝依赖文件
• 项目本地路径不要包含中文、空格或特殊字符，避免路径解析异常
• Mac 下环境变量默认保存在 ~/.zshrc 或 ~/.bash_profile 中，修改配置后需要执行 source 对应配置文件路径 让配置即时生效

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