Vite+Vue下的多页面入口配置

文章介绍了如何在Vite项目中配置多页面入口,通过修改vite.config.js中的build.rollupOptions.input,添加不同的入口文件路径。对于非index.html文件,访问时需使用完整文件名。同时,如果开启history模式的vue-route,错误配置可能导致访问问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

我发现多页面入口配置在网上的资料比较乱,今天正好结合我们的开源API分析工具项目(APIcat)更新情况总结一下。

更新vite.config.js

主要配置的更新是在vite.config.js里面要增加build里的rollupOptions,因为vite底层使用了rollup,实际要更改的是他的配置,为rollupOptions增加多个input属性,

官方文档地址为:https://rollupjs.org/configuration-options/#input

推荐配置为map,比如我们有report和detect两个入口,则分别配置如下:

 build: {
    rollupOptions: {
      input: {
        report: fileURLToPath(new URL('./report/index.html', import.meta.url)),
        detect: fileURLToPath(new URL('./detect/index.html', import.meta.url)),
      },
    },
  },

 具体的值不用在意,能解析到即可。比如我另外一个项目配置为:

  build: {
    rollupOptions: {
      input: {
        main: resolve(__dirname, 'index.html'),
        get: resolve(__dirname, 'page/get.html'),
        apihome: resolve(__dirname, 'api/home.html'),
      },
    },
  },

其实配置很简单,但是调试的时候要注意一些问题:

如果文件是index.html,访问的时候可以使用目录名称访问,比如我的report入口,就可以使用http://localhost:5173/report/访问,注意:最后面的/是必须要的

如果文件不是index.html,而是其他名称,则必须使用完整文件名称访问,省略.html都不行

如果犯了上面两个错误,恰好还有一个根入口,又启动了history模式的vue-route,上面的问题特别容易造成配置不成功的假象,因为这时,会默认使用根入口渲染,并将多余url作为vue-route参数。

### Vite Vue3 多页面应用配置教程 在现代前端开发中,多页面应用(MPA, Multi-Page Application)的需求仍然存在,尤其是在一些特定场景下,比如企业级后台管理系统或者浏览器插件开发。以下是关于如何在基于 ViteVue3 的项目中实现多页面配置的具体方法。 #### 1. 创建基础目录结构 为了支持多个页面,首先需要调整项目的目录结构以适应多入口需求。通常的做法是在 `src` 目录下创建一个子文件夹来存储不同页面的资源文件。例如: ```plaintext /src/ /pages/ /home/ main.js // Home 页面的入口文件 App.vue // Home 页面的根组件 /about/ main.js // About 页面的入口文件 App.vue // About 页面的根组件 ``` 这种分层设计有助于清晰管理各个页面的逻辑和样式[^2]。 --- #### 2. 修改 Vite 配置文件 通过自定义 `vite.config.ts` 来设置多页面的支持能力。具体来说,可以通过指定多个入口并生成对应的 HTML 文件完成此操作。以下是一个完整的配置示例: ```javascript import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue'; export default defineConfig({ plugins: [ vue(), ], build: { rollupOptions: { input: { home: './src/pages/home/main.js', // 定义首页入口 about: './src/pages/about/main.js' // 定义关于页入口 } } }, }); ``` 上述代码片段展示了如何利用 Rollup 的 `input` 属性为不同的页面分配独立的入口脚本。 --- #### 3. 动态生成 HTML 文件 对于每一个入口都需要有一个关联的 HTML 文件作为模板渲染目标。可以借助插件如 `@vitejs/plugin-html` 或者手动编写静态 HTML 模板。如果采用动态方式,则可以在 `vite.config.ts` 中进一步扩展如下所示: ```typescript import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue'; import path from 'path'; // 自动化处理HTML文件路径映射函数 function generateHtmlPlugins(pagesDir) { const pages = ['home', 'about']; // 假设只有两个页面 return pages.map(page => ({ name: `${page}-html`, transformIndexHtml(html) { return html.replace('__PAGE_NAME__', page); }, writeBundle() { this.emitFile({ type: 'asset', fileName: `${page}.html`, source: ` <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <link rel="icon" href="/favicon.ico"> <title>${page.charAt(0).toUpperCase() + page.slice(1)}</title> <!-- 自动生成标题 --> </head> <body> <div id="app"></div> <script type="module" src="${path.resolve(__dirname, `./src/pages/${page}/main.js`)}}"></script> </body> </html>` }); } })); } export default defineConfig({ plugins: [...generateHtmlPlugins('src/pages'), vue()], }); ``` 这段代码实现了自动化生成每个页面所需的 HTML 文件,并确保它们能够正确加载各自的 JavaScript 资源。 --- #### 4. 设置环境变量 `.env` 文件允许开发者轻松切换不同环境下使用的 API 地址或其他全局参数。例如,在 `.env.development` 中可设定本地调试服务器地址;而在生产环境中则指向实际部署的服务端接口位置[^1]: ```plaintext # .env.development VITE_APP_API_BASE_URL=http://localhost:3000 # .env.production VITE_APP_API_BASE_URL=https://api.example.com ``` 这些变量可以直接通过 `import.meta.env.VITE_APP_API_BASE_URL` 访问使用。 --- #### 5. 构建与运行 执行标准命令即可启动服务或打包项目: ```bash pnpm run dev # 开发模式 pnpm run build # 生产模式 ``` 完成后会在 dist 文件夹里看到对应于各页面的输出结果,包括 CSS、JS 及其相应的 HTML 文档。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

百家饭AI

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值