Sublime Merge 是一款由 Sublime HQ 开发的现代化、高性能 Git 图形化客户端。它继承了 Sublime Text 的流畅体验与强大性能，以其极致的响应速度、清晰的界面设计和强大的命令行集成，为 Mac 开发者提供了高效、直观的版本控制操作体验。本指南将详细介绍其核心功能与完整工作流程。

一、核心界面与工作区详解

Sublime Merge 的主界面设计简洁高效，主要分为以下几个核心区域：

顶部工具栏：包含最常用的操作按钮，如“提交”、“拉取”、“推送”、“分支”、“历史”等，以及当前仓库名称和分支状态显示。
左侧边栏：通常显示文件状态视图。分为三个主要部分：
- 未暂存的更改：列出工作目录中所有已修改但未通过 `git add` 添加到暂存区的文件。
- 已暂存的更改：列出所有已添加到暂存区、准备提交的文件。
- 合并冲突：在发生合并冲突时，此处会列出所有冲突文件。
中央主工作区：
- 文件差异对比视图：当在左侧选中一个文件时，此处会并排显示该文件的更改内容，左侧为旧版本，右侧为新版本，差异高亮显示。
- 提交历史视图：切换到“历史”标签页时，此处以图形化时间线形式清晰展示分支、合并、提交历史。
- 搜索与筛选栏：位于主工作区顶部，支持快速搜索提交历史、文件或分支。
底部状态栏与命令行：
- 集成命令行终端：这是 Sublime Merge 的一大特色。底部可以呼出一个功能完整的命令行终端，深度集成 Git，自动补全、命令历史、仓库状态提示一应俱全。
- 状态信息：显示当前操作状态或提示信息。

二、完整操作流程：从打开项目到提交推送

以下是一个从打开现有 Git 仓库到完成修改并推送的完整操作流程。

1. 打开或克隆现有仓库

操作步骤：

a. 启动 Sublime Merge。

b. 在欢迎界面，点击 “打开仓库” 按钮，或通过菜单栏 “文件” -> “打开仓库”。

c. 在文件选择器中，导航到本地已存在的 Git 仓库根目录，点击“打开”。

d. (克隆仓库) 若需克隆，点击欢迎界面的 “克隆仓库”，或使用菜单 “文件” -> “克隆仓库”。在弹出的对话框中输入远程仓库 URL 和目标本地路径，点击“克隆”。

快捷键：打开仓库 Cmd + O，克隆仓库 Cmd + Shift + O。

2. 进行日常修改与暂存

操作步骤：

a. 对项目文件进行编辑后，左侧“未暂存的更改”区域会自动刷新，列出所有更改的文件。

b. 暂存单个文件：点击文件名右侧的 “+” 图标，或选中文件后按 Return 键。文件将移动到“已暂存的更改”区域。

c. 暂存所有文件：点击“未暂存的更改”标题栏右侧的 “全部暂存” 按钮。

d. 暂存部分代码块（Hunk）或单行：在中央差异视图中，每个更改块左侧都有行号栏。点击行号栏的 “+” 图标可暂存整个块。将鼠标悬停在单行行号上，点击出现的 “+” 图标可仅暂存该行。

快捷键：暂存/取消暂存选中文件 Return，暂存全部 Cmd + K。

3. 提交更改

操作步骤：

a. 确保所有需要提交的更改都已位于“已暂存的更改”区域。

b. 在底部提交信息输入框中，输入清晰的提交摘要和详细描述。

c. 点击输入框右侧的 “提交” 按钮，或使用快捷键。

快捷键：提交 Cmd + Enter。

4. 同步远程仓库（拉取与推送）

操作步骤：

a. 拉取远程更新：点击顶部工具栏的 “拉取” 按钮（向下箭头图标），或使用菜单 “仓库” -> “拉取”。

b. 推送本地提交：点击顶部工具栏的 “推送” 按钮（向上箭头图标），或使用菜单 “仓库” -> “推送”。

c. 如果当前分支首次推送，软件会提示设置上游跟踪分支，确认即可。

快捷键：拉取 Cmd + Shift + P，推送 Cmd + P。

5. 查看历史与切换分支

操作步骤：

a. 点击顶部工具栏的 “历史” 标签页，或使用左侧边栏底部的“历史”图标。

