VSCode内置Git支持需正确配置git路径、仓库初始化和凭据管理。须确认系统git路径填入设置，初始化后手动暂存并Ctrl+Enter提交，推送前清除旧凭据并完成GitHub OAuth授权，同步操作不处理冲突，需手动拉取更新。
VSCode 内置 Git 支持足够日常使用，但直接开箱即用容易卡在「看不到仓库状态」「提交不成功」「远程推送被拒绝」这几个点上。关键不是装插件，而是让 VSCode 正确识别 git 命令路径、当前工作区是合法 Git 仓库，且凭据能透传到终端和 GUI 操作中。
确认 VSCode 能调用系统 git 命令
VSCode 不自带 Git，它依赖你系统已安装的 git 可执行文件。如果 VSCode 底部状态栏不显示分支名，或点击源代码管理图标后提示 “Git not found”，大概率是路径没对上。
- 打开 VSCode 终端（
Ctrl+`），运行which git（macOS/Linux）或where git（Windows），确认输出有效路径 - 进入 VSCode 设置（
Ctrl+,），搜索git.path，把上面查到的完整路径（例如/usr/local/bin/git或C:\Program Files\Git\bin\git.exe）填进去 - 重启 VSCode，再看状态栏是否出现分支名；若仍无反应，检查当前打开的文件夹是否含
.git目录（即已是仓库）
初始化仓库与首次提交的常见断点
右键文件夹 → “Initialize Repository” 看似方便，但 VSCode 这个操作只运行 git init，不会自动 git add . 或弹出提交框——你得手动点左下角的加号图标把文件纳入暂存区，再点输入框上方的 √ 提交。
word-chinese-automation
下载
中文 Word 文档自动化校对工具。当用户需要对中文文本或 Word 文档进行标点符号检查、语法检查、错别字检查时使用此 skill。触发词：语法检查、错别字、标点符号、校对、检查文档。
- 初始化后，未暂存的文件显示为 “Untracked”，需逐个点击左侧
+，或右键选择 “Stage Changes” - 提交信息不能为空：输完文字后按
Ctrl+Enter（不是回车）才能真正提交；仅按回车会换行 - 若提交后状态栏分支名消失，说明当前分支没有关联远程，后续
git push会失败，需要先运行git branch --set-upstream-to=origin/main main（根据实际远程分支名调整）
推送失败：credential rejected 或 fatal: unable to access
这类错误几乎都源于凭据问题。GitHub 已停用密码登录，但 VSCode 的 Git 集成若缓存了旧凭据（尤其 Windows 的 Windows Credential Manager），就会反复报错。
- Windows 用户：打开 “控制面板 → 凭据管理器 → Windows 凭据”，删除所有含
github.com或git:的条目 - macOS 用户：在钥匙串访问中搜索
github.com，删掉相关 internet password 条目 - 之后首次
git push，VSCode 会弹出 GitHub 登录窗口，必须选 “Allow” 并完成 OAuth 流程，不能手动输密码 - 若仍失败，临时改用 HTTPS URL 的远程地址为带 token 形式：
https://<your_token>@github.com/owner/repo.git</your_token>（token 需有repo权限）
多人协作时容易忽略的细节
VSCode 的“同步更改”按钮（环形箭头）只做 git pull + git push，但它不会处理冲突。一旦别人推了新提交，你本地有未提交修改，点击同步会直接失败，且不提示原因。
- 每次开始编码前，先手动
git pull（命令面板里搜 “Git: Pull”） - 如果多人同时改同一文件，VSCode 会在编辑器顶部标出冲突块，并提供 “Accept Current Change” / “Accept Incoming Change” 快捷操作
- 切分支前确保暂存区干净，否则 VSCode 会阻止切换，并提示 “There are uncommitted changes”——这不是 bug，是保护机制
-
.gitignore文件必须放在仓库根目录，VSCode 的文件资源管理器才会计入忽略逻辑；放在子目录无效
Git 集成最麻烦的从来不是功能缺位，而是 VSCode 和系统 Git、凭证管理、远程服务三者之间的状态不同步。修好路径、清空旧凭据、接受“同步 ≠ 万能”这个前提，剩下就是自然流程了。
