uni-app Vue3 项目自 v3.9.0 起默认使用 Vite 构建无需手动切换需确保 CLI ≥ 3.9.0、使用 Vue3 模板配置应写在 vite.config.ts 中并调用 defineUniAppConfig环境变量须以 UNI_APP_ 或 VUE_APP_ 开头且第三方插件需谨慎兼容。uni-app Vue3 项目默认就用 Vite不用额外配置uni-app 自 v3.9.0 起新建的 Vue3 项目vue3 typescript 模板底层构建工具就是 Vite不是旧版的 Webpack。你执行 npm create uni-applatest 选 Vue3生成的项目里根本找不到 vue.config.js 或 webpack.config.js —— 因为它压根不走 Webpack 流程。常见误解是“要手动把 uni-app 切到 Vite”其实只要确认项目是 Vue3 模板、CLI 版本 ≥ 3.9.0npm run dev 启动的就是 Vite 开发服务器。检查 CLI 版本npx uni-app -V低于 3.9.0 就升级npm install -g dcloudio/vue-cli老项目Vue2 或旧 Vue3升级需重开新项目不支持原地迁移 Vite 构建链vue.config.js 在 Vite 模式下完全失效删掉也不会报错但留着会误导人自定义 Vite 配置要改 vite.config.ts不是 vue.config.js需要调整构建行为比如 alias、代理、环境变量注入时必须操作 vite.config.ts或 vite.config.js这个文件在项目根目录由 uni-app 初始化时自动创建。注意uni-app 的 Vite 配置有特殊要求——必须导出一个包裹了 defineConfig 的函数并传入 defineUniAppConfig否则 H5 端可能无法正确解析 pages.json 或条件编译。立即学习“前端免费学习笔记深入”正确写法示例import { defineConfig } from viteimport { defineUniAppConfig } from dcloudio/vite-plugin-uniexport default defineConfig({ plugins: [defineUniAppConfig()], resolve: { alias: { : /src } }})直接写 export default defineConfig({ ... }) 不加 defineUniAppConfig() 插件会导致 H5 端路由异常、uni.getSystemInfoSync() 返回空对象等隐性问题小程序平台微信/支付宝等对 Vite 配置敏感度较低但 H5 端必须走这套插件链process.env 在 uni-app Vite 中不能直接读取要用 import.meta.envVue2 时代习惯的 process.env.NODE_ENV 在 Vite 下不可用Vite 只识别 import.meta.env且只有以 VUE_APP_ 或 UNI_APP 开头的环境变量才会被注入uni-app 有定制规则。 Trenz AI驱动的社交电商营销平台专为TikTok Shop设计