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,确认即可。

bash
npm create vite@latest enterprise-vue -- --template vue-ts
cd enterprise-vue
npm install

预期结果

text
项目目录 enterprise-vue 已生成,依赖安装命令以退出码 0 结束。

随后启动开发服务器:

bash
npm run dev -- --host 127.0.0.1

预期输出

text
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 只更新受影响的模块,而不必重新刷新整套页面状态。

Vite 驱动 Vue TypeScript 项目的启动与热更新链路

这条链路也解释了职责边界:TypeScript 负责静态类型,Vue 负责组件运行时,Vite 负责开发服务器、模块转换和构建。遇到类型报错、组件逻辑报错或构建报错时,先判断问题落在哪一层,再去看对应配置。

验证生产构建

开发服务器可用不代表生产构建一定通过。停止开发服务器后执行构建命令:

bash
npm run build

预期结果

text
dist/ 目录生成,构建命令以退出码 0 结束。

如果开发服务器能启动但构建失败,优先阅读构建输出中的 TypeScript 或模块解析错误;如果连开发服务器都无法启动,则先检查 Node.js/npm 环境、依赖是否安装完整,以及命令是否在项目根目录执行。把“能启动”和“能构建”都作为项目初始化验收条件,后续接入路由、状态管理或企业规范时才有稳定基线。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Vite 创建 TypeScript 项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通