GeekIt

glab(GitLab CLI)命令速查

登录认证、仓库与 Issue、MR 全流程、CI 流水线与作业、Release 与变量、API 直调与报错排查等 150 条命令

共 150 条命令 · 9 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
glab --version查看版本,新命令在旧版可能不存在
glab --help查看全部子命令
brew install glabmacOS 安装
apt install glabDebian/Ubuntu 安装
dnf install glabRHEL/Fedora 安装
go install gitlab.com/gitlab-org/cli/cmd/glab@latestGo 安装,可拿最新特性
glab auth login交互式登录,会引导选择 token 或浏览器授权
glab auth login --hostname gitlab.example.com --token <token>自建实例必须指定 hostname,CI 中常用
glab auth status查看当前登录的主机与账号
glab auth logout退出登录,换账号前先执行
glab config get editor查看配置项
glab config set editor vim修改配置,当前仓库生效
glab config set -g editor vim全局配置,-g 表示所有仓库
export GITLAB_TOKEN=<token>CI 中用环境变量注入,避免落盘
export GITLAB_HOST=gitlab.example.com固定默认实例,省去每次指定
glab completion bash > /etc/bash_completion.d/glab开启补全,子命令多时很实用
token 权限至少要 api只给 read_api 时无法创建 MR 与评论
命令 / 片段说明复制
glab repo clone group/project按路径克隆,自动补全完整 URL
glab repo clone https://gitlab.example.com/group/project.git直接给完整地址
glab repo view在当前仓库查看项目信息
glab repo view --web浏览器打开项目页
glab repo view group/project不进入目录也能查看
glab repo forkFork 当前仓库到自己的空间
glab repo fork --cloneFork 后直接克隆到本地
glab repo create my-project在 GitLab 上创建新项目
glab repo create --private创建私有项目
glab repo list列出有权限的项目
glab repo list --member只列出自己参与的项目
glab repo archive导出仓库归档(视版本支持)
glab repo members查看项目成员与权限
glab repo contributors查看贡献者统计
clone 后确认 origin 指向正确实例多实例环境最容易出错的地方
命令 / 片段说明复制
glab issue list列出当前项目的 Issue
glab issue list --assignee @me只看指派给自己的
glab issue list --author @me只看自己提的
glab issue list --label bug --state opened按标签与状态过滤
glab issue list --search "关键词"按关键字搜索标题与描述
glab issue list --closed查看已关闭的 Issue
glab issue view 123查看 Issue 详情与评论
glab issue view 123 --web浏览器打开
glab issue view 123 --comments连评论一起显示(视版本)
glab issue create交互式创建,会引导填标题与描述
glab issue create -t "登录失败" -d "复现步骤..." -l bug -a ops一次指定标题、描述、标签与指派
glab issue note 123 -m "已定位,稍后修复"添加评论
glab issue close 123关闭 Issue
glab issue reopen 123重新打开
glab issue update 123 --label bug,urgent批量改标签
glab issue update 123 --assignee @me指给自己
glab issue subscribe 123订阅通知
glab issue board view打开看板视图(视版本支持)
命令 / 片段说明复制
glab mr list列出开放的 MR
glab mr list --assignee @me只看指派给自己的评审
glab mr list --reviewer @me只看等待自己评审的
glab mr list --source-branch feature/login按源分支过滤
glab mr view 45查看 MR 详情、审批状态与流水线
glab mr view 45 --web浏览器打开 MR
glab mr create交互式创建 MR
glab mr create --fill --yes用提交信息自动填充标题与描述
glab mr create --title "feat: 登录优化" --description "改动说明" --target-branch main完整参数创建
glab mr create --draft创建草稿 MR,尚未完成时用
glab mr create --squash-before-merge --remove-source-branch约定合并方式,减少手工操作
glab mr create --source-branch feature/x --target-branch develop指定源与目标分支
glab mr checkout 45拉取并切换到 MR 分支,评审时本地验证
glab mr diff 45命令行看完整 diff
glab mr note 45 -m "LGTM,建议补充单测"添加评审评论
glab mr approve 45批准 MR
glab mr merge 45合并 MR
glab mr merge 45 --squash --remove-source-branch压缩提交并删除源分支
glab mr merge 45 --when-pipeline-succeeds流水线通过后再合并,最安全
glab mr update 45 --ready把草稿 MR 标记为可评审
glab mr update 45 --draft改回草稿状态
glab mr rebase 45触发 rebase,冲突需本地解决
glab mr close 45关闭 MR,不合并
glab mr reopen 45重新打开
glab mr todo 45加入待办,评审队列管理用
glab mr subscribe 45订阅变更通知
mr 编号即 URL 末尾数字脚本里可直接从链接提取
命令 / 片段说明复制
glab ci view查看当前分支最近的流水线状态
glab ci view --web浏览器打开流水线页面
glab ci list列出流水线历史
glab ci status查看当前流水线各阶段状态
glab ci status --live实时刷新,盯构建时用
glab ci trace <job-id>跟踪作业日志,类似 tail -f
glab ci trace不带参数时交互选择作业
glab ci run为当前分支触发流水线
glab ci run --branch main指定分支触发
glab ci run -v KEY=value触发时传变量
glab ci retry <job-id>重试单个作业,失败排查利器
glab ci cancel <pipeline-id>取消流水线
glab ci lint .gitlab-ci.yml本地校验 CI 语法,提交前先跑
glab ci lint --ref main按目标分支上下文校验
glab job artifact <ref> <job-name>下载作业产物,定位构建问题
glab pipeline listpipeline 是 ci 的别名,用法一致
glab ci delete <pipeline-id>删除流水线记录
CI 中 glab 需 token 与 hostname否则会默认指向 gitlab.com
命令 / 片段说明复制
glab release list列出发布版本
glab release view v1.2.0查看某个版本的说明与产物
glab release create v1.2.0 --notes "本次变更..."创建发布并写说明
glab release create v1.2.0 --notes-file CHANGELOG.md说明从文件读,避免手写出错
glab release create v1.2.0 --ref main指定打标签的提交
glab release delete v1.2.0删除发布(标签可能保留)
glab label list列出项目标签
glab label create --name urgent --color "#FF0000"创建标签,统一项目规范
glab variable list列出 CI/CD 变量
glab variable set DB_PASS "xxx" --masked设置变量并掩码,避免明文入日志
glab variable set TOKEN "xxx" --protected只在受保护分支可用
glab variable get DB_PASS查看变量值(需权限)
glab variable delete DB_PASS删除变量
glab snippet create -f script.sh -t "脚本"创建代码片段,便于共享
glab ssh-key add ~/.ssh/id_ed25519.pub -t "laptop"上传 SSH 公钥到 GitLab
glab user events查看自己的活动记录(视版本)
glab alias set co "mr checkout"设置命令别名,减少重复输入
glab alias list查看已设置的别名
命令 / 片段说明复制
glab api projects/:id/merge_requests直接调 REST API,:id 可用路径或数字
glab api projects/group%2Fproject/merge_requests?state=opened路径要 URL 编码
glab api --method POST projects/:id/issues -f title="新问题"POST 提交表单字段
glab api --method PUT projects/:id/issues/1 -f state_event=close更新资源状态
glab api --method DELETE projects/:id/issues/1删除资源
glab api --paginate projects/:id/merge_requests自动翻页,导出全量数据必加
glab api projects/:id/pipelines | jq ".[] | {id,status,ref}"配合 jq 提取字段
glab api projects/:id/repository/commits | jq -r ".[].short_id"导出提交列表
glab api --hostname gitlab.example.com projects/:id对指定实例调用
glab api --help查看分页、字段、header 等参数
glab api graphql -f query="..."调用 GraphQL(视版本支持)
复杂逻辑建议脚本 + glab api比在 shell 里拼一长串参数可维护
命令 / 片段说明复制
git checkout -b feature/x && git push -u origin feature/x先建分支推送,再用 glab 创建 MR
glab mr create --fill --yes --target-branch main一条命令开出规范 MR
glab ci status --live盯流水线直到通过
glab mr merge <id> --when-pipeline-succeeds --squash --remove-source-branch流水线通过后自动合并并清理分支
glab mr checkout <id> && git log --oneline -5评审时本地验证改动
glab issue list --assignee @me --label bug每天开工先看自己的缺陷队列
glab ci lint .gitlab-ci.yml && git push提交前先本地校验 CI 配置
glab variable list | grep -i token排查 CI 变量缺失导致的构建失败
glab release create v$(date +%Y.%m.%d) --notes-file CHANGELOG.md按日期自动打发布
for id in $(glab mr list --assignee @me -F json | jq -r ".[].iid"); do glab mr view $id; done批量查看待评审 MR
命令 / 片段说明复制
glab: command not found未安装或不在 PATH
401 Unauthorizedtoken 失效或无权限,重新 auth login
403 Forbidden / insufficient scopetoken 缺 api 或 write_repository 权限
404 Project Not Found路径写错、无权限或实例不对
not a git repository需在仓库目录内执行,或显式指定 repo
no merge request found编号或分支写错,用 mr list 核对
pipeline not found分支尚未触发过流水线
x509: certificate signed by unknown authority自签证书,把 CA 加入系统信任库
clone 报 SSL certificate problem设置 GIT_SSL_CAINFO 指向内部 CA
glab 指向了 gitlab.com未指定 hostname,补 --hostname 或设 GITLAB_HOST
ci trace 卡住不动作业还在排队或已结束,用 ci status 确认
mr create 提示没有 remote先 git remote add origin 或确认 origin 正确
Windows 下 ssh-key add 失败检查 key 路径与权限,必要时用文件管理器导入
api 返回分页不完整加 --paginate 自动翻页
配置文件位置~/.config/glab-cli/config.yml,可查当前 host 与 token 状态

