vscode git集成默认启用，核心标志是状态栏显示分支名和变更数；若不显示，首要排查是否打开含.git的根目录、git路径配置正确及git.enabled为true。
git-diff 包默认启用，但多数人根本没意识到它在后台默默工作——Git集成不是“开关式功能”，而是渗透到文件树、编辑器边栏、状态栏的整套信号系统。你改了代码，左边缩略图立刻变红；你删了一行，行号旁自动标出 -；你切分支，右下角状态栏秒变 main 或 feat/login。这不是“有”或“没有”的问题，是“你有没有看见它在说话”。
怎么确认 Git 集成正在运行
别点菜单找“Git”选项——直接看状态栏最右侧。那里应该显示当前分支名（比如 main）和未提交变更数（比如 3）。如果只显示路径、编码、行号，说明 git-diff 被禁用了，或者项目根目录下压根没 .git 文件夹。
常见错误现象：
• 状态栏不显示分支，但命令行里 git status 正常
• 文件修改后左侧边栏无颜色标记
• 右键菜单里没有 Stage Hunk 或 Discard Changes
解决办法：
• 运行 apm list --installed | grep git，确认 git-diff 和 github 两个包都已安装且启用
• 在 Atom 设置 → Packages 中搜索 git-diff，检查是否勾选了 Enabled
• 确保你打开的是 Git 仓库的**根目录**（不是子文件夹），Atom 只在顶层识别 .git
用快捷键完成高频 Git 操作
Atom 不强制你记住所有命令，但几个组合键能省掉 80% 的鼠标操作：
• Ctrl+Shift+P → 输入 Git: Toggle Git Tab：呼出内置 Git 面板，查看暂存区、未暂存变更、冲突文件
• Ctrl+Alt+G：聚焦到 Git 面板（前提是启用了 github 包）
• 在编辑器任意位置按 Ctrl+Shift+H：对当前修改的代码块执行 Stage Hunk（暂存这一块）
• 光标停在被删行上，按 Ctrl+Shift+D：快速 Discard Changes（丢弃这行改动）
注意：github 包依赖 Electron 的原生 Node.js 环境，M1/M2 Mac 上若用 Rosetta 启动 Atom，Ctrl+Alt+G 可能失效——此时改用 Cmd+Shift+P 手动调出命令面板更稳
解决合并冲突时的视觉陷阱
Atom 会把冲突标记为三段式： / <code>======= / >>>>>>，但它**不会自动高亮冲突区域背景色**，除非你装了 merge-conflicts 插件。这是最容易被忽略的坑：
• 默认状态下，冲突文本只是普通文字，靠肉眼扫 很容易漏掉嵌套冲突<br>• <code>git-diff 只标出行级差异，不区分“本地区”和“远程区”
建议：
• 必装 merge-conflicts 包（apm install merge-conflicts），它会给冲突块加浅红/浅蓝背景色
• 冲突文件打开后，右键选择 Merge Conflicts: Resolve，它会生成带按钮的 inline 工具栏，点 Use Local 或 Use Incoming 直接替换整块
• 切记：解决完必须手动 git add <file></file>，Atom 不会替你 git commit
为什么 git-plus 包反而可能拖慢工作流
很多人一上来就装 git-plus，以为能替代终端——结果发现每次 git push 都卡在“Resolving host…”。这不是网络问题，是 git-plus 默认走 Atom 自带的旧版 Git 二进制（Windows 下是 bundled msysgit，macOS 下是过时的 libgit2 封装）。实际影响：
• git-plus 的 Pull 命令不支持 --rebase 参数，强制快进失败时直接报错
• 它无法读取 ~/.gitconfig 里的 alias，比如你设了 git lg，git-plus 根本不认识
• 大型仓库（>5k 提交）下，git-plus 的日志视图加载极慢，甚至假死
更可靠的做法：
• 卸载 git-plus，专注用 git-diff + github 包做可视化，Git 操作本身回归终端
• 如果非要 GUI，用系统原生 Git（确保 which git 返回的是 Homebrew 或 Xcode Command Line Tools 安装的版本）
• Atom 的 github 包底层调用的就是系统 Git，它比 git-plus 更轻、更准、更兼容
git-plus 处理 rebase 冲突，或期待 github 包自动推送到远端。留心状态栏那个小小的 main • 2，它才是整个集成系统的呼吸灯。
