当前位置：首页 > news >正文

从零开始搭建一个 Vue 3 + Vite 的项目

news 来源：原创 2025/6/19 9:24:27

使用 Vite 搭建一个基于 Vue 3 的新项目非常简单。Vite 是一个现代化的前端构建工具，它提供了极快的冷启动和热更新速度，非常适合开发 Vue 3 项目。

以下是详细的步骤，帮助你从零开始搭建一个 Vue 3 + Vite 的项目：

1. 安装 Node.js 和 npm

确保你的开发环境已经安装了 Node.js 和 npm。你可以通过以下命令检查是否已安装：

node -v
npm -v

如果尚未安装，请前往 Node.js 官网下载并安装。

2. 创建项目

使用 Vite 提供的命令行工具创建新项目。打开终端或命令行工具，运行以下命令：

npm create vite@latest my-vue3-vite-project -- --template vue

my-vue3-vite-project 是你的项目名称。
--template vue 指定使用 Vue 3 的模板。

如果你想要使用 TypeScript，可以将模板改为 vue-ts：

npm create vite@latest my-vue3-vite-project -- --template vue-ts

3. 进入项目目录

cd my-vue3-vite-project

4. 安装依赖

安装项目所需的依赖：

npm install

5. 启动开发服务器

运行以下命令启动开发服务器：

npm run dev

Vite 会自动启动开发服务器，并在浏览器中打开项目。默认地址通常是 http://localhost:3000。

6. 项目结构

创建完成后，你的项目目录结构大致如下：

my-vue3-vite-project/
├── node_modules/
├── public/
│   └── vite.svg
├── src/
│   ├── assets/
│   │   └── logo.svg
│   ├── components/
│   │   └── HelloWorld.vue
│   ├── App.vue
│   ├── main.js
│   └── vite-env.d.ts
├── .gitignore
├── index.html
├── package.json
├── tsconfig.json
└── vite.config.js

7. 项目文件说明

src/main.js：项目的入口文件，负责挂载 Vue 应用。
src/App.vue：根组件，是整个应用的入口组件。
src/components/HelloWorld.vue：一个示例组件。
vite.config.js：Vite 的配置文件。
package.json：项目的依赖和脚本配置。

8. 编写代码

修改 `src/App.vue`

<template>
  <div class="app">
    <h1>{{ message }}</h1>
    <HelloWorld :msg="message" />
  </div>
</template>

<script>
import HelloWorld from './components/HelloWorld.vue';

export default {
  name: 'App',
  components: {
    HelloWorld
  },
  data() {
    return {
      message: 'Hello Vue 3 + Vite!'
    };
  }
};
</script>

<style>
.app {
  text-align: center;
  margin-top: 50px;
}
</style>

修改 `src/components/HelloWorld.vue`

<template>
  <div class="hello">
    <h2>{{ msg }}</h2>
  </div>
</template>

<script>
export default {
  name: 'HelloWorld',
  props: {
    msg: {
      type: String,
      required: true
    }
  }
};
</script>

<style scoped>
.hello {
  color: #42b983;
}
</style>