> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt. # html.inject - **类型：** `'head' | 'body' | boolean | Function` - **默认值：** `'head'` 修改构建产物中 `

``` ## 插入至 body 标签添加如下配置，可以将 ` ``` ## 函数用法 - **类型：** ```ts type InjectFunction = (context: { value: ScriptInject; entryName: string; }) => ScriptInject | void | Promise; ``` 当 `html.inject` 为 Function 类型时，函数接收一个对象作为入参，对象的值包括： - `value`：Rsbuild 的默认 inject 配置。 - `entryName`: 当前入口的名称。在 MPA（多页面应用）场景下，你可以基于入口名称设置不同的 `inject` 方式： ```ts title="rsbuild.config.ts" export default { html: { inject({ entryName }) { return entryName === 'foo' ? 'body' : 'head'; }, }, }; ``` ## 手动注入当 `html.inject` 设置为 `false` 时，Rsbuild 不会在 HTML 中自动插入标签，[html.tags](/zh/config/html/tags.md) 中定义的标签也不会生效。此时，你可以通过 `htmlPlugin.tags` 模板参数来访问所有待注入的标签，并手动插入到指定的位置。例如，在 `a.js` 和 `b.js` 两个脚本之间插入 Rsbuild 生成的 ` <%= htmlPlugin.tags.headTags %>

<%= htmlPlugin.tags.bodyTags %> ``` ## 版本历史 | 版本 | 变更内容 | | ------ | ------------------------- | | v2.0.8 | 新增对 `html.inject` 异步函数的支持 |