VSCode依赖系统Git实现版本管理,需确保git命令全局可用且路径配置正确;通过命令面板可快速执行Git操作;分支控件点击即切换,远程分支默认进入分离头指针状态;合并冲突须用内置按钮解决并点击“完成合并”确认。
VSCode 本身不自带 Git,它靠集成系统已安装的 Git 命令行工具来实现版本管理。没装 Git 或路径没配对,所有 Git 功能按钮都是灰色的——这是你遇到的第一道坎。
确认 Git 是否可用且路径正确
VSCode 的源代码管理(SCM)视图依赖
命令全局可用。如果点击“初始化仓库”没反应、右下角不显示分支名、提交按钮禁用,先排查这个。
终端里运行
,必须有输出(如
)
VSCode 设置里搜
,确保值是 Git 可执行文件的绝对路径,例如:
(
mac
OS/Linux)或
(Windows)
Windows 用户特别注意:别选
,要选
,否则 SSH 认证、子模块等会失败
用命令面板快速触发常用 Git 操作
鼠标点来点去效率低。按
(Win/Linux)或
(macOS),输入关键词直接执行,比找图标快得多。
—— 初始化
本地仓库
(仅当当前文件夹没
时可用)
—— 克隆远程仓库,支持 HTTPS 和 SSH URL,输入后自动打开新窗口
/
—— 拉取或推送,会自动识别当前分支和远程关联
—— 弹出输入框,支持多行提交信息;加
签名需提前配好 GPG
理解状态栏分支控件的真实行为
右下角显示的分支名(如
)不是装饰,它是可交互入口。但它的操作逻辑容易被误解。
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统(64位)。国内开发者可直接访问 Trae 中文官网(trae.cn 或 trae.com.cn),一键下载官方正版 .exe 安装包,享受国内直连的高速稳定体验。安装过程极其简便,双击即可运行,并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型,让你开箱即用,轻松开启高效的 AI 智能编程之旅。
下载
点击分支名 → 列出本地所有分支 + “创建新分支” + “从远程拉取分支”选项
选一个本地分支 → 立即
,不弹确认;切换成功后编辑器不会刷新文件,但后续提交会写入该分支
选远程分支(如
)→ VSCode 默认执行
,进入分离头指针状态,非常危险,除非你明确想检出某次提交
想跟踪远程分支?得先选“创建新分支”,在输入框里填名字,再勾选“基于远程分支”并选中对应项
处理合并冲突时别跳过“接受更改”按钮
当
或
报冲突,VSCode 会高亮标记冲突块,并在编辑器顶部显示操作条。这里的关键动作不是手动删代码,而是用内置按钮解决。
每个冲突块上方会出现三组按钮:
、
、
点错一次就可能丢掉一方修改;尤其是
会保留双方内容但**不加任何分隔符**,需人工检查是否语义重复
解决完所有冲突后,必须点右上角的
(“完成合并”),否则
仍显示未合并,也无法提交
误操作后想重来?运行
,VSCode 会自动刷新状态
真正卡住人的往往不是功能找不到,而是分支切换时的 detach 状态、冲突解决后忘了点“完成合并”、或者 Git 路径指向了错误的
git
.exe。这些点不写进肌肉记忆,再多的图形按钮也救不了手忙脚乱的下午三点。
gitgit --versiongit version 2.40.1git.path/usr/bin/gitC:\Program Files\Git\bin\git.execmdgit.exebingit.exeCtrl+Shift+PCmd+Shift+PGit: Initialize Repository.gitGit: CloneGit: PullGit: PushGit: Commit-Smaingit checkoutorigin/feature/logingit switch --detachgit mergegit pullAccept Current ChangeAccept Incoming ChangeAccept Both ChangesAccept Both Changes✓git statusgit merge --abort