使用 GIT 管理项目

Studio 中的 GIT 集成需要适用于 Visual Studio 2015、2017、2019 和 2022 的 Microsoft Visual C++ Redistributable。请查看软件要求页面。

对 GIT 进行身份验证

Studio 中的身份验证方法根据克隆 GIT 存储库（HTTPS 或 SSH）的使用方法而有所不同。检查此页面，查看应在使用 GitHub 时使用哪种身份验证方法。

备注：

• 您在 Studio 中提供的 GIT 凭据存储在 Windows 凭据管理器中。
• 如果您通过登录服务进行身份验证，则 GIT 与 Studio 的集成当前仅支持对 GitHub 的双重身份验证。对于其他工具，请使用利用个人令牌的 SSO 身份验证方法或基本访问身份验证方法。

当前指南详细介绍了对 GitHub 存储库进行身份验证的步骤，但 Studio 中的 Git 集成不仅限于此服务。

通过 HTTPS

首次克隆远程 GIT 存储库或使用 HTTPS 将当前项目复制到现有 GIT 存储库时，必须提供 GIT 凭据。这些凭据必须在“使用凭据”字段中输入：

您可以使用以下选项进行身份验证：

• “使用 GitHub 登录”- 使用您的 GitHub 帐户登录。
• “用户/密码”- 输入您的用户名和密码。

• “令牌”- 输入您的用户名和个人访问令牌。

  请按照此页面的详述步骤为您的 GitHub 存储库生成 GIT 令牌。

  重要提示：“使用 GitHub 登录”选项仅适用于托管在 github.com 上的存储库，并且要求您的组织或帐户安装 UiPath GitHub 应用程序。

通过 SSH

第一次克隆存储库或使用 SSH 将当前项目复制到现有 GIT 存储库时，可以选择使用私钥：

添加“私钥路径”和“密码”，然后单击“打开”以克隆远程 GIT 存储库。请查看此处详细介绍的步骤，为您的 GitHub 存储库生成 SSH 密钥。

身份验证失败

通过 HTTPS

克隆 GIT 存储库时，如果提供的凭据不正确，则会显示“输入凭据”窗口，并显示消息“身份验证失败”：

输入正确的凭据，然后重试。例如，您还可以使用 Git Bash 远程克隆自己的存储库，从而检查用户名和密码是否正确。

在下图中，我们试图通过 HTTPS 克隆存储库，但输入了不正确的密码。Git Bash 窗口显示凭据不正确。

通过 SSH

SSH 身份验证失败时，系统将显示以下“输入凭据”窗口：

请输入正确的私钥路径和密码，然后重试。例如，您还可以使用 Git Bash 远程克隆自己的存储库，从而检查令牌和/或密码是否正确。

在下图中，我们尝试通过 SSH 克隆存储库，但我们的帐户上没有设置任何公共 SSH 密钥。

克隆远程 GIT 存储库

1. 在“团队”选项卡中，选择“克隆存储库”。系统随即会显示“克隆远程 GIT 存储库”窗口。
2. 选择“使用 HTTPS”或“使用 SSH”。
3. 键入“存储库 URL”，并选择一个空的“签出目录”。
4. 选择“使用凭据”/使用密钥”并配置身份验证（使用 GitHub 登录、输入用户名和密码、针对 HTTPS 输入用户名和令牌，或针对 SSH 输入私钥路径和密码）。
5. 单击“打开”，Studio 随即会在“设计器”面板中打开项目。
6. 在“打开”窗口中，选择要在 Studio 中打开的 project.json 文件。

GIT 存储库克隆到本地工作目录后，将创建 .git 子目录，其含有所需的 GIT 存储库。元数据包含对象、参考和模板文件的子目录。此外，也会创建 HEAD 文件，该文件指向当前的签出提交。

向 GIT 添加项目

“GIT Init”功能可将当前项目添加到本地 GIT 存储库。通过“团队”选项卡或状态栏访问此命令。

1. 在 Studio 中创建或打开项目。单击“开始”选项卡 >“团队”。系统将显示“团队”选项卡。

2. 单击“GIT Init”按钮，然后选择一个应当用于初始化存储库的路径。该位置可以与项目文件夹或父文件夹相同。“提交更改”窗口将打开。

   
   

   

   
   
3. “修改的文件”部分中显示要添加到 Git 存储库中的项目文件。清除您不希望添加的文件旁边的复选框，或使用“全选”和“取消选择”功能。

