You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Bitrise CLI在本地克隆GitHub托管的项目?

使用Bitrise CLI克隆GitHub项目的完整步骤

我来帮你搞定这个问题——Bitrise CLI本身是依赖Git来处理代码克隆的,所以核心是先确保本地环境配置好GitHub的访问权限,再通过Bitrise的流程完成关联。下面是一步步的实操指南:

1. 先搞定本地Git与GitHub的权限配置

Bitrise CLI不会单独处理认证,完全依赖你本地Git的配置,所以这一步是基础:

  • 先确认Git已安装:在终端运行 git --version,能输出版本号就没问题,没安装的话先补装Git。
  • 配置GitHub身份验证(二选一即可):
    • SSH密钥方式(推荐,更安全):
      在终端执行 ssh-keygen -t ed25519 -C "你的GitHub绑定邮箱",一路回车默认生成密钥;然后打开~/.ssh/id_ed25519.pub文件,复制里面的全部内容,到GitHub账户的「Settings → SSH and GPG keys」页面添加新的SSH密钥。
    • HTTPS个人访问令牌(PAT)方式:
      到GitHub的「Settings → Developer settings → Personal access tokens」生成一个新令牌,勾选repo权限;之后克隆仓库时,用户名填你的GitHub账号,密码就填这个PAT。

2. 通过Bitrise CLI初始化并克隆项目

打开终端,按以下步骤操作:

  • 切换到你想存放项目的目录,比如 cd ~/MyProjects
  • 运行 bitrise init,跟着提示走:
    1. 选择「我已经有一个代码仓库,想要配置它」的选项;
    2. 输入你的GitHub仓库克隆地址(SSH格式如git@github.com:你的用户名/仓库名.git,或HTTPS格式如https://github.com/你的用户名/仓库名.git);
    3. 接下来Bitrise会自动调用Git克隆仓库到本地,同时生成项目所需的bitrise.yml配置文件。

3. 若初始化克隆失败,手动克隆后再关联

如果bitrise init时克隆出错(比如网络问题或权限未生效),可以先手动克隆再关联:

  • 先手动用Git克隆项目:git clone git@github.com:你的用户名/仓库名.git(或对应的HTTPS地址)
  • 进入克隆后的项目目录:cd 仓库名
  • 再运行 bitrise init,选择「当前目录就是我的代码仓库」,Bitrise会直接在现有项目里生成配置文件,完成关联。

4. 验证克隆是否成功

克隆完成后,你可以运行 bitrise run primary(这是Bitrise默认的工作流),如果能正常启动构建流程,就说明Bitrise已经能正确访问本地的代码仓库了。

额外注意事项

  • 确保你的Bitrise CLI是最新版本:运行 bitrise update 可以一键更新到最新版,避免版本兼容问题;
  • 用SSH方式的话,别忘了把密钥加入ssh-agent:执行 ssh-add ~/.ssh/id_ed25519,否则可能出现SSH认证失败;
  • 如果是私有仓库,一定要确认你用的认证方式(SSH密钥或PAT)拥有该仓库的访问权限。

内容的提问来源于stack exchange,提问作者BXV

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.28 09:33:25