Vue / 系统课时

创建 Vue 3 项目

创建 Vue 3 项目

本课使用 Vite 的 Vue TypeScript 模板创建可运行项目,完成依赖安装、开发服务器启动、入口文件阅读和热更新验证,最终得到后续管理后台功能开发的基础工程。

学习目标

  • 使用 Vite 创建 Vue 3 TypeScript 项目并启动开发服务器
  • 说明 index.html、src/main.ts 与 App.vue 的职责
  • 通过修改根组件和生产构建验证工程状态

创建并启动项目

在准备存放源码的目录中执行以下命令。项目名使用小写字母和短横线,且目标目录应为空或不存在。

bash
npm create vite@latest vue3-admin -- --template vue-ts
cd vue3-admin
npm install
npm run dev

预期输出:

text
VITE v<VERSION> ready in <TIME> ms
Local: http://localhost:<PORT>/

首次执行时 npm 可能询问是否安装 create-vite,确认后继续。打开终端给出的本地地址即可看到模板页面;端口和启动耗时以实际输出为准,不要固定假设为某个值。

理解启动链路

执行 npm run dev 后,npm 读取 package.json 中的 dev 脚本并启动 Vite。浏览器首先加载根目录的 index.html,其中的模块脚本再加载 src/main.ts;main.ts 创建 Vue 应用、加载根组件,并挂载到页面中的 #app 节点。

Vue 3 项目入口与开发服务器流程

src/main.ts 是应用代码的起点。下面是模板入口的核心形式,属于项目内文件示例,依赖已经安装的 Vue 与 Vite 环境:

ts
import { createApp } from 'vue'
import './style.css'
import App from './App.vue'

// #app 必须与 index.html 中的挂载节点保持一致
createApp(App).mount('#app')

保存后重新加载页面仍能正常显示模板,说明入口模块、根组件与挂载节点连接正确。

认识基础目录

路径 作用
index.html 浏览器入口,提供 #app 挂载节点并加载 src/main.ts
src/main.ts 创建 Vue 应用并挂载根组件
src/App.vue 根组件,后续承载全局布局或路由出口
src/components/ 放置可复用组件,模板内容可按项目需要清理
public/ 存放无需经过模块处理、按原文件名发布的静态资源
vite.config.ts 配置 Vue 插件、开发服务器和构建行为
package.json 记录依赖、项目脚本与包管理信息

不同版本模板的示例资源可能略有变化,但入口职责和启动链路保持一致。不要在创建项目后立即大规模调整目录,先完成运行与构建验收。

验证热更新

将 src/App.vue 替换为以下完整文件。保存时保持开发服务器运行:

vue
<script setup lang="ts">
const title = 'Vue 3 管理后台'
</script>

<template>
  <main>
    <h1>{{ title }}</h1>
    <p>开发服务器与热更新均已就绪。</p>
  </main>
</template>

<style scoped>
main {
  padding: 32px;
}
</style>

预期结果:

text
页面自动更新,显示“Vue 3 管理后台”和“开发服务器与热更新均已就绪”。
终端保持运行,且没有编译错误。

页面无需手动刷新即可变化,说明 Vite 的热更新链路正常。若页面空白,先查看浏览器 Console,再检查 main.ts 的挂载选择器与 index.html 中的节点是否一致。

执行生产构建

停止开发服务器后执行构建命令,验证 TypeScript 检查与资源打包是否通过:

bash
npm run build

预期输出:

text
> vue3-admin@<VERSION> build
> <TYPE_CHECK_COMMAND> && vite build

✓ built in <TIME>s

构建成功后根目录会生成 dist/。具体模块数量、文件大小和耗时会随模板版本与机器环境变化;验收重点是命令退出成功、没有类型错误,并出现构建完成信息。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建 Vue 3 项目

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

登录哪都通