4. 选择“显示无版本文件”选框，以将无版本文件添加到列表中。

   编写一条提交消息。单击“提交”按钮以将更改提交到本地 Git 存储库。

将项目添加到 SVN 时，“项目”面板中的上下文菜单包括 SVN 特定选项。请参阅 GIT 的上下文菜单选项。

注意：.local 文件夹包含为项目在本地缓存的数据，不应添加到 GIT。

提交并推送到 GIT

1. 从同样的“提交更改”窗口中，单击“提交并推送”按钮，以提交更改并推送到远程存储库。系统将显示“管理远程”窗口。该窗口也可从状态栏打开。

   
   

   

   
   
2. 在“名称”部分中，添加远程存储库的名称。
3. 在“URL”部分，添加远程 URL。

若要对添加的存储库进行修改，只需单击一个条目、更改其名称和 URL，然后单击“更新”按钮。完成后，单击“添加”，然后再单击“保存”。以下消息框将打开。这表示本地存储库未与远程存储库同步。

• 单击“覆盖远程内容”可将文件的本地版本推送到远程存储库并覆盖其中的文件。
• 单击“拉取（重定基准）”按钮可拉取远程文件并为本地分支重定基准。
• 单击“取消”按钮可放弃整个操作。

状态栏中会显示未推送的更改数量以及新添加的文件。单击 图标，打开“提交更改”窗口，或单击 图标推送更改。

注意：如果您在外部编辑器中编辑添加到来源控件的项目中的文件，则仅在您单击“项目”面板中的“刷新”后，更改才会在“项目”面板和状态栏中显示。

更改上次提交

Studio 与 Git 的集成也附带一个“修改提交”选项，可以在执行推送前更改最近一次执行的提交。

1. 在“项目”面板中右键单击修改后的文件，然后选择“提交”。系统将显示“提交更改”窗口。

   
   

   

   
   
2. 选择“修改提交”框。显示上次的提交消息以及已提交的文件。要查看当前文件和上次提交之间的更改，请使用“显示更改”选项。
3. 更改提交消息，再选择您要包含的文件。单击“提交并推送”或“提交”按钮。

撤消待定更改

Studio 附带一个选项，可以在您提交文件并推送到远程存储库之前，撤消对已加入版本控制的文件作出的更改。

修改了本地存储库中的文件后，单击 GIT 上下文菜单中的“撤消”，以打开“撤消待定更改”窗口。

选中文件旁边的复选框，再单击“撤消”。文件现已还原到更改之前的状态。

注意：“撤消”不包括版本文件。如果创建新文件后选择“撤消”，则不会从项目中删除文件。添加到项目树后，新文件将一直保留，除非手动删除。

复制项目到 GIT

“Studio 后台视图”和状态栏中的“复制到 GIT”按钮用于将当前项目复制到现有 GIT 存储库。

要这么做，首先在 Studio 中创建或打开一个项目。在“团队”选项卡中，选择“复制到 GIT”，再选取计算机上一个现有的 GIT 存储库文件夹。该项目将添加到本地 GIT 存储库中，“复制到 GIT”消息框也会打开。

• 选择“是”，以从新的位置打开该项目。“提交更改”窗口将打开。编写“提交消息”，再单击“提交并推送”或“提交”。
• 选择“否”，以返回到 Studio 用户界面。

创建和管理分支

从“管理分支”窗口中添加和管理分支。要访问分支，请在“项目”面板中右键单击项目节点或文件，然后选择“管理分支”，或使用状态栏中的 分支菜单。

• 要添加分支：

  1. 在表格中选择一个分支，然后单击窗口顶部的“加号”。

  2. 输入分支名称，单击“从 branch_name 创建分支”，然后单击“保存”。

     便可将分支添加到此列表中。

• 要刷新分支的列表，请单击窗口顶部的“刷新”。
• 要删除本地分支，请选择该分支，然后单击窗口顶部的“删除”。

• 要管理分支，请右键单击任何分支，然后从菜单中选择一个选项：

  • “签出分支”选项可切换到选定的分支。
  • “重定基准”选项可将当前分支重定基准为选定分支。

  • “合并”选项可将选定分支合并到当前分支中。

    若要将一个分支合并到 GIT 远程存储库的主分支，您需要在 Studio 中签出该主分支，再将修改的分支合并到主分支中。

• 要在分支之间切换，请打开状态栏中的 分支菜单，然后从最近签出的分支列表中选择要切换到的分支。

