直接用 Vite 官方模板初始化即可,Vite 已封装 Vue3 + TypeScript、开发服务器、HMR 和依赖预构建等核心能力;只需确认 Node.js ≥20.19 或 22.12+,运行 npm create vite@latest my-app -- --template vue-ts,按引导选择插件,生成后 npm install && npm run dev 即可立即运行。

直接用 Vite 官方模板初始化,不用手动配置构建逻辑。Vite 已经把 Vue3 + TypeScript、开发服务器、HMR、依赖预构建这些核心能力全封装好了,你只需要选对命令、装对依赖、确认环境就绪。
确认 Node.js 版本达标
Vite 6/7 要求 Node 20.19+ 或 Node 22.12+,最低也不能低于 Node 18。在 VS Code 终端里运行:
- node -v —— 确保输出 v20.x 或更高
- npm -v —— npm 会随 Node 自带,建议不低于 10.2
如果版本不够,推荐安装 Node 20 LTS(长期支持版),稳定且兼容性好。多版本共存可用 nvm 管理。
执行 Vite 初始化命令
在终端中运行以下任一命令(推荐 npm):
- npm create vite@latest my-app -- --template vue-ts(带 TypeScript)
- npm create vite@latest my-app -- --template vue(纯 JavaScript)
执行后会进入交互式引导,可按需选择是否添加 Vue Router、Pinia、Vitest、ESLint、Prettier 等。选完即生成项目目录,无需额外配置 vite.config.js 就能立即运行。
启动前检查关键文件
初始化完成后,确保以下文件存在且内容合理:
-
vite.config.ts(或 .js)—— 默认已含
vue()插件,支持.vue文件解析 -
tsconfig.json(TypeScript 项目)—— 模板已配好
compilerOptions和vue类型支持 -
src/main.ts —— 使用
createApp启动 Vue3 应用,不是 Vue2 的new Vue - index.html —— 入口 HTML,Vite 会自动注入模块脚本,无需手动写 bundle 引用
常见配置补强(按需添加)
基础项目跑起来后,如需增强工程体验,可手动修改 vite.config.ts:
-
路径别名:加
resolve.alias,例如@: path.resolve(__dirname, 'src') -
代理开发接口:在
server.proxy下配置/api转发到后端地址 -
静态资源处理:
public/下放不参与构建的文件(如 favicon.ico),src/assets/下放会被 hash 和压缩的资源
这些都不是初始化必需项,先跑通 npm run dev 再逐步加。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











