vs code 在 macos 上正常使用 git 图形化提交和推送,关键是让其识别系统 git:先在终端验证 git --version,再通过终端执行 code . 启动 vs code 以继承 shell 环境;若仍报错,需在 settings.json 中手动配置 "git.path" 为 which git 输出的绝对路径;随后通过 cmd+shift+g 打开源代码管理面板完成暂存、提交(需非空消息)和推送(右下角 ↑ 或 … → push),首次推送需绑定远程仓库。
macos 上让 vs code 正常用 git 图形化提交和推送,关键不是装插件,而是先让 vs code “看见”系统里的 git。很多卡在点不动提交按钮、右下角不显示分支名的问题,根源都在这一步没走通。
确保终端能运行 git --version
打开 macOS 终端(Terminal),输入:
git --version如果返回类似 git version 2.40.1,说明 Git 已正确安装(推荐用 Homebrew:brew install git);如果报 command not found,需重装或检查 PATH。
特别注意:通过 Dock 或 Spotlight 启动的 VS Code,默认不继承 shell 的环境变量(比如 ~/.zshrc 中设置的 PATH)。解决办法只有一个——在终端里执行:
这样启动的 VS Code 才能读到你配置的 git 路径。
手动指定 git.path(必要时)
如果 VS Code 仍提示 “Git not found”,按 Cmd + Shift + P,输入 Preferences: Open Settings (JSON) 回车,在 settings.json 中添加:
"git.path": "/opt/homebrew/bin/git"
这是 Apple Silicon(M1/M2/M3/M4)上 Homebrew 默认路径;Intel Mac 用户可能是 /usr/local/bin/git。不确定路径?在终端运行:
把输出结果完整复制粘贴进去即可。
启用并熟悉源代码管理面板
按 Cmd + Shift + G 打开源代码管理(Source Control)侧边栏,你会看到:
- 未暂存变更(Unstaged Changes):刚改完但还没准备提交的文件
- 已暂存变更(Staged Changes):右键文件选 Stage Changes 或点击左侧 + 号后才进入这里
- 提交输入框:必须填写非空消息(如 feat: add dark mode toggle),回车即 commit
- 右下角状态栏:显示当前分支(如 main)及同步状态(↑1 表示有 1 个本地 commit 未推送)
点击右下角分支名,可快速切换分支或创建新分支——无需命令行。
安全推送:别乱点“同步更改”
面板顶部有个蓝色按钮叫【同步更改】,它实际执行的是 git pull → 自动合并 → git push。日常开发中慎用,尤其多人协作时容易引发意外合并冲突。
更稳妥的做法是:
- 先点右下角分支名旁的 ↑ 符号,弹出菜单选 Push
- 或者点击源代码管理面板右上角 ⋯ → Push
- 首次推送会要求绑定远程仓库(如 GitHub/Gitee),按提示填 URL 即可(推荐用 SSH 地址,免密)
推送前记得确认远程分支名匹配(origin/main 还是 origin/master),避免被拒绝。











