Vue3 创建项目

创建 Vue3 项目首选官方脚手架 create-vue。它基于 Vite,会自动生成目录结构、构建配置,并可按需加入路由、状态管理等模块,省去手工搭建的大量工作。

使用 create-vue

打开终端执行:

npm create vue@latest

交互式询问会依次出现:项目名称、是否使用 TypeScript、是否启用 Vue Router、Pinia、ESLint 等特性。新手可全部选择 No(或直接回车),同样能得到一个干净可运行的项目。

初始化与启动示例

以项目名 vue3-demo 为例:

npm create vue@latest vue3-demo

cd vue3-demo
npm install
npm run dev

输出 Local: http://localhost:5173/ 后,用浏览器访问即出现官方欢迎页(含 Vite + Vue 图标与示例组件),说明项目创建成功。

另一种方式:npm create vite

create-vue 是 Vue 官方封装好的脚手架,也可以直接使用 Vite 的 Vue 模板:

npm create vite@latest my-app -- --template vue

区别在于:create-vue 预置了官方推荐结构(README、.vscode 推荐配置、可选全家桶),Vite 裸模板则更精简,适合需要完全自定义的场景。

常见问题

  • 端口被占用:Vite 会自动换端口,也可手动指定:npm run dev -- --port 8080。
  • 安装缓慢:可把 npm 镜像切换到国内源后重新 install。
  • Node 版本过低:Vite 5 要求 Node 18+,过低会直接报错并提示升级。

小结

记住三步:npm create vue@latest → npm install → npm run dev。项目创建好后,下一节讲解工程里各个文件分别承担什么职责。

笔记加载中…