副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构

点此查看 所有教程、项目、源码导航

文章目录

    • [1. 本篇说明](#1. 本篇说明)
    • [2. Node.js 和 NPM 基础介绍](#2. Node.js 和 NPM 基础介绍)
      • [2.1 什么是 Node.js](#2.1 什么是 Node.js)
      • [2.2 什么是 NPM](#2.2 什么是 NPM)
    • [3. Node.js 下载与安装](#3. Node.js 下载与安装)
    • [4. 创建Vite+Vue项目](#4. 创建Vite+Vue项目)
    • [5. 项目目录整体介绍](#5. 项目目录整体介绍)
    • [6. 核心文件逐一说清楚](#6. 核心文件逐一说清楚)
      • [6.1 index.html](#6.1 index.html)
      • [6.2 src/main.js](#6.2 src/main.js)
      • [6.3 src/App.vue](#6.3 src/App.vue)
      • [6.4 package.json](#6.4 package.json)
    • [7. 什么是热更新](#7. 什么是热更新)
    • [8. 本篇小结](#8. 本篇小结)

1. 本篇说明

前面我们了解了前端框架的发展背景,从本篇开始,正式进入企业标准开发方式。

真实工作里,Vue3项目基本都是基于Vite搭建工程化项目。Vite是Vue官方推荐的构建工具,启动速度快、开发体验好,是目前Vue3项目的主流选择。

想要使用Vite、npm命令,前提是电脑上装好 Node.js。

2. Node.js 和 NPM 基础介绍

2.1 什么是 Node.js

Node.js 是一个可以在电脑本地运行JS的运行环境。

平时我们写的JS,只能交给浏览器执行;安装Node之后,脱离浏览器,操作系统也能执行JS代码。

前端工程化里,Vite、打包、依赖管理这些工具,本质都是JS写的,需要Node环境才能跑起来。

2.2 什么是 NPM

NPM 是 Node.js 自带的包管理器,全称 Node Package Manager。

它相当于一个前端代码仓库平台,上面有海量开源工具、框架库(vue、axios等)。

我们可以通过npm命令,实现这些能力:

  • 下载、安装第三方依赖包
  • 记录项目用到哪些包以及版本
  • 运行项目脚本(启动开发服务、打包上线)

小提示:安装Node.js的时候,会自动附带npm,不需要单独下载npm。

3. Node.js 下载与安装

  1. 官网地址:https://nodejs.org/
  2. 版本选择:推荐 LTS长期支持版,版本 18 及以上,稳定性更好。
  3. 下载对应系统安装包(Windows / Mac),一路下一步默认安装即可。

安装完成后,打开终端(cmd、PowerShell或者vscode终端),输入下面两条命令验证是否安装成功:

shell 复制代码
node -v
npm -v

如果输出版本号,代表安装成功;提示命令不存在,说明安装失败或者环境变量没配置好。如下图:

4. 创建Vite+Vue项目

打开终端,执行创建项目命令:

shell 复制代码
npm create vite@latest

执行之后,终端会交互式选择,按下面的选项选择:

  1. 项目名称:自定义,例如 vue-demo
  2. 选择框架:选 Vue
  3. 选择变体:选 JavaScript(先不用TS,降低入门难度)

如下图,依次按提示选择:

项目创建完成后,终端会给出后续操作指令。注意很多时候,会卡在上面的界面,此时可以关闭控制台,然后进入vue-demo目录运行如下命令:

shell 复制代码
cd vue-demo
npm install
npm run dev

命令简单解释

  • cd vue-demo:进入刚刚创建好的项目文件夹
  • npm install:读取package.json里的依赖列表,自动下载所有依赖包
  • npm run dev:启动本地开发服务,开启热更新

启动成功后,终端会输出本地访问地址,一般是 http://localhost:5173,浏览器打开这个链接就能预览页面。

如下图:

此时我们打开浏览器访问提示的地址http://localhost:5173,已经显示默认的Vue项目页面了。

5. 项目目录整体介绍

我们展开生成的项目文件夹,重点看核心文件,无关配置暂时跳过。

使用VSCode打开项目如下图:

具体解释如下:

复制代码
vue-demo
├── node_modules        # 存放所有下载的依赖包,不要手动修改
├── public              # 静态资源,不会经过Vite打包处理
├── src                 # 源代码目录,我们写代码主要在这里
│   ├── assets          # 静态资源:图片、字体等
│   ├── components      # 存放Vue组件(后续我们会大量写组件)
│   ├── App.vue         # 根组件
│   └── main.js         # 入口文件,Vue应用创建与挂载
├── .gitignore          # git忽略文件配置
├── index.html          # 项目入口html
├── package.json        # 项目配置、依赖、脚本命令
└── vite.config.js      # Vite的配置文件

6. 核心文件逐一说清楚

6.1 index.html

整个项目唯一的html入口文件。

里面有一个 id="app" 的空div,Vue最终会挂载到这个节点上。

6.2 src/main.js

整个项目的JS入口,Vue应用在这里创建、挂载。

js 复制代码
import { createApp } from 'vue'
import App from './App.vue'

createApp(App).mount('#app')

代码说明:

  • import { createApp } from 'vue':引入创建Vue应用的方法
  • import App from './App.vue':引入根组件App
  • createApp(App):基于App组件创建Vue实例
  • .mount('#app'):挂载到index.html里面id为app的DOM

6.3 src/App.vue

Vue单文件组件,后缀 .vue,这是工程化开发最核心的东西。

一个vue文件分为三块:

  • <template>:模板,写页面结构
  • <script setup>:js逻辑,我们全程使用这个语法
  • <style>:样式,可以加上 scoped,让样式只在当前组件生效,不会污染全局

打开默认的App.vue,可以看到自带示例代码,我们后面会逐步修改它。

6.4 package.json

记录项目信息、依赖版本、脚本命令。

scripts 里面的 dev、build 就是我们用npm run执行的命令。

  • npm run dev:开发环境,本地调试、热更新
  • npm run build:打包,生成上线的dist文件夹

7. 什么是热更新

启动dev服务之后,我们修改src里面的代码,保存,浏览器页面自动更新,不需要手动刷新页面。

这就是工程化带来的开发体验提升。

8. 本篇小结

  1. Node.js 是本地JS运行环境,NPM是自带的包管理器,用来管理前端依赖。
  2. 安装Node LTS版本,通过 node -v、npm -v 验证安装。
  3. 企业开发使用Vite创建Vue项目,核心流程:创建项目 → 安装依赖 → 启动dev服务。
  4. 重点记住几个核心文件:index.html、main.js、App.vue。
  5. .vue 单文件组件,分为 template、script setup、style 三部分。
相关推荐
濮水大叔15 分钟前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart1 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt2 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑3 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星3 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson3 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼4 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊4 小时前
CNC计算机数控加工模拟器
前端
张一凡934 小时前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent