Skip to main content

Git 管理

CloudStudio 社区版支持通过 CNB.cool、GitHub 等第三方代码托管平台进行 Git 管理，提供「命令行」和「图形化界面」两种操作方式，适配不同用户习惯。本文将从身份配置、平台流程、可视化操作到插件管理，全面讲解代码版本控制与协作方法。

一、前置准备：配置Git身份（必做）​

所有Git操作（提交、推送）需先配置身份，否则无法推送代码到仓库。

（一）配置用户名和邮箱（核心）​

  • ​作用​：Git 通过用户名和邮箱识别操作者，邮箱必须与 GitHub / CNB.cool 账户绑定，否则推送会失败。
  • ​命令​（在终端执行）： 
    git config --global user.name "你的用户名"  # 替换为平台用户名
    git config --global user.email "你的邮箱"   # 替换为平台绑定邮箱

注意：若未配置，只能克隆公开仓库，无法推送；若配置错误，重新执行命令覆盖即可。

（二）配置SSH密钥（可选，推荐）​

  • ​作用​：免密登录，避免每次推送输入密码。
  • ​步骤​： 
    # 1. 生成密钥（邮箱替换为平台绑定邮箱）：
    ssh-keygen -t ed25519 -C "你的邮箱"

    # 2. 复制公钥（默认路径 `~/.ssh/id_ed25519.pub`）：
    cat ~/.ssh/id_ed25519.pub

    # 3. 将公钥添加到平台：GitHub（设置 -> SSH 和 GPG 密钥 -> 新建）、CNB.cool（类似路径）。

二、代码管理流程（GitHub / CNB.cool 通用）​

GitHub 作为主流托管平台，操作流程涵盖「克隆、提交、推送、拉取」，支持公开仓库和自有私密仓库（需权限）。

（一）克隆仓库（下载远程代码到本地）​

  • 公开仓库​：无需身份验证，直接克隆。
  • ​私有仓库​：需配置用户名/邮箱，否则可能失败。
  • ​命令​：
    • HTTPS协议（需手动输密码）： 
      git clone https://github.com/用户名/仓库名.git  # GitHub
      git clone https://cnb.cool/用户名/仓库名.git    # CNB.cool
    • SSH协议（免密，推荐）： 
      git clone git@github.com:用户名/仓库名.git      # GitHub
      git clone git@cnb.cool:用户名/仓库名.git        # CNB.cool

（二）提交代码变更（本地 → 远程）​

  • 适用场景​：你是仓库所有者或协作者，且已配置用户名/邮箱。​
  • 步骤​： 
    # 1. 添加所有变更文件到暂存区（. 表示当前目录下所有变更，也可指定单个文件路径）
    git add .

    # 2. 提交到本地仓库（引号内为提交说明，需清晰描述变更内容，如修复bug、新增功能）
    git commit -m "fix: 修复登录页面验证码不显示问题"

    # 3. 推送到 GitHub 远程仓库（main 为分支名，若使用其他分支需替换，如 dev）
    git push origin main

（三）拉取远程更新（远程→本地）​

  • ​适用场景​：远程仓库有他人更新，需同步到本地避免冲突。 ​- 命令​： 
    git pull origin main  # main为分支名，根据实际情况替换

三、图形化操作（无需记命令）​

通过 CloudStudio 左侧工具栏的「源代码管理」插件（分支图标）操作，步骤更直观

（一）查看代码变更​

插件面板自动显示修改过的文件：

  • ​红色​：文件内容删除。
  • 绿色​：文件内容新增。
  • 点击文件可查看具体变更内容。

（二）提交代码到本地​

  • 在插件面板的 「消息」 输入框中，填写提交说明（如 fix: 修复支付回调bug）；
  • 点击输入框上方的 「√ Commit」 按钮，即可完成本地提交（等效于 git add . + git commit -m）。

（三）拉取 / 推送代码到远程​

  • 点击插件面板右上角的 「...」 按钮，打开操作菜单；
  • 根据需求选择 「拉取」（同步远程更新到本地，等效于 git pull）或 「推送」（同步本地提交到远程，等效于 git push）。

（四）分支管理（创建 / 切换分支）​

  • 点击 ​​「...」​​ → 选择 ​​「分支」​​：
    • ​创建分支​：输入新分支名（如 dev-01），基于当前分支创建。
    • ​切换分支​：选择已有分支名直接切换。分支创建新分支；

五、Git 插件管理（进阶）​

（一）移除 Git 版本控制（重置）​

若需删除本地 Git 配置（如重新初始化仓库）：

rm -rf /workspace/.git  # 终端执行，删除后需重新初始化Git

（二）拉取代码的IP白名单​

若企业/私有仓库限制IP访问，需将以下出口IP添加到仓库白名单：

170.106.177.233、170.106.81.114、170.106.81.79、170.106.98.28、170.106.98.49、
170.106.101.94、170.106.98.140、49.51.250.101、170.106.64.252、49.51.245.168、
119.28.57.131、101.32.186.217、119.28.87.241、150.158.189.73、122.51.180.75、
115.159.212.202、1.117.68.9、124.223.90.145、110.42.134.33、121.5.15.55、
101.34.88.6、49.235.148.104、106.54.57.182

按此流程操作，即可在 CloudStudio 中高效管理 GitHub / CNB.cool 仓库的代码版本与协作！