创建 Vue 3 项目的方式有几种常见的路径,分别使用官方的 Vue CLI、Vite、以及手动配置项目等。以下是详细步骤和说明:
1. 使用 Vue CLI 创建 Vue 3 项目
Vue CLI 是 Vue.js 官方提供的脚手架工具,能够帮助你快速创建一个基于 Vue 3 的项目,适合大型项目的结构化开发。
步骤:
-
安装 Vue CLI(如果未安装):
Vue CLI 是一个全局工具,可以通过 npm 或 yarn 安装。
npm install -g @vue/cli
-
创建 Vue 3 项目:
使用
vue create
命令并指定项目名称:vue create my-vue3-project
-
选择 Vue 3:
在创建项目时,CLI 会询问是否使用默认的 Vue 3 版本。你可以选择默认设置,或手动进行一些配置(如选择
Vue 3
,配置 TypeScript、Router 等)。? Please pick a preset:Default ([Vue 3] babel, eslint)Manually select features
-
启动项目:
进入项目目录后,运行开发服务器:
cd my-vue3-project npm run serve
项目结构:
通过 Vue CLI 创建的项目结构中,包含了基本的 Vue 3 文件配置、目录结构、vue.config.js
文件等,可以用于更复杂的项目设置。
2. 使用 Vite 创建 Vue 3 项目
Vite 是一个新型的构建工具,它在开发过程中提供了极快的热更新体验。Vue 3 的作者尤雨溪也推荐 Vite 作为 Vue 3 项目的构建工具。
步骤:
-
安装 Vite:
使用
npm
或yarn
创建 Vite 项目。Vite 提供了官方模板,可以直接选择 Vue 3 项目模板。npm create vite@latest
-
选择模板:
在运行命令后,它会让你选择项目模板。选择
vue
或vue-ts
(带 TypeScript 支持)的模板。? Select a framework:- vanilla- vue- vue-ts (with TypeScript support)- react- react-ts
-
安装依赖:
进入项目目录后,安装依赖:
cd my-vue3-vite-project npm install
-
运行项目:
启动开发服务器:
npm run dev
项目结构:
通过 Vite 创建的项目更加轻量,启动速度更快,开发体验流畅,特别适合现代前端项目的快速开发。
3. 手动配置 Vue 3 项目
如果你不想使用 Vue CLI 或 Vite,可以手动配置一个 Vue 3 项目。这种方式适合一些有定制化需求的小型项目或特定的构建工具要求。
步骤:
-
初始化项目:
使用 npm 或 yarn 初始化一个新的 Node.js 项目:
npm init -y
-
安装 Vue 3:
安装 Vue 3 和其他所需的依赖:
npm install vue@next
-
安装开发服务器和构建工具:
安装 Webpack 或 Parcel 等构建工具。如果选择 Webpack,可以安装
webpack
、webpack-cli
、webpack-dev-server
等必要的依赖:npm install webpack webpack-cli webpack-dev-server --save-dev
-
创建项目文件:
创建一个基础的项目文件结构:
index.html
:作为入口文件。main.js
:作为 Vue 实例的启动文件。App.vue
:作为主 Vue 组件。
<!-- index.html --> <div id="app"></div> <script src="/main.js"></script>
// main.js import { createApp } from 'vue'; import App from './App.vue';createApp(App).mount('#app');
<!-- App.vue --> <template><div><h1>Hello Vue 3!</h1></div> </template><script> export default {name: 'App' }; </script>
-
启动开发服务器:
根据所选的构建工具配置 webpack 或 Parcel,启动开发服务器。
4. 使用 @vitejs/plugin-vue
创建 Vue 3 项目
Vite 支持 Vue 3 项目创建的核心插件是 @vitejs/plugin-vue
。如果你想在现有的 Vite 项目中手动添加 Vue 3 支持,可以使用此插件。
步骤:
-
安装 Vite 和 Vue 插件:
在现有项目中,安装 Vite 和 Vue 插件:
npm install vite @vitejs/plugin-vue
-
配置 Vite:
在
vite.config.js
文件中,配置 Vue 插件:import { defineConfig } from 'vite'; import vue from '@vitejs/plugin-vue';export default defineConfig({plugins: [vue()] });
-
启动开发服务器:
使用
npm run dev
启动开发服务器。
5. Vue 3 生态扩展:Router、Vuex、Pinia
在创建 Vue 3 项目后,你可以根据项目需要安装相关的扩展包,如 Vue Router、状态管理库(Vuex 或 Pinia)等:
安装 Vue Router 4:
npm install vue-router@4
安装 Vuex 4:
npm install vuex@next
或使用 Vue 3 官方推荐的轻量化状态管理工具 Pinia:
npm install pinia
总结
- Vue CLI 是官方推荐的方式,适合大型、复杂项目,支持多种插件和配置。
- Vite 是 Vue 3 的现代开发工具,速度快,适合快速开发和现代化的开发体验,特别推荐。
- 手动配置 适合定制化需求的项目,可以灵活选择工具和配置方案。
这几种方式都能帮助你快速上手 Vue 3,根据你的项目需求选择合适的创建方式。