硬写C:config.json或/home/user/config.json会出问题，应使用path.join(os.homedir(), '.myapp', 'config.json')；os.homedir()自动适配%USERPROFILE%或$HOME，比直接读环境变量更可靠。
Node.js项目里硬写 C:config.json 或 /home/user/config.json 会出问题
路径字符串直接拼接是跨平台第一雷区。Windows用反斜杠，Linux/macOS用正斜杠/，但更隐蔽的问题在于：路径是否真实存在、是否有权限、是否被Git忽略（比如~/.config在macOS是隐藏目录，在Windows却可能被防病毒软件拦截）。
真正安全的做法是交给path和os模块处理：
- 永远用
path.join()拼接路径，别用字符串+或path.resolve()盲目“绝对化” - 用户主目录统一用
os.homedir()，它自动识别%USERPROFILE%（Windows）或$HOME（Unix系） - 临时文件目录用
os.tmpdir()，而非手写/tmp或C:Temp
示例：
const path = require('path');
const os = require('os');
// ✅ 安全
const configPath = path.join(os.homedir(), '.myapp', 'config.json');
// ❌ 危险（Windows下报错，macOS可能权限拒绝）
const unsafePath = 'C:\Users\me\.myapp\config.json';
process.env.HOME 和 process.env.USERPROFILE 别直接读
这两个环境变量不是总存在，尤其在VSCode终端里——它继承的是shell启动时的快照，而nvm切换后PATH更新了，但HOME可能仍为空或指向旧位置。
os.homedir()才是可靠 fallback：它先查HOME/USERPROFILE，查不到就走系统API（Windows注册表、Unix getpwuid），比手动判断更稳。
常见错误场景：
- 脚本里写
process.env.HOME + '/.cache'→ macOS上正常，Windows上HOME未定义，结果变成'undefined/.cache' - CI流水线里用Docker镜像跑Node，
USERPROFILE根本不存在，HOME可能是/root而非/home/node
VSCode终端里which node显示路径不对？不是PATH没设，是进程没刷新
VSCode启动后，它的所有子进程（包括集成终端）都共享一份启动时捕获的环境变量快照。你用nvm use 18.20.4切了版本，终端里node -v还是旧版，不是nvm失效，而是VSCode主进程没重载环境。
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
解决方式按系统分：
- Windows：任务管理器结束所有
Code.exe进程，再重启 - macOS：Dock右键VSCode → Quit（不是关窗口），再从终端执行
code . - nvm-windows用户：每次
nvm use后，在VSCode里按Ctrl+Shift+P→ 输入Terminal: Reload Shell Environment
验证是否生效：which node输出应带~/.nvm/versions/node/...（macOS/Linux）或C:Users...
vm
odejs...（Windows），而不是C:Program Files
odejs
ode.exe这种全局安装路径。
跨平台调试时launch.json里的program路径要加path.resolve()
VSCode的launch.json不经过Node.js运行时解析，"program": "./src/index.js"在Windows下可能被当成相对路径查找失败（尤其配合cwd字段时）。更稳妥的是让JS代码自己算出绝对路径，再传给调试器。
做法是在package.json的scripts里封装一层：
"scripts": {
"debug": "node --inspect-brk=9229 $(npm -g bin)/vscode-js-debug/src/extension.js"
}
但更常用的是在launch.json中用preLaunchTask生成一个临时配置文件，或直接写：
"program": "${workspaceFolder}/src/index.js"
⚠️ 注意：${workspaceFolder}是VSCode变量，不是Node.js变量；如果逻辑复杂（比如动态入口文件），必须在JS里用path.resolve(__dirname, '../src/index.js')算好再传入，否则不同系统路径解析顺序可能不一致。
最易被忽略的一点：路径兼容不只是“能跑”，而是“跑得一致”。比如fs.readdirSync('./node_modules')在Windows不区分大小写，Linux/macOS严格区分——这会导致某些插件在CI里突然失效，而本地开发毫无察觉。
