先说几个核心判断：在 VSCode 调试 Node.js 时，你遇到的“环境变量不生效”“模块加载失败”甚至“编辑器卡得动不了”等问题，其实都不是疑难杂症，而是几个常见陷阱踩了一遍。下面我们逐个拆解，并给低配环境（比如 2GB 内存的虚拟机）提供一套经过验证的轻量化方案。
根本原因是 VSCode 未继承 shell 环境变量：macOS/Linux 通过 GUI 启动时不加载 ~/.zshrc，Windows 安装 Node.js 时未勾选“Add to PATH”；需要分别通过终端执行 code . 或手动配置系统 PATH，并彻底重启 VSCode 来验证。
终端中 node -v 正常，VSCode 内置终端却报 command not found
这个场景十分常见——在终端里 node -v 输出正常，但切换到 VSCode 内置终端就报错。本质上与插件无关：VSCode 从 Dock、Spotlight 或任务栏启动时，不会自动加载 ~/.zshrc 或 ~/.bashrc 中的环境变量；Windows 系统则是因为安装 Node.js 时没有勾选“Add to PATH”，导致系统级路径缺失。
验证方法很简单，且只有一种可靠方式：在 VSCode 内置终端（Ctrl + `）中分别执行 node -v 和 npm -v，只有得到准确输出才算环境配置到位。
解决方案因平台而异：
- macOS / Linux：先用
which node确认路径（常见如/opt/homebrew/bin/node），确保它已写入~/.zshrc。然后执行source ~/.zshrc让配置立即生效，再完全退出 VSCode，最后从终端执行code .启动编辑器——这一步是核心，因为 GUI 启动不会读取 shell 配置。 - Windows：进入“系统属性 → 高级 → 环境变量”，将
C:\Program Files\nodejs\添加到“系统变量”的PATH中，之后重启 VSCode 即可。
launch.json 的 program 字段总是指向错误路径
调试时发现断点全部变灰，并提示 Cannot launch program，十有八九是 program 字段未指向一个真实存在的可执行 .js 文件。注意：它需要的是具体文件路径，而不是源码目录或相对路径的字面量。
正确与错误写法对比：
- ✅
"program": "${workspaceFolder}/src/index.js"—— 跨平台安全，推荐使用此方式 - ❌
"program": "src/index.js"—— 缺少${workspaceFolder}/，VSCode 不会自动补前缀 - ❌
"program": "./src/index.js"—— 这里的.不会被解析为工作区根目录，等同于字符串字面量
特别提醒 TypeScript 项目：不要试图指向 src/index.ts。有两种稳妥做法：一是配置 preLaunchTask 先编译到 dist/，然后指向 dist/index.js；二是使用 runtimeExecutable: "npx" 配合 runtimeArgs: ["ts-node", "src/index.ts"]，直接运行源代码。
ESM 项目调试时报 Cannot use import statement outside a module
这个问题看似语法错误，实则是模块类型未对齐。Node 默认按 CommonJS 解析，遇到 import 就会报错，不报错才奇怪。
解决方案：
- 项目根目录的
package.json中必须明确声明"type": "module" - 如果使用了
code-runner插件，需在其executorMap中将javascript对应的值改为"node --experimental-specifier-resolution=node $fileName" - VSCode 调试器（
pwa-node）同样依赖这个"type"值。未声明时强行使用import，虽然断点可能偶尔命中，但require()必定失败，process.cwd()的行为也可能出现偏差
低配虚拟机（2GB RAM / 单核 CPU）下 VSCode 卡顿的根源与裁剪策略
如果你的虚拟机只有 2GB 内存、单核 CPU，VSCode 还卡得无法忍受，八成以上的问题出在插件上。像 Omnisharp、Pylance、ESLint 这类插件，默认开启完整语言服务，每个独立进程启动就会占用 300 到 600MB 内存；GitLens 和 Bracket Pair Colorizer 则更隐蔽——它们不报错也不崩溃，却在后台持续监听文件变更和语法树，CPU 占用常年超过 20%。
以下是一套经过验证的裁剪方案：
- 将语言服务降到最低：Python 项目可卸载 Pylance，只保留官方 Python 扩展，并将
python.languageServer设为"none"，基础语法高亮和代码片段依然可用，但沉重的补全和诊断功能会停止。 - 精简 Git 功能：卸载 GitLens，使用内置的 Git 面板（
Ctrl+Shift+G）替代；同时关闭git.experimental.enabled，减少后台轮询。 - 终端替代方案：删除 Terminal Tabs 这类插件，使用原生的 Integrated Terminal，配合
shellLauncher定制启动命令——不额外启动进程，仅修改配置。 - 轻量替代插件推荐：
Project Manager使用 JSON 管理多项目，不索引文件；vscode-icons启用vsicons.dontShowFiles跳过文件扫描；prettier要关闭prettier.requireConfig，并确保prettier.enable设为true。 - 如果裁剪后仍然卡顿：检查两个隐藏开关。一是
files.watcherExclude，在其中添加"**/node_modules/**"，防止 inotify 撑爆 WSL2；二是"disable-hardware-acceleration": true，低配虚拟机的显卡驱动通常不完整，强制 GPU 渲染反而会拖慢速度。
裁剪的核心思路不是“越少越好”，而是让每个插件只做一件事、做完就停止。必须警惕的是：禁用插件后如果不重启编辑器，内存可能不会完全释放——热重载仅清理了 UI 层，后台进程仍在运行。请务必执行重启这一步，不要省略。
