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

如何在GitLab中为项目创建徽章?含具体项目路径配置咨询

如何在GitLab中为你的项目创建徽章

别担心,我来一步步帮你搞定GitLab项目徽章的设置,不用对着官方文档头大啦!

第一步:进入徽章设置页面

先打开你的项目主页:https://gitlab.com/username/userproject,然后按以下步骤操作:

  • 点击左侧菜单栏的 Settings(设置)选项
  • 在展开的子菜单里选择 Badges(徽章),就能进入专属的徽章配置页面了

第二步:填写徽章的核心参数

下面针对你的项目地址,给你具体的参数示例,每个字段都讲清楚用途:

1. 徽章名称(Name)

随便填个直观的名字就行,比如 流水线状态、代码覆盖率 或者 项目已完成,方便你后续识别不同的徽章。

这个是用户点击徽章后会跳转的页面,根据你的需求选对应的链接:

  • 如果是跳转到CI/CD流水线页面:https://gitlab.com/username/userproject/-/pipelines
  • 如果是跳转到代码覆盖率报告页面(前提是你已经配置了覆盖率统计):https://gitlab.com/username/userproject/-/jobs/artifacts/main/file/coverage/index.html?job=test
  • 要是想跳转到项目的README文档:https://gitlab.com/username/userproject/-/blob/main/README.md

3. 徽章图片链接(Image URL)

这是徽章的显示图片,GitLab提供了动态生成的内置徽章,也支持自定义静态徽章,给你几个常用示例:

  • 流水线状态动态徽章:显示主分支的实时构建状态,链接是 https://gitlab.com/username/userproject/badges/main/pipeline.svg

    注意:如果你的默认分支不是main(比如是master或dev),把链接里的main改成你的实际分支名即可

  • 代码覆盖率动态徽章:显示主分支的实时覆盖率数据,链接是 https://gitlab.com/username/userproject/badges/main/coverage.svg
  • 自定义静态徽章:如果你有自己制作的徽章图片,先把图片上传到项目仓库里(比如放到docs/badges/目录下),然后用这个格式的链接:https://gitlab.com/username/userproject/-/raw/main/docs/badges/你的徽章文件名.svg

第三步:保存并验证

填完所有参数后,点击页面底部的 Save changes 按钮,页面会立刻显示徽章的预览效果。你可以点击预览的徽章,检查跳转链接是否正确,图片显示是否正常。

小提示

  • 动态徽章(比如流水线、覆盖率)会自动同步项目的最新状态,不用手动更新,非常省心
  • 如果你需要添加多个徽章,重复上面的步骤就行,GitLab支持添加多个项目徽章

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.05.29 08:15:17