VSCode本身不参与版本解析，仅提供终端和编辑器环境；npm install需显式指定版本号（如express@4.18.2）或语义化符号（^/~）来精准控制依赖版本，省略则默认安装latest，易引发意外升级。
直接在 VSCode 集成终端里执行 npm install 或 yarn add，但版本控制必须靠显式指定——VSCode 本身不参与版本解析，它只提供终端和编辑器环境。
npm install 时怎么指定精确版本号
不写版本号默认装最新版，但多数生产场景需要锁定；省略符号（如 npm install lodash）实际等价于 npm install lodash@latest，容易引发意外升级。
- 装具体版本：
npm install express@4.18.2 - 装兼容当前主版本的最新版（^）：
npm install axios@^1.6.0→ 允许装 1.x.x 中 ≥1.6.0 的版本 - 装兼容当前次版本的最新版（~）：
npm install moment@~2.29.4→ 只允许装 2.29.x - 从
package.json安装所有依赖（含已锁版本）：npm install，前提是该文件里dependencies或devDependencies字段已写好带版本号的条目
为什么装了包，VSCode 里 import 还标红
不是没装上，而是 TypeScript 类型定义或 JS 路径解析没对齐。常见原因有三个：
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
-
node_modules确实存在，但项目根目录下没有jsconfig.json（JS 项目）或tsconfig.json（TS 项目），导致 VSCode 不知道从哪开始解析模块路径 - 用了 ESM（
"type": "module"在package.json中），却用require()加载 CommonJS 包，TypeScript 会报类型冲突；此时应统一用import，或删掉"type": "module" - 安装的是纯 JS 包但没配
@types/xxx，比如npm install lodash后还缺npm install -D @types/lodash，否则 TS 编辑器无法提示方法签名
用 nvm 切换 Node 版本后，npm install 失败怎么办
根本问题不是命令错，而是 VSCode 集成终端没继承新 shell 环境——尤其 macOS/Linux 下，nvm 初始化通常只在 login shell（如 iTerm 启动时）生效，而 VSCode 默认启动的是 non-login shell。
- 先在系统终端确认：
nvm current和which node输出是否一致；再在 VSCode 集成终端里跑一遍，看结果是否相同 - 如果不一致，在 VSCode 设置里搜
terminal.integrated.env.，添加环境变量："terminal.integrated.env.osx": { "PATH": "/Users/yourname/.nvm/versions/node/v18.17.0/bin:${env:PATH}" }（路径按which node实际输出填） - 或者更简单：关掉所有 VSCode 窗口，从系统终端用
code .启动，这样终端能完整继承 shell 环境
真正卡住人的地方，从来不是“怎么敲命令”，而是 npm install 成功后，VSCode 没刷新模块索引、没重读 tsconfig.json、或者根本没意识到自己正在用旧版 Node 启动终端——这些状态不会自动同步，得手动触发。
