如何在VSCode中配置Node环境Git-VSCode-PHP中文网

node.js和git需全局安装并正确配置path，vscode终端须继承shell环境变量；验证方式为在vscode终端执行node -v和git --version，失败则需检查path、重启vscode或手动设置git.path。

如何在vscode中配置node环境git

确认 Node.js 和 Git 已全局可用

VSCode 本身不自带 Node.js 或 Git，它只是调用系统已安装的命令行工具。如果 node -v 或 git --version 在 VSCode 内置终端里报“command not found”，说明它们没进系统 PATH，或者 VSCode 没读到正确的 shell 环境。

常见错误现象：
• 终端里能运行 node，但 VSCode 启动后新建终端却提示找不到命令
• 调试时 launch.json 报错 “Cannot find runtime 'node'”
• GitLens 或源代码管理视图显示 “Git not found”

macOS 用户注意：VSCode 默认启动的是 zsh（不是你手动打开 Terminal 时可能用的 bash），检查 ~/.zshrc 是否导出了 Node 和 Git 的路径，比如 export PATH="/opt/homebrew/bin:$PATH"（Homebrew 安装）或 export PATH="/usr/local/bin:$PATH"
Windows 用户注意：安装 Node.js 时务必勾选 “Add to PATH”，否则 npm 命令在 VSCode 终端里大概率不可用；若已安装但无效，可手动把 C:\Program Files\nodejs\ 加入系统环境变量
重启 VSCode —— 不是重开窗口，而是彻底退出再启动，否则 PATH 不会刷新

让 VSCode 正确识别并使用 Git

VSCode 的源代码管理（SCM）面板依赖内置的 Git 集成，但它不会自动发现所有 Git 安装路径，尤其当 Git 是通过 Scoop、MacPorts 或自定义路径安装时。

使用场景：
• 点击左下角分支名无反应
• 右键文件 → “Git: Stage” 灰掉
• 提交按钮不可点击

打开设置（Cmd+, 或 Ctrl+,），搜索 git.path，填入绝对路径，例如：
• macOS：/usr/local/bin/git 或 /opt/homebrew/bin/git
• Windows：C:\Program Files\Git\bin\git.exe
验证方式：在 VSCode 终端执行 which git（macOS/Linux）或 where git（Windows），复制输出结果粘贴到 git.path 设置项
不要用 PowerShell 封装的 git 别名（如某些 Scoop 安装会生成 git.ps1），VSCode 不支持 .ps1 脚本作为 Git 二进制 —— 这会导致 git: The term 'git' is not recognized 错误

调试 Node.js 项目必须配好 launch.json

光有 Node 运行时还不够，VSCode 的调试功能靠 .vscode/launch.json 驱动。缺这个文件，F5 会直接报错，而不是自动创建一个可用的配置。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

参数差异：
• "request": "launch" 适用于直接运行 index.js 类入口文件
• "request": "attach" 用于连接已运行的 Node 进程（如 nodemon）
• "runtimeExecutable" 只在你需要指定非默认 Node 路径时才设（比如用 nvm 切换版本）

最简可用配置（保存为 .vscode/launch.json）：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch index.js",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/index.js",
      "console": "integratedTerminal"
    }
  ]
}</node_internals>

如果项目用 ts-node 或 esm，别改 "type"，而是加 "runtimeArgs"，例如："runtimeArgs": ["-r", "ts-node/register"]
修改 program 字段前，先确认文件真实存在且路径没错 —— VSCode 不会帮你补全或校验 ${workspaceFolder} 下的文件名

ESLint + Prettier 协同容易出冲突

两者都管格式，但职责不同：ESLint 检查逻辑和潜在错误，Prettier 只负责样式。如果没协调好，保存时会互相覆盖，甚至导致编辑器卡顿或格式错乱。

容易踩的坑：
• 安装了 eslint 和 prettier，但没装 eslint-config-prettier —— ESLint 规则和 Prettier 格式化会打架
• 在 settings.json 里同时开了 "editor.formatOnSave": true 和 "editor.codeActionsOnSave": { "source.fixAll.eslint": true }，结果保存一次触发两次格式化

推荐做法：只让 ESLint 修问题，Prettier 负责格式。在 .eslintrc.js 中 extends 加上 'prettier'，并单独安装 eslint-config-prettier 和 eslint-plugin-prettier
VSCode 设置里关掉 editor.formatOnSave，只留 "editor.codeActionsOnSave": { "source.fixAll.eslint": true } —— 这样 ESLint 会调用 Prettier 规则来格式化，一步到位
检查是否生效：故意写个 const a = 1 ;（多余空格），保存后应自动变成 const a = 1;；如果没变，说明 ESLint 没读到 Prettier 配置