<p>宝塔终端执行npm install报command not found，因root用户未加载www用户的nvm环境；须su - www切换用户并source ~/.bashrc，再cd项目目录执行npm install。</p>
直接在宝塔终端里执行 npm install 大概率失败，不是命令错了，而是环境根本没加载——npm 命令压根不在当前 shell 的 PATH 里。
为什么宝塔终端里 npm install 报 command not found
宝塔默认终端以 root 用户启动，而 Node.js（尤其是用 nvm 装的）只对特定用户生效。哪怕你之前在 www 用户下装过 nvm 和 npm，root 终端里也完全看不到它们。
- 现象：输入
which npm返回空，node -v也报错 - 本质：nvm 安装路径（如
~/.nvm/versions/node/v18.19.1/bin）只写进了www用户的.bashrc，root不读这个文件 - 别试
sudo npm install——它会试图用系统级 node（可能不存在或版本错），还可能把依赖装进/root/node_modules，项目根本用不上
进对用户、加载环境，再跑 npm install
必须切到项目实际运行的用户（通常是 www），并手动加载 nvm 环境：
- 先切用户：
su - www（注意短横，否则不加载.bashrc） - 再加载环境：
source ~/.bashrc（CentOS/Ubuntu 默认 shell 是 bash；如果是 zsh，改用source ~/.zshrc） - 验证是否就位：
node -v和npm -v都得有输出，且which npm指向~/.nvm/versions/node/...路径 - 最后进项目目录：
cd /www/wwwroot/myapp，再执行npm install
npm install 卡住或报 ECONNREFUSED 怎么办
这不是网络问题，是 npm 默认源被墙或不稳定，尤其在国内服务器上几乎必现。
- 别等它自己重试，先
Ctrl+C中断 - 立刻换国内镜像：
npm config set registry https://registry.npmmirror.com - 如果项目用了
package-lock.json且锁了旧源，加--no-package-lock强制重生成：npm install --no-package-lock - 某些老项目依赖 Python 2 或
node-gyp编译，宝塔 CentOS 镜像常缺gcc-c++和python3-devel，得先yum install -y gcc-c++ python3-devel（Ubuntu 用apt install -y build-essential python3-dev）
装完依赖后 PM2 启动还是报 Cannot find module
说明 npm install 是在对的环境下跑的，但 PM2 启动时又回到了另一个环境——比如用宝塔「PM2管理器」插件点「一键部署」，它底层调的是系统级 npm，而不是你刚配好的那个。
- 绕过插件，用绝对路径启动：
/www/server/nvm/versions/node/v18.19.1/bin/npm start - 或者让 PM2 显式继承环境：
pm2 start app.js --env "NODE_ENV=production"（前提是pm2本身也是 nvm 下装的） - 最稳的方式：进项目目录后，先
nvm use 18.19.1，再pm2 start ecosystem.config.js，确保整条链路都在同一 nvm 上下文
真正麻烦的从来不是 npm install 这行命令本身，而是谁在哪个 shell 里、用哪套 PATH 和 NODE_OPTIONS 执行它——漏掉 su - www 或 source，后面所有操作都像在黑盒里拧螺丝。
