根本原因是arch linux下vscode从桌面环境启动时未加载shell配置文件（如~/.zshrc），导致path缺失或napi abi不匹配；需手动source配置、显式声明path、安装base-devel与python，并用对应napi版本重建原生模块。
Arch Linux 上 VSCode 终端里 node 命令不可用，或版本错乱、原生模块加载失败，根本不是 VSCode 本身的问题，而是 Arch 的包管理机制与 Node.js 运行时链路没对齐——node 可能来自 community/nodejs（LTS）或 aur/nodejs-nightly，而 VSCode 启动时读取的 shell 环境变量未覆盖所有路径，或未触发 Pacman 的钩子更新。
为什么 Arch 终端里 node --version 正常，但 VSCode 里报 command not found
Arch 默认不修改全局 /etc/profile 或用户 shell 配置来注入 /usr/bin（Node 安装路径），而是依赖 Pacman 安装后自动注册。但 VSCode 从桌面环境（如 GNOME/KDE）启动时，可能不会加载 ~/.bashrc 或 ~/.zshrc 中的 PATH 补充逻辑。
- 先在系统终端运行
which node，确认输出是/usr/bin/node（官方包）还是/opt/nodejs/bin/node（AUR 包） - 再在 VSCode 终端执行
echo $PATH，看是否包含对应路径；若缺失，说明 shell 初始化文件未被加载 - Arch 用户常用
zsh，但 VSCode 可能 fallback 到sh或未读取~/.zshenv—— 检查ZDOTDIR是否被覆盖 - 临时验证：在 VSCode 终端里手动运行
source ~/.zshrc，再试node -v；若成功，就是启动时未自动 source
VSCode 启动后 node 版本和 process.versions.napi 对不上怎么办
Arch 的 nodejs 包升级频繁（比如刚推了 v22.5.0 + napi_build_version=9），但插件（如 SQLite3、Sharp）若用旧版 node-gyp 编译，ABI 就不匹配，报 Cannot find module './build/Release/xxx.node'。
- 不要直接
npm rebuild—— Arch 的node-gyp默认指向系统 Node，但可能没装python或make（Pacman 里叫base-devel） - 先装依赖：
sudo pacman -S base-devel python，再确保npm config get python指向/usr/bin/python - 重编译前清掉缓存：
rm -rf node_modules/.pnpm node_modules/.vite（如果你用 pnpm/vite），否则旧二进制会被优先加载 - 若用 AUR 包（如
nodejs-lts-fermium），必须用对应版本的node-gyp：运行npx node-gyp rebuild --napi-build-version=8 --target=16.20.2（按实际 napi 和 target 填）
如何让 VSCode 终端始终继承最新 Arch Node 环境
Arch 不像 macOS/Linux 发行版那样靠 nvm 切换，它靠 Pacman 包版本锁定，所以关键是让 VSCode 启动时“看到” Pacman 安装后的最终状态。
- 别从桌面图标启动 VSCode —— 改用终端命令
code --no-sandbox（确保读取当前 shell 的$PATH和$HOME） - 在
~/.zshrc末尾加一句：export PATH="/usr/bin:$PATH"（即使/usr/bin已在默认 PATH，显式声明可防 KDE/GNOME session 启动时截断） - 检查
~/.profile是否被忽略：Arch 的zsh默认不读~/.profile，除非你手动source ~/.profile；建议把 PATH 相关逻辑全挪到~/.zshrc - 如果用了
systemd --user管理服务，确认environment.d没冲突：cat /etc/environment.d/90-node.conf若存在，需匹配当前 Pacman 安装路径
最易被忽略的是：Arch 的 nodejs 包升级后，node-gyp 不会自动同步 target 版本，而 VSCode 插件主机进程仍用旧 ABI 加载原生模块——这和 Windows/macOS 的 nvm 场景不同，它不靠“切换”，而靠“重建”。
