VSCode终端不加载.nvmrc或~/.zshrc的根本原因是其默认以non-login shell启动，跳过shell初始化文件；需在settings.json中设"terminal.integrated.shellArgs": ["-l"]强制登录模式，并验证nvm current输出确保NVM_BIN已注入。
VSCode终端不加载.nvmrc或~/.zshrc？先确认shell启动模式
VSCode集成终端默认以non-login shell启动，根本不会执行~/.zshrc或~/.bash_profile里的nvm初始化逻辑——哪怕你用nvm use 18.19.1切好了版本，新开终端里which node还是指向/usr/bin/node。
验证方法：在终端运行shopt login_shell（bash）或echo $0（zsh），若输出off或-zsh以外的值，说明不是login shell。
- 最轻量解法：在
settings.json中设"terminal.integrated.shellArgs": ["-l"]，强制走login流程 - 更稳但需手动维护：关闭
terminal.integrated.shellIntegration.enabled，再通过命令面板Terminal: Select Default Profile选zsh/bash - 别碰
terminal.integrated.inheritEnv——它只继承父进程环境，对shell初始化文件无效
多用户环境下PATH注入必须避开/home共享目录
Linux多用户系统中，/home通常是NFS或权限受限挂载点。如果把nvm装在/home/username/.nvm，而VSCode又以root或另一用户身份启动（比如通过systemd --user服务），${env:HOME}可能解析失败，导致NVM_DIR为空。
实操建议：
- 把
nvm安装到用户有完全控制权的路径，例如/opt/nvm或/usr/local/nvm（需sudo），然后用chown -R $USER:$USER /opt/nvm授权 - 在
.vscode/settings.json中硬编码NVM_DIR和PATH："terminal.integrated.env.linux": { "NVM_DIR": "/opt/nvm", "PATH": "/opt/nvm/versions/node/v18.19.1/bin:${env:PATH}" } - 避免用
${env:HOME}拼路径——跨用户场景下它不可靠
调试器F5仍调用系统Node？runtimeExecutable必须动态取值
VSCode调试器启动时冻结环境变量快照，${env:NVM_BIN}若在终端里没真正加载过nvm，就会变成空字符串，最终fallback到/usr/bin/node。
关键检查点：
- 先在终端里运行
nvm current，确认输出是预期版本；若报command not found，说明nvm根本没生效 -
launch.json里写死路径如/opt/nvm/versions/node/v18.19.1/bin/node虽能跑通，但换机器就失效 - 真正可移植的写法是：
"runtimeExecutable": "${env:NVM_BIN}/node"，前提是上一步已确保NVM_BIN被注入且非空 - 如果项目用
.nvmrc，配合vsc-nvm插件，它会在VSCode启动时执行nvm use并设置NVM_BIN——但仅对新终端有效，旧终端要手动关掉重开
WSL或远程SSH场景下UID/GID错位会破坏Node模块权限
在WSL或通过Remote-SSH连接的Linux服务器上，若当前用户UID与node_modules目录创建者UID不一致（常见于root安装后普通用户使用），npm install会因权限拒绝失败，错误信息通常是EACCES: permission denied, access '/home/user/project/node_modules'。
这不是VSCode配置问题，而是底层文件系统权限映射失效：
- 检查
ls -ld node_modules，若所有者是root而当前用户是dev，立刻执行sudo chown -R $USER:$USER node_modules - 长期方案：在WSL的
/etc/wsl.conf里启用元数据支持：[automount]\noptions="metadata,uid=1000,gid=1000"（1000替换成你的UID） - 远程Linux服务器上，确保
npm config get prefix指向用户可写路径，如/home/username/.npm-global，并加到PATH里
多用户隔离真正的难点不在VSCode设置，而在Linux权限模型与Node生态的耦合——一旦node_modules所有权错乱，npm和yarn都会连锁失效，此时任何VSCode配置都救不了。
