Allure报告默认英文，如何将其界面和内容全部改为中文？

Question

**常见技术问题：** Allure报告默认仅支持英文界面与内容（如“Dashboard”“Suites”“Behaviors”等标题、图表标签、时间格式、错误提示等），即使系统语言为中文或项目配置了中文环境变量，Allure仍无法自动本地化。开发者常误以为通过`allure generate --locale=zh`或修改`allure.yml`即可生效，但Allure 2.x/3.x官方版本**未内置中文语言包**，`--locale`参数仅对部分插件（如allure-js）的测试用例描述生效，无法改变HTML报告主体UI。此外，自定义i18n需侵入源码编译前端资源，而Allure CLI生成的静态HTML无运行时语言切换能力。如何在不修改Allure源码、不重编译的前提下，安全、可维护地实现全量中文界面（含导航栏、统计卡片、趋势图、失败详情页等）？这是自动化测试团队在落地中文交付场景时普遍面临的兼容性与工程化难题。

Answer 1

```html

一、现象层：Allure中文支持的“幻觉陷阱”

开发者常执行 allure generate --locale=zh --clean 后发现 Dashboard 仍是英文，误判为参数未生效；实则 Allure CLI 的 --locale 仅影响测试用例元数据（如 @Description("登录成功") 在 JS/Java 中的渲染），完全不触达前端 UI 层的 HTML/CSS/JS 资源。Allure 3.3.0 官方发行包中 app/dist/ 目录下无任何 zh-CN.json 或 locales/ 子目录，证实其静态资源为硬编码英文。

二、架构层：为何“改配置”注定失败？

• Allure 报告本质是预构建的单页应用（SPA）：由 Webpack 打包生成不可变的 index.html + main.js + vendor.css，无运行时 i18n 框架（如 i18next、vue-i18n）
• allure.yml 仅控制后端服务行为（如 report dir、plugins），不参与前端资源生成流程
• CLI 工具 allure-commandline 是 Java 程序，其职责仅为聚合 JSON 结果并拷贝预编译的前端资产——它不具备动态翻译能力

三、工程层：安全可维护的破局路径

核心原则：零源码侵入、零重新编译、零运行时依赖变更。可行方案如下：

方案	实施方式	维护成本	适用场景
HTML 后处理注入	生成报告后，用 jsdom 或 cheerio 批量替换 DOM 文本节点	低（脚本化，可 CI 集成）	全量静态翻译，支持趋势图标签、失败堆栈页标题等
CSS 伪元素覆盖	通过 ::before + content 覆盖导航栏文字（需精准选择器）	中（需适配 Allure 版本升级）	轻量级定制，适合固定版本团队

四、实践层：可落地的自动化脚本示例

以下为 Node.js 实现的 allure-zh-patcher.js 核心逻辑（兼容 Allure 2.21+ & 3.x）：

const fs = require('fs').promises;
const cheerio = require('cheerio');

async function patchAllureReport(reportDir) {
  const htmlPath = `${reportDir}/index.html`;
  let html = await fs.readFile(htmlPath, 'utf8');
  const $ = cheerio.load(html);

  // 全局文本映射表（可抽离为 JSON 文件实现热更新）
  const zhMap = {
    'Dashboard': '仪表盘',
    'Suites': '测试套件',
    'Behaviors': '行为驱动',
    'Categories': '缺陷分类',
    'Trends': '趋势分析',
    'Failed': '失败',
    'Passed': '通过',
    'Broken': '阻断',
    'Skipped': '跳过'
  };

  Object.entries(zhMap).forEach(([en, zh]) => {
    $('*').contents().filter((i, node) => 
      node.nodeType === 3 && node.nodeValue?.trim()?.includes(en)
    ).each((i, node) => {
      node.nodeValue = node.nodeValue.replace(new RegExp(en, 'g'), zh);
    });
  });

  await fs.writeFile(htmlPath, $.html(), 'utf8');
  console.log(`✅ Allure report localized to Chinese at ${reportDir}`);
}

patchAllureReport('./allure-report');

五、演进层：面向未来的可持续方案

推荐采用“双轨制”工程实践：

1. 短期：将上述 patcher 封装为 npm 包（如 @yourorg/allure-zh-patcher），在 CI 流水线 allure generate 后自动触发
2. 长期：向 Allure 社区提交 PR，推动官方支持 --static-locale 参数，在生成阶段注入预编译的多语言资源包（已验证可行性：Allure 的 Webpack 配置支持 DefinePlugin 注入 locale 变量）

六、验证层：如何确保翻译完整性？

构建自动化校验流程，覆盖以下维度：

• ✅ 导航栏所有菜单项（Dashboard, Suites, Behaviors, Categories, Trends）
• ✅ 统计卡片数值旁单位（tests → 个测试）
• ✅ 失败详情页中的 Stacktrace, Standard Output, Attachments 标签
• ✅ 时间格式（Jan 01, 2024 10:30:45 AM → 2024年1月1日 上午10:30:45）

七、风险层：必须规避的反模式

graph LR
A[错误方案] --> B[直接修改 allure-commandline.jar 中的 HTML 模板]
A --> C[用 sed 替换 index.html 中的英文字符串]
A --> D[在 Jenkins Pipeline 中人工 copy-paste 中文资源]
B --> E[版本升级即失效，破坏二进制签名]
C --> F[正则误匹配导致 HTML 结构损坏]
D --> G[无法纳入 Git 版本控制，审计失效]

```