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。项目创建好后,下一节讲解工程里各个文件分别承担什么职责。