Gitlab自定义SVG徽章无法显示问题求助

1. 修正项目内SVG的原始文件URL #

你之前填写的URL是Gitlab的文件预览页面，并非直接返回SVG内容的原始路径。正确的Gitlab原始文件URL格式为：

https://xxx-test.test.lt/[你的项目完整路径]/raw/[目标分支名]/pylint.svg

示例（假设分支为main）：

https://xxx-test.test.lt/embeded-programmers/Embedded-FW-Guidelines/raw/main/pylint.svg

• 确认分支名准确（比如main、master或自定义分支）
• 先在浏览器访问该URL，验证是否直接显示纯SVG内容，而非Gitlab的文件预览页面

2. 工件URL无法显示的原因及修复 #

若工件URL能在浏览器打开但徽章不显示，核心问题是权限限制：

• 私有项目的工件URL需要身份认证，而徽章无法携带权限信息，导致无法访问
• 修复方案：在.gitlab-ci.yml中配置工件为公开（仅适用于允许公开的内容）或永久保留：

generate-badge:
  script:
    - python your-badge-script.py
  artifacts:
    paths:
      - pylint.svg
    expire_in: never  # 永久保留工件
    public: true      # 设置为公开访问

更新后使用公开权限的工件URL填写到徽章图片URL中即可。

3. 使用Gitlab Pages托管SVG（最稳定方案） #

如果需要长期稳定的徽章访问路径，推荐用Gitlab Pages托管：

1. 在项目根目录创建public文件夹，将生成的pylint.svg移入该文件夹
2. 在.gitlab-ci.yml中添加Pages部署任务：

pages:
  script:
    - python your-badge-script.py  # 自动生成徽章（若需要）
    - mv pylint.svg public/         # 将SVG移动到Pages托管目录
  artifacts:
    paths:
      - public
  only:
    - main  # 仅在指定分支触发部署

3. 部署完成后，Pages访问URL格式为：

https://embeded-programmers.xxx-test.test.lt/Embedded-FW-Guidelines/pylint.svg

（格式规则：https://[组/用户名].[Gitlab域名]/[项目名]/pylint.svg）
将此URL填入徽章图片URL即可正常显示。

4. 验证SVG文件有效性 #

先在本地浏览器打开生成的pylint.svg，确认文件本身无语法错误。若本地能正常显示，再排查Gitlab端的访问路径是否正确。

内容的提问来源于stack exchange，提问作者TheBestPlayer