> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kasoftware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Git 版本控制设置

> 如何为知行之桥配置基于 Git 的版本控制。

export const cloudEnv = false;

export const siteNameShort = "知行之桥";

export const siteName = "知行之桥";

{!cloudEnv && (
<p>可以在 {siteName} 中使用<a href="../git-version-control">基于 Git 的版本控制</a>，实现配置追踪、审计追踪和环境管理。在使用之前必须安装 Git。有关说明，请参阅<a href="../git-version-control#前提条件">前提条件</a>。</p>
)}

要完成配置，请导航至**设置 > 高级 > Git 版本控制**，然后点击**配置**。

{cloudEnv ? (
<>
  <img src="/public/images/settings_git_cloud.png" alt="Git 版本控制配置窗格" width="400" />
  <p>请提供：</p>
  <ul>
    <li>远程 Git 仓库 URL。使用 SSH 时必须提供 SSH 地址，例如 <code>git@github.com:username/private-repo.git</code>。支持 GitHub、GitLab、Bitbucket 和 Azure DevOps 等主流平台。</li>
    <li>认证方案：
      <ul>
        <li>HTTPS：仓库的<strong>用户名</strong>和<strong>密码</strong>或<strong>令牌</strong>。</li>
        <li>SSH：<strong>SSH 私钥</strong>文件和<strong>密码短语</strong>。请参阅<a href="#使用-ssh-认证">使用 SSH 认证</a>。</li>
        <li>OAuth：点击<strong>获取访问令牌</strong>。</li>
      </ul>
    </li>
  </ul>
</>
) : (
<>
  <img src="/public/images/settings_git_local.png" alt="Git 版本控制配置窗格" width="400" />
  <p>选择<strong>配置类型</strong>：</p>
  <ul>
    <li><strong>远程</strong>：连接到托管 Git 仓库。提供仓库 URL 和认证方案。HTTPS 需要用户名及密码或令牌；SSH 需要私钥及密码短语；OAuth 可通过<strong>获取访问令牌</strong>完成。</li>
    <li><strong>本地</strong>：直接在 {siteNameShort} 服务器上创建独立 Git 仓库，无需远程 URL 或凭据。</li>
  </ul>
</>
)}

点击**保存**后，{siteNameShort} 会运行初始化任务：在 `AppDirectory` 内创建 Git 仓库，创建包含初始化前配置的 `settings-before-git-init-<initialization_date>` 分支，并暂存配置文件。这可避免远程仓库已有冲突内容时丢失本地配置。

页脚会变为显示本地修改数、当前分支以及远程提交数（仅远程仓库）的状态栏。远程仓库点击**提交并推送**完成初始提交；本地仓库点击**提交**。

<img src="https://mintcdn.com/qiao/ilnLy7gsSdFqbKmI/public/images/version_control_footer_toolbar.png?fit=max&auto=format&n=ilnLy7gsSdFqbKmI&q=85&s=3bb76694d52f283ecb33cd14f02f16aa" alt="Git 版本控制页脚工具栏" width="800" data-path="public/images/version_control_footer_toolbar.png" />

## 使用 SSH 认证

* 运行 `ls -al ~/.ssh` 检查现有 SSH 密钥。
* 如需新密钥，运行 `ssh-keygen -t ed25519 -C "your_email@example.com"`。
* 可为密钥添加密码短语。
* 在 **SSH 私钥**字段上传私钥。
* 将公钥添加到 Git 平台。

## 删除 Git 配置

点击设置面板上的垃圾桶图标，然后选择**Git 仓库选项**：

* **保留底层仓库**：{siteNameShort} 断开仓库连接，但磁盘上的 `.git` 文件夹保持不变，仍可使用服务器上的 Git 工具直接操作。
* **删除底层仓库**：删除 `.git` 文件夹，完全禁用该安装的版本控制。所有暂存但未提交的更改都会永久丢失。

使用本地仓库时，选择保留底层仓库可以保存提交历史，之后可重新连接或[迁移到远程仓库](../git-version-control#从本地仓库迁移到远程仓库)。

删除配置后，可随时点击**配置**重新设置版本控制。