根本原因是FreeBSD默认shell（sh/tcsh）与VSCode桌面启动不兼容，PATH未被继承；需修改~/.profile（sh/bash）或~/.login（tcsh）显式添加/usr/local/bin，并彻底退出后用code --no-sandbox重启。
FreeBSD 上 VSCode 找不到 node，不是插件没装、也不是 launch.json 写错了——根本原因是系统 PATH 没被继承，且 FreeBSD 默认 shell（sh 或 tcsh）和 VSCode 启动方式不兼容。macOS/Linux 用户习惯改 ~/.zshrc，但在 FreeBSD 上这条路走不通。
FreeBSD 的 node 命令为什么在终端能跑，VSCode 却报 command not found
FreeBSD 默认不使用 bash/zsh，多数用户用 sh（/bin/sh）或 tcsh（/bin/tcsh），而 VSCode 桌面启动时通常只读取 /etc/login.conf 和用户 shell 的登录初始化文件（如 ~/.profile 或 ~/.login），不会加载 ~/.bashrc 或 ~/.zshrc。即使你用 pkg 安装了 node（路径通常是 /usr/local/bin/node），若该路径没显式加进 ~/.profile，VSCode 就找不到它。
- 检查当前 shell：
echo $SHELL - 确认 node 实际位置：
which node（常见为/usr/local/bin/node） - 验证是否在 PATH 中：
echo $PATH | grep local—— 若无输出，说明未生效
必须改 ~/.profile 而不是 ~/.bashrc（FreeBSD 特定路径继承逻辑）
VSCode 桌面图标启动等价于一次「登录 shell」，FreeBSD 登录时只读 ~/.profile（对 sh/bash）或 ~/.login（对 tcsh）。哪怕你平时用 zsh，只要没把它设为默认 login shell，VSCode 仍按 sh 规则加载。
- 编辑
~/.profile，追加：export PATH="/usr/local/bin:$PATH" - 如果用
tcsh，改~/.login：setenv PATH "/usr/local/bin:$PATH" - 执行
source ~/.profile（或source ~/.login）立即生效 - 关掉所有 VSCode 窗口，**从命令行重启**：
code --no-sandbox（避免继承旧环境）
code-runner 在 FreeBSD 上执行 JS 文件乱码或卡住
FreeBSD 默认 locale 常为 C，不支持 UTF-8 输出；且 code-runner 默认不传 --experimental-specifier-resolution=node，遇到 ES Module 会直接报错。
- 打开 VSCode 设置，搜
code-runner.executorMap - 找到
javascript对应项，替换为："node --experimental-specifier-resolution=node -r /usr/local/lib/node_modules/babel-register $fileName"（若需 Babel 支持） - 更轻量的写法（推荐）：
"env LANG=en_US.UTF-8 node --experimental-specifier-resolution=node $fileName" - 别用它跑
process.stdin—— FreeBSD 下输入缓冲行为更敏感，直接进集成终端手动跑更稳
调试时断点不触发：launch.json 的 program 字段不能依赖相对路径
FreeBSD 的 vscode-js-debug 对路径解析比 Linux 更严格。写 "./index.js" 或 "src/index.js" 极易失败，因为工作目录（cwd）和 VSCode 打开的文件夹层级稍有偏差就找不到源文件。
- 始终用绝对路径或 VSCode 变量：
"program": "${file}"（调试当前打开文件） - 避免
"program": "${workspaceFolder}/index.js"—— 如果 workspace 是父目录，而文件实际在子目录，就会 404 - 确保 package.json 里有
"type": "module"（ESM 场景），否则import会被当 CommonJS 解析，路径映射全乱 - 用
console.log(__filename)验证运行时真实路径，再反推 launch.json 是否匹配
FreeBSD 的 PATH 继承机制和 locale 行为是最大盲区——它不像 Linux 发行版那样默认兜底，也不像 macOS 那样统一走 zsh。改错配置文件、漏掉 source、或者用图形界面直接双击启动 VSCode，三者任一都会让前面所有操作失效。
