本文将带你深入了解 Vue 3 新项目的初始化流程。当前主流选择是从 Vite 起步——启动速度快、配置简洁,与单文件组件的配合堪称天衣无缝。初期阶段不必急于安装 UI 组件库、状态管理、路由和各种插件,优先确保项目骨架搭建、类型检查与构建流程稳定运行,才是真正关键的基础工作。

创建项目的命令如下:
npm create vite@latest my-vue-app -- --template vue-ts
cd my-vue-app
npm install
npm run dev
如果你习惯使用 pnpm,流程也相差无几:
pnpm create vite my-vue-app --template vue-ts
cd my-vue-app
pnpm install
pnpm dev
入口文件的典型写法如下:
import { createApp } from "vue"
import App from "./App.vue"
createApp(App).mount("#app")
这构成了 Vue 3 应用的最小化启动过程。后续集成 Router、Pinia 以及 UI 组件库时,只需在 createApp(App) 之后依次调用 use(),最后再执行 mount() 即可。整个逻辑清晰明了,没有任何多余的复杂度。
项目目录结构建议保持简洁:
src/
assets/
components/
composables/
pages/
stores/
App.vue
main.ts
对于小规模项目,完全不必一开始就设计过于复杂的分层结构。随着页面增多,再根据业务模块进行拆分会更为合理。过早创建大量空目录,反而会让新加入的开发者感到困惑——代码究竟该放在哪个位置?
Vue 单文件组件推荐直接使用 语法:
{{ message }}
这种写法减少了大量模板代码,同时类型推断体验也十分流畅。除非你正在维护旧版项目,否则新组件默认采用此写法,几乎是最佳选择。
完成初始化后,务必执行一次生产构建验证:
npm run build
npm run preview
开发服务器能够正常运行,并不代表生产构建一定没有问题。路径别名、静态资源处理、环境变量配置以及类型检查等问题,往往只有在 build 阶段才会暴露出来。提前进行验证,远比上线后出现故障再回头排查要省时省力得多。
总结一下初始化核心清单:使用 Vue + TypeScript 模板,确保 dev / build / preview 流程全部跑通,删除模板中的无关代码,确定目录命名约定,再逐步接入 Router 和 Pinia。先把基础架构稳住,比一开始就追求所谓的“企业级模板”更为可靠实用。
