后端集成

:::tip Note 如果你想使用传统的后端（如 Rails, Laravel）来服务 HTML，但使用 Vite 来服务其他资源，可以查看在 Awesome Vite 上的已有的后端集成列表。

如果你需要自定义集成，你可以按照本指南的步骤配置它： :::

  1. 在你的 Vite 配置中配置入口文件和启用创建 manifest：

    1. // vite.config.js
    2. export default defineConfig({
    3.   build: {
    4.     // 在 outDir 中生成 manifest.json
    5.     manifest: true,
    6.     rollupOptions: {
    7.       // 覆盖默认的 .html 入口
    8.       input: '/path/to/main.js'
    9.     }
    10.   }
    11. })

    如果你没有禁用 module preload 的 polyfill，你还需在你的入口处添加此 polyfill：

    1. // 在你应用的入口起始处添加此 polyfill
    2. import 'vite/modulepreload-polyfill'

  2. 在开发环境中，在服务器的 HTML 模板中注入以下内容（用正在运行的本地 URL 替换 http://localhost:3000）：

    1. <!-- 如果是在开发环境中 -->
    2. <script type="module" src="http://localhost:3000/@vite/client"></script>
    3. <script type="module" src="http://localhost:3000/main.js"></script>

    还要确保服务器配置为提供 Vite 工作目录中的静态资源，否则图片等资源将无法正确加载。

    如果你正使用 @vitejs/plugin-react-refresh 配合 React，你还需要在上述脚本前添加下面这个，因为插件不能修改你正在服务的 HTML：

    1. <script type="module">
    2.   import RefreshRuntime from 'http://localhost:3000/@react-refresh'
    3.   RefreshRuntime.injectIntoGlobalHook(window)
    4.   window.$RefreshReg$ = () => {}
    5.   window.$RefreshSig$ = () => (type) => type
    6.   window.__vite_plugin_react_preamble_installed__ = true
    7. </script>

  3. 在生产环境中：在运行 vite build 之后，一个 manifest.json 文件将与静态资源文件一同生成。一个示例清单文件会像下面这样：

    1. {
    2.   "main.js": {
    3.     "file": "assets/main.4889e940.js",
    4.     "src": "main.js",
    5.     "isEntry": true,
    6.     "dynamicImports": ["views/foo.js"],
    7.     "css": ["assets/main.b82dbe22.css"],
    8.     "assets": ["assets/asset.0ab0f9cd.png"]
    9.   },
    10.   "views/foo.js": {
    11.     "file": "assets/foo.869aea0d.js",
    12.     "src": "views/foo.js",
    13.     "isDynamicEntry": true,
    14.     "imports": ["_shared.83069a53.js"]
    15.   },
    16.   "_shared.83069a53.js": {
    17.     "file": "assets/shared.83069a53.js"
    18.   }
    19. }
    • 清单是一个 Record<name, chunk> 结构的对象。
    • 对于 入口 或动态入口 chunk，键是相对于项目根目录的资源路径。
    • 对于非入口 chunk，键是生成文件的名称并加上前缀 _。
    • Chunk 将信息包含在其静态和动态导入上（两者都是映射到清单中相应 chunk 的键)，以及任何与之相关的 CSS 和资源文件。

    你可以使用这个文件来渲染链接或者用散列文件名预加载指令（注意：这里的语法只是为了解释，实际使用时请你的服务器模板语言代替）：

    1. <!-- 如果是在生产环境中 -->
    2. <link rel="stylesheet" href="/assets/{{ manifest['main.js'].css }}" />
    3. <script type="module" src="/assets/{{ manifest['main.js'].file }}"></script>