GitLab 的 Merge Request 页面是服务端动态渲染的 Web 应用,无法通过静态 HTML 实现;正确做法是调用 GitLab API(如 GET /projects/:id/merge_requests/:mr_iid)获取数据,再用前端模板渲染精简视图。

GitLab 的 Merge Request 页面不是用 HTML “制作”出来的
你没法靠手写一个 index.html 就“做出” GitLab 的 MR 页面——它本质是 GitLab 服务端动态渲染的 Web 应用,依赖完整的 Rails 后端、数据库、权限系统和前端 JS 框架(如 Vue)。直接套用静态 HTML 模拟 MR 页面,连基础交互(如评论折叠、diff 展开、批准按钮状态)都跑不起来。
如果你实际需要的是:
- 在内部工具或文档中嵌入 MR 的精简视图(比如只展示标题、状态、链接)
- 用脚本自动拉取 MR 数据并生成本地报告页
- 为 CI/CD 看板做一个轻量 MR 摘要面板
那真正可行的路径是调用 GitLab API + 渲染前端模板,而不是“写 HTML 页面”。
GET /projects/:id/merge_requests/:mr_iid 是获取 MR 详情的核心 API
GitLab 提供了标准 REST 接口来读取 MR 元数据。你需要:
立即学习“前端免费学习笔记(深入)”;
- 一个有
read_api权限的 Personal Access Token(建议 scope 仅设read_api) - 项目 ID(可以是
namespace/project-name或数字 ID) - MR 的
iid(不是全局 ID,是该项目内自增编号,例如!42中的42)
请求示例:
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML,微信编辑器可直接渲染,无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
curl --header "PRIVATE-TOKEN: glpat-xxx" \ "https://gitlab.example.com/api/v4/projects/mygroup%2Fmyrepo/merge_requests/42"
返回 JSON 包含 title、state、created_at、author、assignees、web_url、changes_count 等字段。注意:diffs 默认不返回,需加 ?include_detailed_diff=true 参数(且受行数限制)。
用 fetch + template literals 渲染简易 MR 卡片最实用
不需要框架,纯前端就能做个可点击、带状态色块的 MR 摘要卡片。关键点:
- 状态映射要准确:
opened→ ✅绿色,merged→ ⚪灰色,closed→ ❌红色 -
web_url必须保留,否则用户点不了;不要试图自己拼 URL - 作者头像用
author.avatar_url,但注意跨域策略(GitLab 通常允许 CORS) - 避免直接渲染
description的原始 Markdown——可能含 XSS 风险,至少做textContent赋值或用DOMPurify
片段示意:
const renderMRCard = (mr) => {
const statusColor = { opened: 'bg-green-100 text-green-800', merged: 'bg-gray-100 text-gray-800', closed: 'bg-red-100 text-red-800' }[mr.state];
return `
<div class="border rounded p-4">
<a href="${mr.web_url}" target="_blank"><h3 class="font-bold">${mr.title}</h3></a>
<div class="flex items-center mt-1">
<span class="text-xs px-2 py-1 rounded ${statusColor}">${mr.state}</span>
<span class="text-gray-500 text-sm ml-2">by ${mr.author.name}</span>
</div>
</div>
`;
};
别忽略 per_page 和 page 分页参数,MR 列表容易漏数据
如果你要批量拉取 MR(比如看最近 100 个),API 默认只返回 20 条。必须显式传参:
-
?per_page=100&page=1—— 获取第一页 100 条 - 检查响应头
X-Total-Pages和X-Total,决定是否继续翻页 - 频繁请求会触发速率限制(默认 10 req/sec),加
sleep(100)避免被封
遗漏分页是本地脚本查不到“老 MR”的最常见原因——你以为接口只返回最近几条,其实是没翻页。
MR 页面的“真实感”不在 HTML 结构多像,而在数据是否实时、链接是否有效、状态是否准确。把 API 调通、错误处理写实、URL 不硬编码,比花时间对齐 GitLab 的 CSS 类名重要得多。

















