VSCode与Node.js协同开发的关键卡点是环境变量、全局模块路径、调试配置三处；需确保安装时勾选“Add to PATH”、手动配置npm prefix及cache路径、正确设置launch.json中program字段并避免nvm版本错位。
VSCode 与 Node.js 能直接协同开发，但默认安装后不等于“开箱即用”——关键卡点在环境变量、全局模块路径、调试配置三处，缺一不可。
node -v 和 npm -v 报错：不是内部命令
这是最常见也最容易误判的问题。表面看是命令找不到，实际是 Windows 的 Path 环境变量没生效，或安装时漏勾了“Add to PATH”。
- 不要只靠双击安装包完成安装，务必在 Node.js 安装向导里勾选
Add Node.js to PATH（哪怕你改了安装路径） - 如果已安装但报错，手动把 Node.js 安装目录（比如
C:\Program Files\nodejs\）加进系统Path变量，不是用户变量 - 改完环境变量后，必须关闭所有已打开的终端（CMD/PowerShell/VSCode 终端），再新开一个窗口验证
- VSCode 内置终端继承的是启动时的环境变量，所以改完后要重启 VSCode，不能只关终端再重开
npm install -g express 失败或全局模块找不到
全局安装失败，90% 是因为 npm 默认前缀（prefix）仍指向 C 盘，而当前用户无写入权限，或者缓存路径被污染。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 先查当前设置：
npm config get prefix和npm config get cache，确认是否指向你可控的路径（如D:\nodejs\node_global） - 修改前缀和缓存路径必须用管理员权限运行 CMD 或 PowerShell，否则写入失败但无提示
- 改完后执行
npm config set registry https://registry.npmmirror.com换成国内镜像，避免超时 - 全局模块（如
express-generator）安装后，其可执行文件（如express）在prefix下的node_modules\.bin目录，这个路径也必须加入Path，否则终端里无法直接调用
VSCode 调试时提示 “Cannot find runtime 'node'” 或断点不生效
这不是插件没装，而是 launch.json 配置没对准当前项目结构，或 node 运行时被多个版本干扰。
- 调试前确保项目根目录下有
package.json，且main字段指向正确的入口文件（如"main": "index.js"） - VSCode 自动创建的
launch.json中runtimeExecutable不要硬编码路径，留空即可，它会自动找node命令 - 如果你用 nvm 管理多版本 Node，调试前必须在 VSCode 终端里先运行
nvm use 18.17.0，再按 F5 启动调试——VSCode 不会自动读取 nvm 的当前版本 - 断点不触发？检查右下角状态栏是否显示 “Node.js” 调试器，而不是 “JavaScript Debug”；后者用于浏览器端，对纯 Node 无效
ESLint + Prettier 自动修复保存后代码格式错乱
这不是插件冲突，而是规则优先级没理清：Prettier 负责格式，ESLint 负责逻辑和风格，二者必须明确分工。
- 禁用 ESLint 的格式类规则，只保留校验类规则（如
no-console,no-unused-vars），否则和 Prettier 冲突 - 在 VSCode 设置中启用
editor.formatOnSave，但不要同时开启editor.codeActionsOnSave里的source.organizeImports，它会重排 import，破坏 Prettier 排序 - 项目根目录必须有
.prettierrc和.eslintrc.cjs，且.eslintrc.cjs中需包含extends: ['prettier']，否则 Prettier 规则不生效 - 如果用了 TypeScript，
eslint-plugin-import的路径解析依赖tsconfig.json，缺失会导致 import 提示错误，但实际能运行
真正难的不是装多少插件，而是每个环节的路径、权限、上下文都得对齐——比如 VSCode 终端的环境变量、nvm 的当前版本、launch.json 的工作目录、npm 的 prefix，四者稍有偏差，就会出现“明明装了却用不了”的情况。