b. 在主工作区，以图形化方式浏览提交历史。点击任意提交，下方会显示该提交的详细信息及文件更改列表。

c. 切换分支：点击顶部工具栏的 “分支” 按钮，在弹出的面板中，双击目标分支即可切换。或右键点击分支，选择“检出”。

d. 创建新分支：在“分支”面板中，点击右上角的 “+” 图标，输入新分支名称并基于当前提交创建。

快捷键：打开分支面板 Cmd + B，打开历史视图 Cmd + H。

三、常用功能进阶技巧

交互式变基：在“历史”视图中，右键单击某个提交，选择“变基到此处…”。在接下来的交互面板中，你可以拖拽提交调整顺序，或右键点击提交选择“压扁”、“改写”、“丢弃”等操作，这是整理提交历史的强大工具。
强大的搜索：使用顶部搜索栏（Cmd + F）可以搜索提交信息、作者、更改的文件路径或文件内容。支持正则表达式。
文件历史追溯：在文件列表或差异视图中，右键单击任何文件，选择“文件历史”，可以单独查看该文件的完整提交历史。
命令行集成的高级用法：底部的命令行终端（Ctrl + `）支持所有 Git 命令，并带有智能提示。你可以在此执行任何复杂操作，同时 GUI 界面会实时同步状态。
暂存与隐藏的灵活运用：使用工具栏的“隐藏”按钮（或 Cmd + Shift + H）可以将未提交的更改暂时保存起来，清理工作区以处理其他紧急任务。之后可通过“隐藏列表”恢复。

四、常见问题与解决方案

问题现象	可能原因	解决方案
打开文件夹后提示“不是Git仓库”	当前目录未初始化或不是Git仓库根目录。	1. 确保打开的是包含 `.git` 文件夹的根目录。 2. 若无，可在底部命令行使用 `git init` 初始化。
拉取/推送时提示认证失败	SSH密钥未配置或HTTPS密码凭证错误/过期。	1. 检查SSH密钥是否已添加到ssh-agent并关联到远程托管平台（如GitHub）。 2. 对于HTTPS，Mac钥匙串可能存储了旧密码。前往“钥匙串访问”应用，搜索相关域名（如github.com），删除旧条目，再次操作时会提示重新输入。
合并冲突后界面混乱	文件存在冲突标记（<<<<， =====， >>>>），需要手动解决。	1. 冲突文件会出现在左侧“合并冲突”区域。 2. 点击文件，在中央差异视图使用顶部按钮选择“使用我们的版本”、“使用他们的版本”或手动编辑文件解决冲突。 3. 解决后，文件会移至“已暂存的更改”区，正常提交即可。
提交历史视图不显示图形线	视图设置可能被调整。	在“历史”视图右上角，确保“显示图形”选项（类似分支图标的按钮）是开启状态。
无法找到某个已提交的更改	提交历史较多，或当前分支/筛选条件有误。	1. 充分利用搜索功能（`Cmd + F`），按提交信息、作者或文件搜索。 2. 检查是否在正确的分支上查看历史。

五、Sublime Merge for Mac 快捷键汇总

功能分类	操作描述	快捷键 (Mac)
仓库与视图	打开仓库	`Cmd + O`
克隆仓库	`Cmd + Shift + O`
切换至历史视图	`Cmd + H`
打开分支面板	`Cmd + B`
更改操作	暂存/取消暂存选中文件	`Return`
暂存全部更改	`Cmd + K`
丢弃选中文件的未暂存更改	`Cmd + Delete`
提交已暂存更改	`Cmd + Enter`
隐藏未提交的更改	`Cmd + Shift + H`
远程同步	拉取远程更改	`Cmd + Shift + P`
推送本地提交	`Cmd + P`
获取远程更新（不合并）	`Cmd + Shift + F`
导航与搜索	聚焦搜索栏	`Cmd + F`
切换至下一个标签页	`Ctrl + Tab`
切换至上一个标签页	`Ctrl + Shift + Tab`
显示/隐藏命令行终端	Ctrl + `
其他实用操作	刷新仓库状态	`Cmd + R`
复制选中提交的SHA哈希值	`Cmd + C` (在历史视图中选中提交时)