glab(GitLab CLI)命令速查
登录认证、仓库与 Issue、MR 全流程、CI 流水线与作业、Release 与变量、API 直调与报错排查等 150 条命令
共 150 条命令 · 9 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
glab --version | 查看版本,新命令在旧版可能不存在 | |
glab --help | 查看全部子命令 | |
brew install glab | macOS 安装 | |
apt install glab | Debian/Ubuntu 安装 | |
dnf install glab | RHEL/Fedora 安装 | |
go install gitlab.com/gitlab-org/cli/cmd/glab@latest | Go 安装,可拿最新特性 | |
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 fork | Fork 当前仓库到自己的空间 | |
glab repo fork --clone | Fork 后直接克隆到本地 | |
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 list | pipeline 是 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 Unauthorized | token 失效或无权限,重新 auth login | |
403 Forbidden / insufficient scope | token 缺 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 状态 |
运维常用组合
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-branchglab 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>glab variable list → glab variable set DEPLOY_KEY "xxx" --masked --protected → glab variable get DEPLOY_KEYglab api --paginate projects/:id/merge_requests?state=merged | jq -r ".[] | [.iid,.title,.author.name] | @tsv"glab 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 支持分页与字段,比在网页上翻页高效得多
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 日常协作与面试复习。