运维常用组合

提 MR 到合并git push -u origin feature/x → glab mr create --fill --yes → glab ci status --live → glab mr merge <id> --when-pipeline-succeeds --squash --remove-source-branch
评审别人代码glab mr list --reviewer @me → glab mr checkout <id> → 本地跑测试 → glab mr diff <id> → glab mr approve <id> → glab mr note <id> -m "LGTM"
排查流水线失败glab ci view → glab ci status → glab ci trace <job-id> → glab job artifact <ref> <job> → glab ci retry <job-id>
CI 变量维护glab variable list → glab variable set DEPLOY_KEY "xxx" --masked --protected → glab variable get DEPLOY_KEY
批量导出 MRglab api --paginate projects/:id/merge_requests?state=merged | jq -r ".[] | [.iid,.title,.author.name] | @tsv"
本地校验 CIglab ci lint .gitlab-ci.yml → 修正 → git push,避免推送后才发现语法错误

实战要点

1. 多实例先定 hostname

自建 GitLab 必须显式指定 hostname 或设 GITLAB_HOST,否则默认打 gitlab.com

2. token 要 api 权限

只读 token 无法创建 MR 与评论,401/403 先查 scope

3. --fill 省一半功夫

标题与描述直接从提交信息生成,规范又能少打字

4. 合并加流水线门禁

