Vue / 系统课时
使用 Vite 创建 TypeScript 项目
使用 Vite 创建 TypeScript 项目
这一节直接搭出一个可运行的 Vue 3 + TypeScript 工程,并沿着 Vite 的启动链路识别关键文件。完成后,你应能启动开发服务器、修改组件看到热更新,并知道配置或入口问题该从哪里查起。
学习目标
- 使用 Vite 的
vue-ts模板创建并启动 Vue 3 + TypeScript 项目。 - 识别
src/main.ts、src/App.vue、vite.config.ts与 TypeScript 配置的职责。 - 验证开发服务器和生产构建都能正常工作。
创建最小 TypeScript 项目
在准备好的工作目录执行下面的命令。首次运行 npm create 时,npm 可能询问是否临时安装 create-vite,确认即可。
npm create vite@latest enterprise-vue -- --template vue-ts
cd enterprise-vue
npm install预期结果
项目目录 enterprise-vue 已生成,依赖安装命令以退出码 0 结束。随后启动开发服务器:
npm run dev -- --host 127.0.0.1预期输出
VITE v<VALUE> ready in <VALUE> ms
➜ Local: http://127.0.0.1:<PORT>/<VALUE> 和 <PORT> 会随 Vite 版本与本机环境变化。浏览器访问终端显示的 Local 地址,看到默认 Vue 页面就说明脚手架、依赖安装和开发服务器三部分已经连通。
看懂核心文件
Vite 的 Vue TypeScript 模板文件不多,先抓住启动必经的几个入口,而不是逐个背目录。
| 文件 | 核心职责 |
|---|---|
package.json |
定义依赖与 dev、build 等脚本 |
index.html |
浏览器首先加载的 HTML 入口 |
src/main.ts |
创建 Vue 应用并挂载根组件 |
src/App.vue |
默认根组件,使用 Vue 单文件组件格式 |
vite.config.ts |
Vite 与 Vue 插件等构建配置 |
tsconfig*.json |
TypeScript 编译、类型检查与不同运行目标的配置 |
模板版本可能让辅助文件略有差异,但排查“页面为什么没启动”时,可以先沿着 index.html、src/main.ts、src/App.vue 这条主链检查。
理解启动与热更新链路
执行 npm run dev 后,Vite 启动开发服务器。浏览器请求 index.html,其中的模块脚本继续加载 src/main.ts;main.ts 创建 Vue 应用并挂载 App.vue。开发期间修改组件时,Vite 会通过 HMR 只更新受影响的模块,而不必重新刷新整套页面状态。

这条链路也解释了职责边界:TypeScript 负责静态类型,Vue 负责组件运行时,Vite 负责开发服务器、模块转换和构建。遇到类型报错、组件逻辑报错或构建报错时,先判断问题落在哪一层,再去看对应配置。
验证生产构建
开发服务器可用不代表生产构建一定通过。停止开发服务器后执行构建命令:
npm run build预期结果
dist/ 目录生成,构建命令以退出码 0 结束。如果开发服务器能启动但构建失败,优先阅读构建输出中的 TypeScript 或模块解析错误;如果连开发服务器都无法启动,则先检查 Node.js/npm 环境、依赖是否安装完整,以及命令是否在项目根目录执行。把“能启动”和“能构建”都作为项目初始化验收条件,后续接入路由、状态管理或企业规范时才有稳定基线。