注意： 需要从“ 管理分支 ”窗口在 Studio 中本地添加分支。 尝试在分支之间切换时，从远程 GIT 存储库添加分支可能会导致出现问题。

查看提交历史

要查看项目或项目中特定文件或文件夹的提交历史，请右键单击“项目”面板中的项目节点、文件或文件夹，然后选择“显示历史记录”。这将打开“历史记录”窗口，其中显示所选文件、文件夹或项目的现有修订列表。每次提交时，提交哈希、消息、作者和日期都会显示在窗口上部的表格中。您可以在窗口下部的“详细信息”和“更改”选项卡中查看有关所选提交版本的更多信息。

比较文件的两个版本

要比较同一文件的两个版本，请执行以下操作：

• 如果您打开了文件的历史记录，请右键单击“历史记录”窗口中的提交版本，然后选择“与前一版比较”、“与本地版比较”或“与最新版比较”。
• 如果打开了文件夹或项目的历史记录，请在“历史记录”窗口中选择一个提交版本，然后在“更改”选项卡中双击一个文件以将其与先前版本进行比较。

根据上一个提交版本创建分支

要根据特定提交版本创建分支，请执行以下操作：

1. 右键单击“历史记录”窗口中的提交版本，然后选择“创建分支”。

2. 在“创建分支”窗口中：

   • 输入新分支的名称。
   • 要同时签出新分支，请确保已选中“创建后签出”选项。
3. 单击“确定”。

解决冲突

GIT 与 Studio 的集成附带一项功能，用于解决在执行“变基”或“推送”命令时可能发生的冲突，此选项位于“提交更改”窗口中。

每当 Studio 检测到本地文件与远程存储库中的文件存在冲突时，系统即会显示“解决冲突”窗口。

该窗口类似于“工作流区别”，显示文件的“远程”版本与“本地”版本之间的区别。

下表说明了“解决冲突”窗口中的可用选项。

选项	描述
选择左	选择代表要推送的远程存储库中的文件的左侧文件。
选择右	选择代表要推送的本地存储库中的文件的右侧文件。
保存	在选择左侧或右侧文件后，单击“保存”。
取消	取消操作并退出“解决冲突”窗口。
前一个	导航到所比较文件的前一个更改。
下一个	导航到所比较文件的下一个更改。
全部折叠	折叠 .xaml 文件中的所有节点。
全部展开	展开 .xaml 文件中的所有节点。

断开与 GIT 的连接

在以下两个情形中，可将 Studio 后台视图的“团队”选项卡中的“断开连接”选项用于版本控制的文件：

1. 流程初始化为本地 GIT 存储库。创建一个新流程，使用“GIT Init”将它添加到本地 GIT 存储库，再使用“断开连接”删除其子版本标签。
2. 若要删除子版本标签，可单击含有父级和子级项目的 Git 存储库的“断开连接”。
3. 如果断开子项目的连接，则含有已打开项目的整个 GIT 存储库将断开与来源控件的连接。Studio 中将显示一个消息框，需要您在执行断开连接操作前进行确认。

更改签名

可以通过“团队”选项卡 >“更改签名”来更改 GIT 确认签名。填写您的姓名和电子邮件地址，然后单击“确定”。

更改凭据

要更新用于连接到远程存储库的凭据，请执行以下操作：

1. 从状态栏的 分支菜单中，选择“管理远程”。
2. 在“管理远程”对话框中，右键单击一个远程存储库，然后选择“更改凭据”。

3. 根据克隆存储库的方式（通过 HTTPS 或 SSH），您可以登录 GitHub 帐户（仅适用于托管在 github.com 上的存储库），输入用户名/密码或用户名/令牌，或指向新的私钥，然后单击“确定”。

   凭据将在 Windows 凭据管理器中更新。

搭配使用 GIT 与代理服务器

如果通过代理服务器访问互联网，则 Studio 中的 GIT 集成可支持访问远程存储库。您可以通过两种方式完成此操作：在“代理设置”窗口中的计算机级别进行配置，或者更改 git 命令。

将考虑在“代理设置”窗口中配置的代理详细信息，但无需在 .gitconfig 文件中输入这些信息。

若要使用 git 命令配置代理详细信息，请按以下格式将其添加到 GIT 配置文件中：

[http "https://domain.com"] proxy = http://proxyUsername:[e-mail]:port

GIT 配置文件可在以下位置找到：

• config 文件：%ProgramData%\Git
• .gitconfig 文件：%UserProfile%
• 项目级别的本地 config 文件，例如 %UserProfile%\Desktop estproject\.git。