serejaris glab repo
管理 GitLab 仓库和项目。
快速入门
# Clone a repository
glab repo clone group/project
# Create new repository
glab repo create my-new-project --public
# Fork a repository
glab repo fork upstream/project
# View repository details
glab repo view
# Search for repositories
glab repo search "keyword"
常用工作流
创建新项目
创建仓库：
glab repo create my-project \ --public \ --description "My awesome project"克隆到本地：
glab repo clone my-username/my-project cd my-project初始化内容：
echo "# My Project" > README.md git add README.md git commit -m "Initial commit" git push -u origin main
Fork 工作流
Fork 上游仓库：
glab repo fork upstream-group/project克隆你的 Fork：
glab repo clone my-username/project cd project添加上游远程仓库：
git remote add upstream https://gitlab.com/upstream-group/project.git保持 Fork 同步：
git fetch upstream git merge upstream/main
自动同步：
使用同步脚本一键更新 Fork：
scripts/sync-fork.sh main
scripts/sync-fork.sh develop upstream
该脚本自动完成：拉取 → 合并 → 推送到 origin。
仓库管理
查看仓库信息：
glab repo view
glab repo view group/project # Specific repo
glab repo view --web # Open in browser
更新仓库设置：
glab repo update \
--description "Updated description" \
--default-branch develop
归档仓库：
glab repo archive download main # Downloads .tar.gz
glab repo archive download main --format zip
转移到新命名空间：
glab repo transfer my-project --target-namespace new-group
删除仓库：
glab repo delete group/project
成员管理
列出协作者：
glab repo members list
添加成员：
glab repo members add @username --access-level maintainer
移除成员：
glab repo members remove @username
更新成员权限：
glab repo members update @username --access-level developer
批量操作
克隆群组中所有仓库：
glab repo clone -g my-group
搜索并克隆：
glab repo search "api" --per-page 10
# Then clone specific result
glab repo clone group/api-project
列出你的仓库：
glab repo list
glab repo list --member # Only where you're a member
glab repo list --mine # Only repos you own
故障排除
克隆失败（权限错误）：
- 验证是否有访问权限：
glab repo view group/project - 检查认证状态：
glab auth status - 对于私有仓库，确保使用正确的账户登录
Fork 操作失败：
- 检查你的命名空间中是否已存在相同的 Fork
- 确认你有 Fork 权限（部分仓库禁用了 Fork 功能）
- 尝试指定路径：
glab repo fork --fork-path username/new-name
转移失败：
- 确认你有 Owner/Maintainer 权限
- 检查目标命名空间是否存在且你有创建权限
- 部分项目可能启用了转移保护
群组克隆失败：
- 确认群组存在且你有访问权限
- 检查是否有足够的磁盘空间
- 大型群组可能会超时 —— 建议逐个克隆特定仓库
相关技能
认证与访问：
- 参见
glab-auth了解登录和认证设置 - 参见
glab-ssh-key了解 SSH 密钥管理 - 参见
glab-deploy-key了解部署认证
项目配置：
- 参见
glab-config了解 CLI 默认设置 - 参见
glab-variable了解 CI/CD 变量
Fork 同步：
- 脚本：
scripts/sync-fork.sh自动化上游同步
命令参考
完整的命令文档和所有参数请参见 references/commands.md。
可用命令：
clone- 克隆仓库或群组create- 创建新项目fork- Fork 仓库view- 查看项目详情update- 更新项目设置delete- 删除项目search- 搜索项目list- 列出仓库transfer- 转移到新命名空间archive- 下载仓库归档contributors- 列出贡献者members- 管理项目成员mirror- 配置仓库镜像publish- 发布项目资源