umi4打包后的index.html文件名可配置修改吗？直接对打包后的index.html修改文件名会有问题吗？

[nykkkk]

项目可能有需求，但是找了一些配置都是umi3的，umi4支持吗？有类似的方法吗？

[Jerry-CodeHub]

Umi4 没有直接的配置项来修改 index.html 的输出文件名，这个文件名是框架内部硬编码的。

但针对你的两个问题分别回答：

1. 直接对打包后的 index.html 改名会有问题吗？

大部分情况下不会有问题，但需要注意以下几点：

• index.html 内部引用的 JS/CSS 资源路径（如 /umi.js、/umi.css）是相对路径或基于 publicPath 的绝对路径，改文件名不影响这些引用
• 改名后你的 Web 服务器（Nginx 等）需要自行配置，确保访问对应的文件名能正确返回这个 HTML
• 如果使用了 history: { type: 'browser' } 路由模式，服务端的 fallback 规则也需要同步修改（比如 Nginx 的 try_files 要指向新文件名而不是 index.html）

2. 如果想自动化改名，推荐在构建脚本中处理：

在 package.json 中给 build 命令加一个后处理步骤：

{
  "scripts": {
    "build": "umi build && mv dist/index.html dist/app.html"
  }
}

或者写一个 Umi 插件，在 onBuildComplete 钩子中自动重命名：

// plugin.ts
import { IApi } from 'umi';
import { renameSync } from 'fs';
import { join } from 'path';

export default (api: IApi) => {
  api.onBuildComplete(({ err }) => {
    if (!err) {
      const dist = api.paths.absOutputPath;
      renameSync(join(dist, 'index.html'), join(dist, 'app.html'));
    }
  });
};

然后在配置中引入：

// .umirc.ts
export default {
  plugins: ['./plugin.ts'],
};

3. 补充：如果你的需求是为每个路由生成独立的 HTML 文件

可以使用 exportStatic 配置：

export default {
  exportStatic: {},
  // 或者带 .html 后缀
  // exportStatic: { htmlSuffix: true },
};

这样 umi build 会为每个路由输出单独的 HTML，比如 /users 路由会生成 dist/users/index.html（或 dist/users.html）。