SuperAPI AI 工具集

vite

编程与开发

查看项目

更新于 10-16 05:06

技能介绍

用途:面向 Vite 7.x 的构建工具与开发服务器配置,提供即时启动、快速 HMR、生产构建优化和 TypeScript 支持。仅限 Web 平台,移动端演示使用 Expo 与 Metro 打包器,参见 expo-sdk 技能。完整 API、插件生态与高级配置可用 Context7 MCP(先 resolve-library-id 再 query-docs)。安装:pnpm add -D vite。

主要能力与用法:初始设置包括创建带 TypeScript 类型的 vite.config.ts,安装 React 插件 pnpm add -D @vitejs/plugin-react(SWC 版本 pnpm add -D @vitejs/plugin-react-swc),配置路径别名并同步 tsconfig.json 的 paths,使用 .env 文件设置环境变量。开发服务器可用 pnpm vite 启动;生产构建 pnpm vite build,本地预览 pnpm vite preview。

环境变量:所有需暴露给客户端代码的变量必须以 VITE_ 开头,通过 import.meta.env 访问;.env.local 用于本地机密且应被 gitignore。可用 loadEnv 实现动态配置,并可在 vite-env.d.ts 或 src/env.d.ts 中声明类型,运行时校验必需变量。

构建优化:配置代码分割与 manualChunks,压缩资源(gzip/brotli,如 vite-plugin-compression2),调整 chunkSizeWarningLimit、chunkFileNames 等输出命名。

CSS 与资源:PostCSS/Tailwind 指向 postcss.config.js,大应用可开启 cssCodeSplit;src/assets 由 Vite 处理(哈希与优化),/public 原样提供且不应被 import;默认小于 4KB 的资源内联为 base64(assetsInlineLimit: 4096);子目录托管设置 base: '/my-app/'。

Vite 7 说明:Rolldown 为可选的新 Rust 打包器,构建更快;改进 TypeScript 支持与 tree-shaking;默认配置适用于多数项目。

最佳实践与限制:使用路径别名、给客户端环境变量加 VITE_ 前缀、拆分大型 vendor 块、用 .env.local 存放机密、配置代理避免 CORS、部署前先构建并预览、开发用 esbuild 生产用 terser、设置 strictPort: true。反模式包括遗漏 VITE_ 前缀、从 /public 导入、提交含密钥的 .env.local、未配置路径别名、开发环境用 terser、未设 strictPort、忽略 chunk 大小警告、使用别名却漏改 tsconfig paths、硬编码 localhost、把所有 vendor 放进单个 chunk。反馈回路:构建输出显示各 chunk 大小,预览验证路由与资源,HMR 速度通常应低于 50ms。未提供具体价格、平台支持范围或效果承诺。