一、概述
Git 集成包含三个层级：
1. 工作空间级 Git 连接 ：管理员配置工作空间到远程 Git 仓库的连接（包括公网或私网联通方式）。详见 设置 Git 连接。
2. 个人级 Git 配置 ：每位用户在个人设置中绑定自己的 Git 账号 Email 与访问 Token。
3. GitFolder 操作 ：在 Studio 开发目录中创建 Git 文件夹，文件夹内文件与远程仓库分支同步。
完成上述配置后，你可在 Studio 左侧 Git 源代码管理 面板执行 commit / push / pull / merge / rebase 等标准 Git 操作。
二、前提条件
·工作空间已配置 Git 连接（仓库地址、Git 服务提供商、分支、网络环境）。详见 设置 Git 连接。
·你是工作空间成员，并具备 Studio 模块访问权限。
·你持有目标 Git 仓库的访问凭证（个人 Email 与 Personal Access Token）。
三、步骤 1：完成个人 Git 配置
1. 进入 工作空间 > Git 账户，页面会展示工作空间已配置的 Git 仓库地址、提供商和分支（不可在个人设置中修改）。
2. 在「个人 Email」「个人 Token」字段填入：
·个人 Email ：与你 Git 平台账号一致的邮箱。
·个人 Token ：从 Git 平台生成的 Personal Access Token，需具备目标仓库的读写权限。
3. 单击 开始网络联通性测试 ，系统使用 Serverless 资源组验证你的账号是否可以访问远程仓库。
4. 验证通过后单击 保存 。
注意：个人 Token 仅在保存时使用，并以加密形式存储。请勿在文档、聊天记录中明文分享 Token。
四、步骤 2：在开发目录中创建 Git 文件夹
1. 完成工作空间 Git 连接后，Studio 左侧 开发目录 中可以创建 Git 文件夹 。
2. Git 文件夹的内容自动与远程仓库的默认分支同步。
3. 在 Git 文件夹中可以创建子文件夹、Notebook、SQL 等文件。
4. 如未完成个人 Git 配置：
·创建 Git 文件夹时 Git 仓库地址呈禁用态，hover 提示「请先完善个人 Git 权限配置」。
·单击提示中的跳转链接进入个人设置页面继续配置。
五、步骤 3：在 Git 文件夹中创建文件
1. 在 Git 文件夹操作中选择 创建 > 文件夹 / Notebook / SQL/ 文件 。
2. 输入名称，单击 确定 。新建对象出现在 Git 文件夹下，但 尚未提交到远程 。
六、4.1 进入 Git 源代码管理面板
1. 在 Studio 最左侧侧栏单击 Git 源代码管理 图标。
2. 面板顶部展示当前所在分支（如 main、feature/abc）。
七、4.2 提交（commit）
1. 面板中「变更」区域展示有变化的文件，文件名旁会显示状态标识，例如：
·U （Untracked）：尚未添加到 Git 索引。
·A （Added）：已暂存，待提交。
·M （Modified）：已修改，待暂存或提交。
1. 在每个文件前勾选复选框确认要提交的文件，或单击 全选 。
2. 在顶部 变更描述 输入框填写本次提交说明。
3. 单击 提交 。
八、4.3 推送（push）
1. 完成 commit 后，单击面板顶部 推送 。
2. 系统将本地分支推送到远程仓库。
3. 如果远程仓库存在新提交，会提示先 pull 合并。
九、4.4 拉取（pull）
1. 单击面板顶部 拉取 。
2. 系统从远程仓库拉取最新内容。如果存在合并冲突，会进入冲突解决流程（步骤 4.7）。
十、4.5 切换、创建分支
1. 单击当前分支名展开下拉。
2. 在搜索框中输入分支名：
·选择已有分支：直接切换。
·单击 + 创建新分支 ：基于当前分支创建。
十一、4.8 查看历史记录
1. 单击 Git 面板底部 GRAPH 。
2. 列表展示当前分支的提交历史，包括：提交人、提交时间、变更描述。
3. 单击单次提交可查看对应文件 diff。
十二、个人 Git 配置参数
| 参数 | 说明 | 是否必填 | 默认值 |
| 个人 Email | 与 Git 平台账号一致的邮箱，用作 commit 作者。 | 是 | 无 |
| 个人 Token | Git 平台 Personal Access Token，须有目标仓库读写权限。 | 是 | 无 |
十三、文件状态标识
| 标识 | 含义 |
| U | Untracked，尚未加入 Git 索引 |
| A | Added，已暂存待提交 |
| M | Modified，已修改 |
| D | Deleted，已删除 |
| C | Conflict，存在合并冲突 |
十四、使用限制
·Git 文件夹下的文件不支持文件 ACL 单独授权，所有项目成员默认拥有管理权限。详见 文件权限。
·单次 commit 文件数量与单文件大小受 Git 平台与底层服务限制；建议保持单文件小于 10 MB。
·Git 文件夹文件被修改后，本地修改与远程版本可能不一致；请定期 commit & push 避免冲突。
·不同工作空间的 Git 配置相互独立，无法跨空间共享。
十五、常见问题
Q1：测试联通性失败「authentication failed」？
·检查 Personal Access Token 是否过期。
·确认 Token 具备目标仓库的 read_repository / write_repository 权限。
·私有网络模式下确认终端节点服务 ID 配置正确，详见 设置 Git 连接。
Q2：commit 时文件没出现在变更列表？
·确认文件位于 Git 文件夹下，本地文件夹下的修改不会进入 Git。
·检查文件是否在 .gitignore 中被排除。
·单击 Git 面板的 刷新 按钮重新扫描变更。
Q3：push 时提示「rejected: non-fast-forward」？
远程仓库已有新提交。先单击 拉取 合并远程更新，解决潜在冲突后再 push。
Q4：误删的文件还能找回吗？
·如果尚未 commit：在 Git 面板「变更」区域单击文件 → 撤销变更 即可恢复。
·如果已 commit & push：在 Git 平台上找到对应提交执行 revert，或从历史版本中切回上一次提交。
Q5：是否支持 SSH key 认证？
当前版本仅支持 Personal Access Token 认证。
十六、相关文档
·IDE 界面、项目与文件组织
·文件权限
·设置 Git 连接
·CI/CD 概述