docs: complete project code annotations

vite.config.ts

@@ -8,10 +8,12 @@ import compression from 'vite-plugin-compression';
 import { viteMockServe } from 'vite-plugin-mock';
 import svgLoader from 'vite-svg-loader';
 
+/** 工作目录用于解析环境变量文件和项目内资源路径。 */
 const CWD = process.cwd();
 
-// https://vitejs.dev/config/
+/** 根据当前 Vite 模式加载环境变量并组装应用构建和开发服务器配置。 */
 export default ({ mode }: ConfigEnv): UserConfig => {
+  /** 从当前模式对应的 env 文件读取站点基路径和 API 代理前缀。 */
   const { VITE_BASE_URL, VITE_API_URL_PREFIX } = loadEnv(mode, CWD);
   return {
     base: VITE_BASE_URL,
@@ -33,6 +35,7 @@ export default ({ mode }: ConfigEnv): UserConfig => {
       },
     },
 
+    // 注册 Vue/JSX、开发 mock、SVG 导入及 gzip 压缩等构建插件。
     plugins: [
       vue(),
       vueJsx(),
@@ -53,6 +56,7 @@ export default ({ mode }: ConfigEnv): UserConfig => {
       }),
     ],
 
+    // 本地开发服务设置和 API 请求代理。
     server: {
       port: 3002,
       host: '0.0.0.0',
@@ -63,6 +67,7 @@ export default ({ mode }: ConfigEnv): UserConfig => {
     },
 
     // https://github.com/vueuse/vueuse/issues/5387#issuecomment-4734186040
+    // 控制产物文件名、依赖分包策略及第三方包构建警告。
     build: {
       chunkSizeWarningLimit: 1000,
       rolldownOptions: {
@@ -90,6 +95,7 @@ export default ({ mode }: ConfigEnv): UserConfig => {
               return 'assets/xiaohh-[hash].[ext]';
             }
           },
+          // 将依赖和 SVG 拆分为独立 chunk，改善浏览器缓存粒度。
           manualChunks(id) {
             if (id.includes('node_modules')) {
               // node_modules 当中不同依赖打包成不同的文件