--when-pipeline-succeeds 能避免误合并失败构建

5. ci lint 提交前跑

CI 配置语法错误在本地就能发现,不用等流水线

6. 复杂查询走 api + jq

glab api 支持分页与字段,比在网页上翻页高效得多

共 150 条 glab 命令 · 示例中的实例地址、项目路径与编号请替换为实际环境

关于glab(GitLab CLI)命令速查

在线 glab(GitLab CLI)命令速查手册,按安装与登录、仓库操作、Issue 管理、Merge Request 全流程、CI 流水线与作业、Release 与标签、变量与密钥、API 直调与别名、工作流组合、常见报错与排查等 10 类场景整理 150 条常用命令与参数组合,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 glab --version 与 brew/apt/dnf/go install 与 shell 补全、glab auth login 与 --hostname --token 与 auth status/logout 与 glab config set/get 与 GITLAB_TOKEN、repo clone/view/fork/create/list 与 --web、issue list 的 --assignee @me/--label/--state 与 issue view/create/note/close/reopen/update/subscribe、mr list/view/create 的 --fill/--title/--description/--draft/--source-branch/--target-branch/--squash-before-merge/--remove-source-branch/--yes 与 mr checkout/diff/approve/merge/note/close/reopen/rebase/update --ready/todo、ci view/list/status/trace/run/retry/cancel/lint 与 job artifact 与 pipeline 别名、release list/create/view/delete 与 label 与 variable list/set/get/delete 与 snippet 与 ssh-key add、glab api 的 projects/:id/merge_requests 与 --paginate 与 jq 组合与 glab alias set,以及 command not found、401 Unauthorized、token 权限不足(需 api/write_repository)、project not found、not a git repository、no merge request found、pipeline not found、自签证书 CA 问题、Windows 下 SSH key 权限 等报错排查。适用于命令行内完成 MR 创建与评审、流水线状态跟踪与失败重试、Issue 批量处理、发布与 CI 变量管理、GitLab API 自动化与脚本封装,以及研发、运维与 SRE 日常协作与面试复习。

