vscode中npm或node“找不到”是因powershell执行策略或环境变量污染导致符号冲突，如npm被系统目录下.ps1脚本覆盖；原生模块报错源于abi不匹配，需用npm rebuild --napi-build-version=9 --runtime=electron重编；终端node版本滞后是因vs code启动时固化shell环境快照，须重启或重载环境；require加载.mjs报错是commonjs与esm不兼容，应改用await import或createrequire。
为什么VSCode里npm或node命令突然“找不到”
这不是Node没装好，而是PowerShell执行策略或环境变量污染导致的符号冲突。比如npm被同名bat脚本、别名或旧版本覆盖，或者Get-Command npm返回路径指向C:\Windows\System32\npm.ps1而非node_modules\.bin\npm.cmd。
- 先在VSCode终端运行
Get-Command npm（PowerShell）或which npm（bash/zsh），确认实际调用的是哪个可执行文件 - 若返回的是系统目录下的
.ps1或.bat，说明PATH中存在干扰项——常见于旧版npm installer、某些IDE捆绑包或手动复制的脚本 - 检查
$env:PATH（PowerShell）或$PATH（shell），重点排查是否含C:\Windows\System32或C:\Program Files\nodejs\之前插入了非官方路径 - 临时绕过：直接用完整路径执行，如
"C:\Program Files\nodejs\npm.cmd" install
插件报“Cannot find module './build/Release/xxx.node’”怎么破
这是ABI符号不匹配的典型症状，不是路径错，也不是Node版本“不够新”，而是process.versions.napi与原生模块编译时声明的napi_build_version对不上。VS Code内置Electron用的Node是v22.4.0（napi=9），而你系统Node是v20.x（napi=8），npm rebuild生成的二进制根本加载不了。
- 必须用匹配目标环境的参数重编译：
npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - 重编前清空缓存：
rm -rf node_modules/.pnpm node_modules/xxx/node_modules（xxx为插件名），否则旧二进制可能被优先加载 - 验证方式：在插件输出通道或调试控制台运行
console.log(process.version, process.versions.napi)，对比你期望的napi版本 - 注意：
runtimeExecutable只影响launch.json调试会话，不影响Extension Host进程——含原生模块的插件永远走VS Code内置Node
VSCode终端显示node --version是旧版，但系统终端是对的
VS Code启动时固化了shell环境快照，nvm use后不重启，主进程里的PATH不会更新。这不是配置没生效，而是进程级缓存未刷新。
- macOS下从终端执行
code .启动VS Code，才能确保读取当前shell的~/.zshrc（或~/.bash_profile） - Windows用nvm-windows时，每次
nvm use后，在VS Code里执行Terminal: Reload Shell Environment（Ctrl+Shift+P） - 终极方案：完全退出所有VS Code进程（macOS Dock右键→Quit；Windows任务管理器结束全部
Code.exe），再重新打开 - 别依赖“设置里改
terminal.integrated.env”，那只是注入变量，不解决PATH继承问题
require()加载.mjs报ERR_REQUIRE_ESM，但又不能全切type: "module"
Node.js模块加载器硬性禁止CommonJS的require()加载ESM文件，这不是语法错误，是解析阶段拦截。强行改type: "module"会让所有.js变成ESM，导致旧require('./config.js')全部失效。
- 分层处理：主入口（如
index.js）保持CommonJS；新模块（如CLI工具）用.mjs+import - 跨模块调用时，用
await import('./utils.mjs')替代require()——这是Node原生支持的合法方式 - 若需同步加载（如顶层参数解析），用
createRequire(import.meta.url)构造一个CJS加载器，但它仍不能加载.mjs，只能加载.cjs或未设type: module的.js - VS Code的Code Runner插件默认用
node xxx.js执行，不识别type字段——要么换用Debugger，要么给它加--experimental-specifier-resolution=node参数
process.versions.napi、runtimeExecutable作用域、shell环境继承这三者的组合效应。查Get-Command、打process.versions、杀干净Code.exe，比反复改配置管用得多。
