在 Vue Router 4 中,如何设置base参数

在 Vue Router 4 中,base参数应该设置在 createWebHistory()函数中。以下是完整的设置方法:

1. 基本设置

复制代码
import { createRouter, createWebHistory } from 'vue-router'

const router = createRouter({
  history: createWebHistory('/your-base-path/'),  // 在这里设置 base
  routes,
})

2. 不同场景的配置

场景一:部署在子目录

复制代码
// 例如:https://example.com/admin/
const router = createRouter({
  history: createWebHistory('/admin/'),
  routes,
})

场景二:部署在根目录

复制代码
// 默认部署在根目录
const router = createRouter({
  history: createWebHistory(),  // 不传参数,默认为根目录
  // 或者显式指定
  history: createWebHistory('/'),
  routes,
})

场景三:动态配置(推荐)

复制代码
// 使用环境变量
const base = import.meta.env.BASE_URL || '/'

const router = createRouter({
  history: createWebHistory(base),
  routes,
})

3. 配合构建工具的配置

使用 Vite

复制代码
// vite.config.js
export default defineConfig({
  base: '/my-app/',  // 这里设置构建时的 base
  // ...
})

// router/index.js
const router = createRouter({
  history: createWebHistory(import.meta.env.BASE_URL),
  routes,
})

使用 Vue CLI

复制代码
// vue.config.js
module.exports = {
  publicPath: process.env.NODE_ENV === 'production' 
    ? '/production-sub-path/' 
    : '/'
}

// router/index.js
const router = createRouter({
  history: createWebHistory(process.env.BASE_URL),
  routes,
})

4. 完整示例

复制代码
import { createRouter, createWebHistory } from 'vue-router'

const routes = [
  { path: '/', component: Home },
  { path: '/about', component: About },
]

// 如果应用部署在 https://example.com/my-app/
const router = createRouter({
  history: createWebHistory('/my-app/'),
  routes,
})

export default router

注意事项

  1. base 必须以斜杠开头和结尾

    复制代码
    // 正确
    createWebHistory('/my-app/')
    
    // 错误
    createWebHistory('my-app')
    createWebHistory('/my-app')
  2. 实际访问 URL

    • 设置 base: '/my-app/'

    • /about路由的实际访问 URL 是:https://example.com/my-app/about

  3. 开发环境和生产环境

    • 开发环境通常使用 /

    • 生产环境根据实际部署路径设置

  4. 服务器配置

    • 需要确保服务器正确配置,将所有路由重定向到 index.html

选择最适合你项目部署场景的配置方式即可。

相关推荐
anOnion16 小时前
构建无障碍组件之Radio group pattern
前端·html·交互设计
pe7er16 小时前
状态提升:前端开发中的状态管理的设计思想
前端·vue.js·react.js
SoaringHeart17 小时前
Flutter调试组件:打印任意组件尺寸位置信息 NRenderBox
前端·flutter
晚风予星17 小时前
Ant Design Token Lens 迎来了全面升级!支持在 .tsx 或 .ts 文件中直接使用 Design Token
前端·react.js·visual studio code
sunny_17 小时前
⚡️ vite-plugin-oxc:从 Babel 到 Oxc,我为 Vite 写了一个高性能编译插件
前端·webpack·架构
GIS之路17 小时前
ArcPy 开发环境搭建
前端
林小帅19 小时前
【笔记】OpenClaw 架构浅析
前端·agent
林小帅19 小时前
【笔记】OpenClaw 生态系统的多语言实现对比分析
前端·agent
程序猿的程20 小时前
开源一个 React 股票 K 线图组件,传个股票代码就能画图
前端·javascript
不爱说话郭德纲20 小时前
告别漫长的HbuilderX云打包排队!uni-app x 安卓本地打包保姆级教程(附白屏、包体积过大排坑指南)
android·前端·uni-app