Sublime Merge 入门很简单。在本指南中，您将看到开始所需的所有步骤。
一、克隆现有仓库
使用 Git 时的第一步通常是克隆现有的远程存储库。此过程将在本地计算机上创建远程仓库的副本，以便您可以开始进行更改。
您需要的物品
- 远程仓库 URL 示例 URL：
https://github.com/sublimehq/Packages.git - （可选）远程仓库 的身份验证信息
（可能是您用于对远程服务进行身份验证的用户名和密码）
克隆仓库的步骤
- 通过
File Clone Repository...（文件▶克隆存储库...）导航到克隆页面。Sublime Merge 在首次运行时自动打开此页面（如下所示） - 将远程存储库 URL 粘贴到
Source URL （源 URL） 输入 - 使用
Destination Path（目标路径） 输入 设置本地存储库路径这是存储库将被克隆到的位置 - （可选）使用
Repository Name（存储库名称） 输入 更改本地存储库的名称 这是存储库的名称（作为文件夹存储在磁盘上） - 选择
Clone （克隆） 按钮
克隆完成后，存储库将在 Sublime Merge 中自动打开。
二、创建新存储库
如果你正在启动一个新项目，你可能希望改为初始化一个新的 Git 存储库。
创建新仓库的步骤
- 打开 Sublime Merge，然后选择
New Repository（新建存储库） 按钮 - 选择要初始化为 Git 存储库的文件夹
完成此作后，新仓库将在 Sublime Merge 中自动打开。
三、了解界面
Sublime Merge 界面由两个主要部分组成 - Overview（概述） 和 Details（详细信息） 部分。
“概述”部分
overview 部分旨在显示存储库的摘要。
它包含 Locations（位置） 列、Commitits（提交） 列和 Files（文件） 列 - 下面将介绍每个列。
位置
Locations 列显示存储库中包含的所有分支、远程、标签、存储和子模块。
可以选择每个项目来显示其在 commit graph 中的位置（不包括子模块）。每个项目还有一个显示常见作的上下文菜单。
提交
Commitits 列显示存储库中包含的所有提交的图表。 提交图绘制为一系列提交摘要，这些提交摘要通过彩色线条连接（表示提交的拓扑）。
每个提交摘要都包含有用的信息，例如提交消息和作者，以及任何关联的分支。 提交摘要的上下文菜单还包含常见作。
选择提交摘要后，所选提交的详细信息将显示在 Details （详细信息） 部分中。
可以选择多个提交来执行批量作，例如 OR 提交。 如果选择了多个提交，则 Details （详细信息） 部分中还将显示第一个提交和最后一个提交的差异。squashingdropping
文件
Files 列显示与当前选择关联的所有文件的列表。
如果未选择任何提交，则文件列表将显示所有 Unmerged（未合并）、Modified（已修改）、Untracked（未跟踪） 和 Staged（已暂存） 文件。
如果选择了提交，则文件列表将显示所选提交中所有已更改的文件。
“详细信息”部分
details （详细信息） 部分显示提交图中所选项目的详细视图。
待处理的更改
在提交图中未选择任何提交时，工作目录和索引的当前状态将显示在 details 部分中。 在这里，您可以准备和创建新的提交。
将为每个 Unmerged（未合并）、Modified（已修改）、Untracked（未跟踪） 和 Staged（已暂存） 文件显示一个差异。每个文件都有一个关联的选项卡，可以选择该选项卡来查看对单个文件的更改。
提交详细信息
在提交图中选择提交后，所选提交的详细信息将显示在 details （详细信息） 部分中。
提交元数据（如提交消息和作者）显示在此部分的顶部。
提交元数据下方是所有已更改文件及其关联的差异（更改）的列表。
四、使用命令面板
命令面板是访问 Sublime Merge 中可用的大量命令的快速方法。
例如，重命名分支或导航到标签
您可以通过 工具 ▶ Command palette（命令面板）...或通过 Ctrl + p (Cmd + p 适用于 MacOS）。
命令面板显示一个命令列表，可以通过键入要查找的命令名称部分来筛选这些命令。
您还可以将自己的自定义命令添加到命令面板。（自定义命令面板）
五、创建提交
对仓库中的任何本地文件进行更改后，您的更改将显示在 Pending changes （待处理更改） 部分中。
修改后的文件将显示在 Working Directory（工作目录）部分中，新文件将显示在 Untracked Files（未跟踪的文件） 部分中。要将新更改提交到本地存储库，您首先需要暂存更改。
使用 Sublime Merge 暂存更改
- 暂存整个文件：选择文件顶部的“
暂存文件”按钮 - 暂存整个块：选择文件顶部的“
暂存块”按钮 - 暂存单行：选择要暂存的单行，然后选择“
暂存行”
在提交之前检查您的更改
您可以通过滚动到摘要页面的 Staged files （暂存文件） 部分来查看暂存的更改。 或者，您可以选择每个暂存文件选项卡以单独查看文件。
提交暂存的更改
首先，使用位于屏幕顶部的提交消息输入（默认情况下）。 输入提交消息后，选择 Commit （提交） 按钮。
六、修复和编辑提交
你可能会做一个新的提交，却发现你犯了一个错误。也许提交信息不太正确，或者您忘记在提交中包含文件。
Sublime Merge 对编辑提交以处理这些情况提供了一流的支持。
编辑提交消息
要编辑提交消息，只需打开提交上下文菜单，然后选择“编辑提交”▶“编辑提交消息…”即可。
现在，您可以在 Details （详细信息） 部分输入新的提交消息。对更改满意后，选择 Save （保存）。
编辑提交内容
编辑最近的提交
要编辑最近的提交，您可以使用 amend 修改 功能。
首先在文本编辑器中编辑要更改的文件，然后使用 Sublime Merge 暂存更改。暂存更改后，选择提交按钮旁边的下拉按钮，然后选择“修改上一个提交”(--amend)。
Git 现在会将暂存的更改与之前的提交合并。
编辑较旧的提交
如果要编辑较旧的提交，可以使用 Edit Commit Contents （编辑提交内容） 功能。
找到要编辑的提交，打开上下文菜单，然后选择“编辑提交” ▶ “编辑提交内容…”。所选提交将被撤消，您将有机会更新提交内容。对更改满意后，请使用 Commit “提交” 按钮重新提交。
选择 Continue rebase （继续变基） 按钮完成编辑。如果您犯了错误并想中止编辑，请选择 Abort rebase （中止变基） 按钮。
请注意，编辑较旧的提交可能会产生合并冲突，需要解决这些冲突。请查看：解决合并冲突。
关于编辑提交的说明
编辑提交会创建一个全新的提交并隐藏旧的提交（由于 Git 的工作方式）。此外，在本地编辑提交不会更新任何远程提交。 如果您正在编辑的提交已推送到远程存储库，请谨慎作。
如果是这种情况，您需要通过执行 push --force-with-lease （在高级推送菜单中可用） 来推送更新的提交。 这会告诉远程仓库用更新的提交覆盖远程提交（前提是在此期间没有人更新远程提交）。
七、创建分支
通过命令面板创建新分支
打开命令面板（请参阅使用命令面板）并选择 Create Branch（创建分支）...
通过提交图创建新分支
在提交图中打开现有提交的上下文菜单，然后选择 Create branch at commit（在提交时创建分支）...
从远程分支创建本地分支
打开位置栏，然后找到 Remotes（远程） 部分。右键单击远程分支，然后选择 Create local branch from（从...创建本地分支）...
八、推拉
需要推送和拉取才能与他人共享您的工作。这是通过向远程存储库推送和拉取提交来完成的。
Push（推） 和 Pull（拉） 按钮
您可以使用位于界面右上角的按钮执行基本的推送和拉取。 对于高级推送和拉取选项，您可以选择位于主按钮旁边的下拉按钮。
九、合并分支
通过位置栏合并
- 在
Locations （位置） 栏中找到分支列表 - 在 branches （分支）列表中，找到要合并到当前签出分支的分支
- 打开给定分支的上下文菜单，然后选择
Merge {branch1} into {branch2}（将 {branch1} 合并到 {branch2}）...
通过提交图合并
- 在提交图中，找到要合并到当前签出分支的分支
- 打开给定分支的上下文菜单，然后选择
Merge {branch1} into {branch2}...
通过命令面板合并
- 打开命令面板（请参阅使用命令面板）
- 搜索并选择
Merge branch（合并分支）... - 找到并选择要合并到当前签出的分支的分支
十、解决合并冲突
当将更改合并到同一个文件时，Git 将尝试自动合并更改。如果它无法自动执行此作，它会将文件标记为未合并，您必须手动解决合并冲突。
要解决合并冲突，您可以使用 Sublime Merge 提供的合并工具。
解决合并冲突的步骤
在 Pending changes （待定变更）部分找到未合并的文件。
在未合并的文件标题中，您将看到 Resolve（解决） 可以选择该按钮以打开合并工具。
合并工具
合并工具由 3 列组成：左侧的 Ours、中间的 Merged 和右侧的 Theirs。
合并工具
Ours 和 Theirs 对应于冲突的文件，而 Merged 对应于生成的合并文件。还可以选择 Base 以显示合并 Base 文件。
冲突的更改将显示 CONFLICT 标记。您可以使用位于冲突块旁边的 ▶ 或 ◀ 按钮选择要接受的冲突更改。
解决所有冲突后，您可以选择 Save and stage （保存并暂存）以保存合并的文件并暂存它。或者，您可以选择 Cancel （取消） 以放弃更改。
十一、添加远程
要将提交推送到远程仓库，您可能需要添加新的远程仓库。
通过命令面板添加远程
打开命令面板（请参阅使用命令面板）并选择 Add Remote（添加远程）...。
您还可以在命令面板中找到 Delete Remote（删除原创）... 和 Rename Remote（重命名远程）... 命令。
十二、设置 upstream
upstream 分支告诉 Git 哪个远程分支与本地分支关联（并用于指示将新提交推送到何处）。
通过命令面板设置 upstream branch（上游分支）
- 打开命令面板（请参阅使用命令面板），然后选择
Set Branch Upstream（设置上游分支）... - 找到要为其设置上游的分支并选择它
- 找到你想要设为上游的远程分支，然后选择它
通过位置栏设置 upstream branch 上游分支
- 在
Locations （位置） 栏中找到分支列表 - 在
branches（分支） 列表中，找到要为其设置 upstream（上游） 的分支 - 打开上下文菜单，然后选择
Set Upstream（设置上游）... - 找到你想要设为上游的远程分支，然后选择它
十三、远程身份验证
对远程仓库进行更改时，您可能需要提供身份验证。
Git 在访问远程存储库时支持两种连接协议：和 . 这些协议中的每一个都需要不同类型的身份验证，如下所述。HTTPS SSH
通过 HTTPS 进行身份验证
当使用 HTTPS 连接对存储库执行需要身份验证的作时，将显示身份验证对话框。 输入用于对远程存储库进行身份验证的用户名和密码，然后选择 OK 按钮。
您可能不想在每次执行推送或拉取时都输入您的凭证。在这种情况下，您可以使用 Git 的内置密码管理器将凭据缓存一段时间。 为此，请打开 Sublime Merge 并导航到 工具 ▶ 密码缓存.您可以请求 Git 将凭证存储长达一周。
请注意，这仅适用于 Linux 和 MacOS。对于 Windows 用户，您可以使用适用于 Windows 的 Git 凭证管理器。（见 https://github.com/Microsoft/Git-Credential-Manager-for-Windows）
通过 SSH 进行身份验证
对于 SSH 身份验证，Git 将尝试使用存储在 ~/.ssh/ 的默认 ssh 密钥进行身份验证。 系统可能会要求您解锁密钥，在这种情况下，您可以输入与 SSH 密钥关联的密码以继续。
SSH 凭证的持久存储取决于作系统。对于大多数 Linux 发行版，您可以在启动时自动解锁 SSH 密钥。 对于 MacOS，您可以将 SSH 凭证添加到系统密钥链中。为此，请从控制台运行 ssh-add -K PATH_TO_KEY。 对于 Windows，您可以使用 plink / pageant 来连接和存储 SSH 凭据。
Windows：使用 Sublime Merge 设置 PuTTY / plink / pageant
本指南假定您拥有可导入 PuTTY 的现有 SSH 密钥。如果没有，请先阅读本指南。
- 首先在此处下载并安装 PuTTY
- 安装后，打开 PuTTYGen 并选择
Conversions ▶ Import Key。 - 选择您现有的 RSA 密钥（可能在
~/.ssh/id_rsa.pub 中找到) - 导入后，将私钥的副本保存到同一文件夹
现在密钥已保存，您可以通过首选项在 Sublime Merge 中启用 plink/PuTTY。
- 打开 Sublime Merge 并选择
首选项 ▶ 首选项... - 导航到
高级 在首选项对话框中。 - 导航到 SSH 路径，并将其设置为 plink 系统路径（可能是
C：\Program Files （x86）\PuTTY\plink.exe）。
现在 Sublime Merge 正在使用 plink，最后一个可选步骤是启动 pageant 并加载您的凭据。这可确保您不必在每次执行远程作时都输入 SSH 凭证。
- 启动 Pageant 可执行文件
- 启动后，您会在系统托盘中看到 Pageant 图标。右键单击该图标，然后选择
Add Key（添加密钥）。 - 找到并选择您之前保存的私钥
值得注意的是，如果要缓存 SSH 凭据，则必须在每次启动 Windows 会话时启动 pageant。可以将 pageant 添加到您的 Windows 启动文件夹中，但此处未涵盖。
发布于 2025-05-28
广东
Sublime Merge Git 可视化工具软件
