本文介绍如何在工作空间中配置 Git 仓库连接和个人 Git 账户。Git 连接配置完成后，您即可在 Studio 中创建 Git 文件夹（GitFolder），将代码文件托管到远程 Git 仓库进行版本管理。
概述
Git 连接由 工作空间级 Git 连接 与 用户级 Git 账户 两部分组成：
Git 连接（工作空间级） ：由空间管理员配置，定义本工作空间允许使用的 Git 仓库地址。一个工作空间支持配置 多个 Git 连接 ，对应多个不同 Git 仓库。
Git 账户（用户级） ：每个用户单独配置自己的 Git 凭据（Token），用于在创建 GitFolder 时拉取与提交代码。一个 Git 连接对应一个 Git 账户。
提示
工作空间级 Git 连接、用户级 Git 账户 + Studio 中的 GitFolder 三者关系：
一个工作空间可绑定多个远程 Git 仓库地址；
每个用户为每个 Git 仓库配置自己的认证凭据；
在 Studio 中创建 Git 文件夹时，选择某个仓库地址，本地 Git 仓库与远程 Git 仓库建立连接。
前提条件
配置 Git 连接：您需要是 空间管理员 或拥有 Git 连接管理权限的自定义角色。
配置 Git 账户：每个工作空间成员均可为自己配置 Git 账户。
远程 Git 仓库已创建并对当前用户开放访问，用户已生成可用的 Personal Access Token（PAT）。
配置工作空间级 Git 连接
添加 Git 连接
1. 进入目标工作空间，在左侧导航栏选择 工作空间设置 > Git 连接 。
2. 单击添加连接 。
3. 在弹出窗口中填写：
参数 | 说明 | 是否必填 | 默认值 |
Git 仓库地址 | 远程 Git 仓库的 HTTPS 地址，例如 https://github.com/your-org/your-repo.git | 是 | - |
Git 服务提供商 | 选择对应的 Git 服务商：GitHub、GitLab、Azure DevOps 等 | 是 | - |
Git 分支 | 该仓库的默认分支名（在 Studio 中创建 Git 文件夹时使用），如 main、master、dev | 是 | - |
Git 仓库网络环境 | 选择 Git 仓库的网络访问方式：公网访问 或 私有网络 。公网访问适用于可直接通过公网连接的仓库；私有网络适用于部署在内网的自建 Git 服务（如内网 GitLab 等） | 是 | 公网访问 |
1. 如果选择了 公网访问 ，需要完成以下两步网络配置：
2. 初始化网络配置 ：点击 初始化网络配置 按钮，DataBuddy 将自动为当前工作空间配置访问公网 Git 仓库所需的网络通道。
3. 网络连通性测试 ：初始化完成后，点击 网络连通性测试 按钮，验证 DataBuddy 是否能够正常访问目标 Git 仓库地址。测试通过后方可保存。
注意
私有网络模式下，需要通过终端节点服务将目标 Git 仓库所在网络与 DataBuddy 的网络环境进行打通，否则连通性测试将失败。
1. 单击添加 保存。
移除 Git 连接
在 Git 连接 列表中点击操作列的移除。
注意
移除 Git 连接前，请确认该连接没有被任何 Git 文件夹引用，否则相关文件夹的 push / pull 操作会失败。
配置用户级 Git 账户
每个用户都需要为工作空间内的每个 Git 连接单独配置自己的认证信息。该配置仅对当前用户生效。
添加 Git 账户
1. 在目标工作空间中，进入 工作空间设置 > Git 账户 。
2. 您会看到工作空间内已配置的 Git 连接列表，每条连接需要配置一个对应的 Git 账户。
3. 点击某条 Git 连接操作列的 编辑 按钮。
4. 填写认证信息：
参数 | 说明 | 是否必填 |
授权类型 | 当前支持 Personal Access Token（PAT） | 是 |
Email | 您 Git 提供商中提交 Git 的邮箱信息 | 是 |
Token | 您在 Git 平台生成的访问令牌，需具备读写仓库的权限 | 是 |
1. 网络连通性测试通过之后单击保存 。
修改 Git 账户
点击对应 Git 连接的编辑 图标，更新 Email 或 Token。
提示
PAT 在 Git 平台过期或被吊销后，对应的 push / pull 操作会失败。请定期刷新 Token 并在此处更新。
在 Studio 中使用 Git 连接
完成 Git 连接 + Git 账户 配置后，您可以在 Studio 中创建 Git 文件夹：
1. 在 Studio 左侧文件树的 GitFolder 区域点击 创建 > Git 文件夹 。
2. 输入文件夹名称，选择已配置的 Git 仓库地址。
3. （可选）启用 稀疏检出模式 ，仅克隆仓库中指定的文件路径，避免一次性拉取过多文件。
4. 系统将远程仓库克隆到该 Git 文件夹中，您即可开始提交、推送、拉取等 Git 操作。
详细操作请参见 Git 初始化配置 / GitFolder 创建。
使用限制
HTTPS 协议 ：当前仅支持 HTTPS 形式的 Git 仓库地址。
认证方式 ：当前仅支持 Personal Access Token，暂不支持 SSH Key 认证或 OAuth 账号关联。
稀疏检出推荐 ：当远程仓库文件数量较多时，推荐启用稀疏检出，每个 Git 文件夹的克隆操作仍受 Studio 整体配额（最多 2 万个文件）影响。
每个 Git 文件夹绑定单一仓库 ：一个 Git 文件夹绑定一个 Git 连接（即一个远程仓库地址）；如需在同一空间使用多个仓库，请创建多个 Git 文件夹。
常见问题
Q1：保存 Git 账户后，仍然提示无权限拉取代码？
请检查 Token 是否具备
repo / write_repository 等读写权限，并确认 Token 在 Git 平台没有过期或被吊销。Q2：能否多人共享同一个 Git 账户？
不建议。DataBuddy 中的 Git 账户是用户级配置，每个用户使用自己的 Token 进行操作，便于在远程 Git 仓库中追溯代码作者。
Q3：删除 Git 连接后，原 Git 文件夹中的代码会丢失吗？
本地 Git 文件夹中的代码不会被删除，但与远程仓库的连接会断开，无法 push / pull。如果需要继续使用，请重新创建 Git 连接和 Git 账户。
相关文档
Git 初始化配置 / GitFolder 创建