核心能力

  • 涵盖 glab --version 与 brew/apt/dnf/go install 与 shell 补全、glab auth login 与 --hostname --token 与 auth status/logout 与 glab config set/get 与 GITLAB_TOKEN、repo clone/view/fork/create/list 与 --web、issue list 的 --assignee @me/--label/--state 与 issue view/create/note/close/reopen/update/subscribe、mr list/view/create 的 --fill/--title/--description/--draft/--source-branch/--target-branch/--squash-before-merge/--remove-source-branch/--yes 与 mr checkout/diff/approve/merge/note/close/reopen/rebase/update --ready/todo、ci view/list/status/trace/run/retry/cancel/lint 与 job artifact 与 pipeline 别名、release list/create/view/delete 与 label 与 variable list/set/get/delete 与 snippet 与 ssh-key add、glab api 的 projects/:id/merge_requests 与 --paginate 与 jq 组合与 glab alias set,以及 command not found、401 Unauthorized、token 权限不足(需 api/write_repository)、project not found、not a git repository、no merge request found、pipeline not found、自签证书 CA 问题、Windows 下 SSH key 权限 等报错排查

适用场景

适用于命令行内完成 MR 创建与评审、流水线状态跟踪与失败重试、Issue 批量处理、发布与 CI 变量管理、GitLab API 自动化与脚本封装,以及研发、运维与 SRE 日常协作与面试复习。glab(GitLab CLI)命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

glab(GitLab CLI)命令速查是免费的吗?需要注册或安装吗?
glab(GitLab CLI)命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
glab(GitLab CLI)命令速查支持哪些功能?
涵盖 glab --version 与 brew/apt/dnf/go install 与 shell 补全、glab auth login 与 --hostname --token 与 auth status/logout 与 glab config set/get 与 GITLAB_TOKEN、repo clone/view/fork/create/list 与 --web、issue list 的 --assignee @me/--label/--state 与 issue view/create/note/close/reopen/update/subscribe、mr list/view/create 的 --fill/--title/--description/--draft/--source-branch/--target-branch/--squash-before-merge/--remove-source-branch/--yes 与 mr checkout/diff/approve/merge/note/close/reopen/rebase/update --ready/todo、ci view/list/status/trace/run/retry/cancel/lint 与 job artifact 与 pipeline 别名、release list/create/view/delete 与 label 与 variable list/set/get/delete 与 snippet 与 ssh-key add、glab api 的 projects/:id/merge_requests 与 --paginate 与 jq 组合与 glab alias set,以及 command not found、401 Unauthorized、token 权限不足(需 api/write_repository)、project not found、not a git repository、no merge request found、pipeline not found、自签证书 CA 问题、Windows 下 SSH key 权限 等报错排查。
glab(GitLab CLI)命令速查适合哪些场景使用?
适用于命令行内完成 MR 创建与评审、流水线状态跟踪与失败重试、Issue 批量处理、发布与 CI 变量管理、GitLab API 自动化与脚本封装,以及研发、运维与 SRE 日常协作与面试复习。