常见问题

使用createWebHistory()路由模式，正式环境刷新浏览器后404

请查看：HTML5模式与服务器配置示例

在应用配置抽屉中修改的配置不能持久化

/src/stores/modules/app.js中读取/src/appConfig.js作为应用配置默认值，项目没有将所有配置都持久化，如果需要某个配置持久化需要自行添加。

export const useAppStore = defineStore('app', () => {
  //......
}, {
  persist: {
    key: `${PREFIX}APPCONFIG`,
    paths: [
    // 在这里添加某个需要持久化的配置项或持久化整个appConfig
      'appConfig.defaultLanguage',
      'appConfig.elementSize',
      'appConfig.layoutType',
      'appConfig.showSubMenu',
      'appConfig.theme',
      'appConfig.oldTheme',
    ],
    storage: localStorage,
    debug: true, 
  },
})

ElementPlus表单组件Unable to preventDefault inside passive event listener invocation.报错

在使用ElementPlus的一些表单组件如：输入框可清楚时点击清楚图标，日期组件选择日期，等情况下控制台会有此报错， 此问题由于项目使用default-passive-events依赖造成冲突。

如果不使用default-passive-events依赖，控制台会有警告：Added non-passive event listener to a scroll-blocking <某些> 事件. Consider marking event handler as 'passive' to make the page more responsive. See <URL>element-plus/issues/8123

[Vue warn]: Component inside <Transition> renders non-element root node that cannot be animated.

项目使用 <Transition>组件实现了页面切换动画，但是在使用过程中，如果组件的根节点不是一个元素，会出现此报错。页面应该有一个根元素节点，注释也算一个元素节点。

<!-- 错误 -->
<template>
  <!-- <div>
    1
  </div> -->
  <div>
    2
  </div>
</template>

<!-- 正确 -->
<template>
  <div>
    1
  </div>
</template>

子菜单展开/收缩卡顿问题

请查看：element-plus/issues/6792

作者建议尽量不适用EpSetting图标