VSCode终端找不到npm的根本原因是未继承系统PATH环境变量；需确认node -v和npm -v在系统终端正常，再将C:\Program Files\nodejs\和%AppData%\npm加入PATH，PowerShell执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，并完全退出重启VSCode。
VSCode终端找不到npm？先确认Node是否真可用
不是装完Node.js就能在VSCode里用npm——很多报错根本原因是node -v和npm -v在系统终端能跑，但在VSCode终端里直接command not found。这说明VSCode没继承你shell的环境变量。
验证方式很简单：关掉所有VSCode窗口，重新以普通用户身份打开项目文件夹，再在内置终端里执行：
node -v<br>npm -v
如果任一命令失败，别急着改launch.json或装插件，先回头检查安装环节：
- Windows用户重装Node.js时必须勾选 Add to PATH，否则手动把
C:\Program Files\nodejs（或自定义路径）加进系统Path变量 - macOS/Linux用
brew install node后，确认which node输出路径已写入~/.zshrc或~/.bash_profile，且执行过source ~/.zshrc - VSCode终端可能缓存旧环境——重启VSCode比刷新终端更可靠
npm config get prefix返回的路径，就是全局模块实际存放位置
很多人以为npm install -g nodemon装完就万事大吉，结果在VSCode里敲nodemon还是报command not found。问题往往出在prefix路径没被加入系统PATH，或者VSCode根本没读到它。
执行以下命令看当前配置：
npm config get prefix<br>npm config get cache
典型输出类似：
C:\Users\Alice\AppData\Roaming\npm<br>C:\Users\Alice\AppData\Roaming\npm-cache
这个prefix路径必须出现在你的系统PATH环境变量里，否则全局命令无法被识别。Windows需手动添加该路径到系统变量Path；macOS/Linux则要确保该路径已写入shell配置并生效。
额外注意：NODE_PATH变量不是必须项，但如果你用require()加载全局模块（比如require('nodemon')），就得设为prefix下的node_modules目录，例如C:\Users\Alice\AppData\Roaming\npm\node_modules。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
VSCode调试时program字段别写死，否则换文件就F5失败
VSCode自动生成的launch.json默认是"program": "${workspaceFolder}/app.js"。一旦你调试的是server.js或index.js，F5直接报错Cannot find module。
最省事的改法是：
- 把
program改成"${file}"——这样调试哪个打开的JS文件，就运行哪个 - 确保文件已保存（VSCode默认不自动保存），按
Ctrl+S或Cmd+S再F5 - 如果项目有固定入口（如
bin/www），可设为"${workspaceFolder}/bin/www"，但别用相对路径如./bin/www，VSCode解析不稳定
顺带一提：launch.json里的env字段可以临时覆盖环境变量，比如"NODE_ENV": "development"，但别指望它能绕过PATH缺失的问题。
国内网络下npm install卡住？镜像和全局路径得提前配
官方registry在国内基本不可用，npm install卡在fetchMetadata是常态。淘宝镜像已迁移到https://registry.npmmirror.com（截至2026年6月仍有效）。
执行这两条命令即可切换：
npm config set registry https://registry.npmmirror.com<br>npm config set prefix "D:\npm-global"
然后把D:\npm-global加进系统PATH，再重装关键工具：
npm install -g nodemon npm-check-updates
容易踩的坑：
- 改完
prefix后不重启VSCode，终端仍读旧路径 - PowerShell里执行
cnpm报xxx.ps1 cannot be loaded，是因为执行策略限制，需在管理员PowerShell中运行set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 用
cnpm装包后，VSCode终端里仍要用npm命令——cnpm只是代理，不影响npm本身的环境变量逻辑
真正麻烦的从来不是配错哪一行，而是改了PATH却忘了让VSCode重新加载shell环境——它不会自动感知你刚在系统里点确定的那一下。
