vscode终端node版本与系统不一致是因为其默认以non-login shell启动，不加载~/.zshrc或~/.bashrc中的nvm配置；需将nvm初始化代码移至~/.zsh_profile（macos/linux）或~/.bash_profile，并在vscode设置中为终端添加"-l"参数，且必须彻底退出并重启vscode才能生效。
VSCode终端node -v和系统终端不一致
这不是nvm没装好，而是VSCode默认以non-login shell启动zsh或bash，压根不读~/.zshrc或~/.bashrc——而你的nvm初始化代码大概率只写在那儿。login shell（比如zsh -l）才会读~/.zsh_profile或~/.bash_profile。
验证方式：在VSCode终端里运行echo $-，输出含l才表示是login shell；再跑which nvm，为空就说明没加载。
- 把nvm初始化代码（
export NVM_DIR=...+source $NVM_DIR/nvm.sh）挪到~/.zsh_profile（macOS/Linux）或~/.bash_profile末尾 - VSCode设置里搜
terminal.integrated.defaultProfile.osx（或对应系统项），点“编辑在settings.json”，给当前shell加"args": ["-l"] - 删掉
settings.json里手动写的"terminal.integrated.env.osx": { "PATH": "..." }——它会覆盖原有PATH，让nvm切换失效 - 改完必须彻底退出VSCode（macOS右键Dock图标→Quit；Windows任务管理器杀光所有
Code.exe），再从终端执行code .重启
新开终端还是旧Node版本
nvm use只作用于当前shell进程，Terminal 1切了版本，Terminal 2仍是启动时继承的环境——这是正常行为，不是bug。想让每个新终端自动用项目指定版本，得靠.nvmrc触发，而不是手动切。
- 在项目根目录放
.nvmrc，内容就一行：18.18.2（不要带v前缀） - 确保
~/.zsh_profile末尾有nvm use --silent（或nvm use），否则.nvmrc不会被自动读取 - 别指望“统一所有终端”——每个终端独立加载
.nvmrc才是设计意图；手动nvm use只是临时补救 - Windows用户用nvm-windows，
nvm alias default后必须重启VSCode进程，nvm use本身不持久化
调试器F5还是旧Node版本
launch.json里的runtimeExecutable只控制调试主进程，和终端环境完全隔离。你在终端里nvm use 18.18.2，对F5毫无影响——调试器启动时只认VSCode启动那一刻的PATH快照。
- 在
.vscode/launch.json里显式写"runtimeExecutable": "${env:NVM_BIN}/node" - 前提：VSCode终端里先运行
echo $NVM_BIN，必须有输出（如/Users/xxx/.nvm/versions/node/v18.18.2/bin）；否则${env:NVM_BIN}展开为空，调试直接失败 - 绝对不要硬编码路径，比如
"runtimeExecutable": "/Users/xxx/.nvm/versions/node/v18.18.2/bin/node"——换机器、换用户就崩 - 改完
launch.json后，必须重启VSCode（不只是重载窗口），否则环境变量快照不会更新
插件报Cannot find module './build/Release/xxx.node'
这不是Node版本号差一点的问题，而是ABI错配：VSCode内置Electron的Node.js（如v22.4.0）用的是napi_build_version=9，而你用系统Node v20.x（napi=8）编译的原生模块根本加载不了。
- 重编译前先清空插件目录下的
node_modules/.pnpm和out/，否则旧缓存优先被加载 - 执行
npm rebuild时必须带全参数：--napi-build-version=9 --runtime=electron --target=34.0.0 - 验证插件实际运行的Node版本：在调试控制台或插件输出里打印
process.versions.node和process.versions.napi，和VSCode版本对应表核对 - 跨大版本项目（如v14 vs v22）建议用Dev Containers，每个容器自带独立ABI环境，彻底规避napi错配
nvm use，已打开的VSCode也不会更新——关干净、重开，是唯一可靠手段。
