vscode 的 git 功能依赖本地 git 程序，必须先安装 git 并正确配置 git.path、terminal.integrated.defaultprofile.windows 及 user.name/user.email，否则源代码管理面板无法正常工作。
VSCode 本身不带 Git，必须先装 Git 才能用 —— 这是所有配置的前提，跳过这步，后面全白搭。
Git 安装完，VSCode 还不认？检查 git.path 配置
VSCode 默认会自动找系统 PATH 里的 git.exe，但 Windows 上常因安装路径不标准或环境变量没刷新而失败。现象是：源代码管理面板（Ctrl+Shift+G）一片空白，或提示 “Command 'git.status' failed”。
- 打开 VSCode 设置（Ctrl+,），搜索
git.path - 点击“编辑在 settings.json”，填入你本地
git.exe的绝对路径，例如："git.path": "D:\Program Files\Git\bin\git.exe" - 路径必须精确到
git.exe，不是文件夹；反斜杠要双写或改用正斜杠 - 改完保存，重启 VSCode 终端或整个编辑器，再打开源代码管理面板看是否正常显示文件状态
终端默认用 Git Bash？别碰 terminal.integrated.shell.windows
这个配置项在 VS Code 1.85+ 版本已弃用，强行设置会导致终端启动失败或报错 The terminal shell path does not exist。2026 年起唯一推荐方式是改 terminal.integrated.defaultProfile.windows。
- 搜索设置项
terminal.integrated.defaultProfile.windows - 点击下拉菜单，选 “Git Bash”（如果没出现，说明 VS Code 没检测到你的 Git Bash 安装）
- 若列表为空，先确认 Git Bash 是否真装了，再手动添加配置：
"terminal.integrated.profiles.windows": { "Git Bash": { "path": "D:\software\Git\git-bash.exe", "args": ["--cd=."] } } - 注意：
path必须指向git-bash.exe，不是bash.exe；args加上--cd=.才能保证终端打开时在当前项目目录
提交前必须设的两行：用户名和邮箱
不配这两项，VSCode 提交时会卡住，或报错 please tell me who you are，即使你点了提交按钮也没反应。
- 打开 VSCode 内置终端（Ctrl+`），确保它已切换为 Git Bash 或 CMD/PowerShell
- 运行这两条命令（把引号里内容换成你自己的）：
git config --global user.name "Your Name"<br>git config --global user.email "you@example.com"
- 验证是否生效：运行
git config --global --list，输出里应包含刚设的user.name和user.email - 别用
git config（不带--global）去配单个项目——除非你明确需要覆盖全局设置，否则容易混淆
最容易被忽略的是：VSCode 的 Git 功能完全依赖本地 Git 程序，它只是个图形壳子。路径配错、Git 没装、用户信息空缺，三者任一出问题，面板就“失语”。别急着点按钮，先让终端里 git --version 和 git status 跑通再说。
