点此查看 所有教程、项目、源码导航
文章目录
-
- [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 下载与安装
- 官网地址:https://nodejs.org/
- 版本选择:推荐 LTS长期支持版,版本 18 及以上,稳定性更好。
- 下载对应系统安装包(Windows / Mac),一路下一步默认安装即可。
安装完成后,打开终端(cmd、PowerShell或者vscode终端),输入下面两条命令验证是否安装成功:
shell
node -v
npm -v
如果输出版本号,代表安装成功;提示命令不存在,说明安装失败或者环境变量没配置好。如下图:

4. 创建Vite+Vue项目
打开终端,执行创建项目命令:
shell
npm create vite@latest
执行之后,终端会交互式选择,按下面的选项选择:
- 项目名称:自定义,例如
vue-demo - 选择框架:选
Vue - 选择变体:选
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':引入根组件AppcreateApp(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. 本篇小结
- Node.js 是本地JS运行环境,NPM是自带的包管理器,用来管理前端依赖。
- 安装Node LTS版本,通过
node -v、npm -v验证安装。 - 企业开发使用Vite创建Vue项目,核心流程:创建项目 → 安装依赖 → 启动dev服务。
- 重点记住几个核心文件:index.html、main.js、App.vue。
.vue单文件组件,分为 template、script setup、style 三部分。