常见问题

依赖问题

在 Monorepo 项目下，需要养成每次 git pull代码都要执行pnpm install的习惯，因为经常会有新的依赖包加入，项目在.husky/git-merge已经配置了自动执行pnpm install，但是有时候会出现问题，如果没有自动执行，建议手动执行一次。

项目配置默认是缓存在 localStorage 内，所以版本更新后可能有些配置没改变。

解决方式是每次更新代码的时候修改 package.json 内的 version 版本号. 因为 localStorage 的 key 是根据版本号来的。所以更新后版本不同前面的配置会失效。重新登录即可

当修改 .env 等环境文件以及 vite.config.ts 文件时，vite 会自动重启服务。

自动重启有几率出现问题，请重新运行项目即可解决.

由于 vite 在本地没有转换代码，且代码中用到了可选链等比较新的语法。所以本地开发需要使用版本较高的浏览器(Chrome 90+)进行开发

这是由于开启了路由切换动画,且对应的页面组件存在多个根节点导致的，在页面最外层添加<div></div>即可

错误示例

vue

<template>
  <!-- 注释也算一个节点 -->
  <h1>text h1</h1>
  <h2>text h2</h2>
</template>

正确示例

vue

<template>
  <div>
    <h1>text h1</h1>
    <h2>text h2</h2>
  </div>
</template>

提示

首先，完整版由于引用了比较多的库文件，所以打包会比较大。可以使用精简版来进行开发
其次建议开启 gzip，使用之后体积会只有原先 1/3 左右。gzip 可以由服务器直接开启。如果是这样，前端不需要构建 .gz 格式的文件，如果前端构建了 .gz 文件，以 nginx 为例，nginx 需要开启 gzip_static: on 这个选项。
开启 gzip 的同时还可以同时开启 brotli，比 gzip 更好的压缩。两者可以共存

注意