第2章 前端工程与 Vue
上一章我们知道了请求要经过哪些站点。这一章先不写后端,把前端工程跑起来:装环境、建项目、改第一个页面,再用构建命令生成可以部署的静态文件。
你会遇到 Node、npm、Vite、Vue 这几个名字。先把它们的关系说清楚:
- Node.js:让 JavaScript 脱离浏览器运行的环境,也是前端工具链的运行基础;
- npm:Node 自带的包管理器,用来安装 Vue、Vite、axios 等依赖;
- Vite:开发服务器 + 构建工具,负责把
.vue文件编译成浏览器能运行的 JS/CSS; - Vue:页面框架,负责组件、模板、响应式数据。
2.1 安装 Node.js 与检查环境
到 nodejs.org 下载 LTS 版本。安装时保持默认选项,Windows 用户勾选“Add to PATH”。安装完重新打开终端,执行:
能输出版本号即可。若提示“不是内部或外部命令”,通常是安装后没有重开终端,或者 PATH 没配好。
把 npm 的下载源换成国内镜像(可选,网络正常时不需要):
2.2 用 Vite 创建第一个项目
新建一个专门放项目的目录,例如 D:\workspace,在终端进入该目录,执行:
命令的含义:用 Vite 创建一个名为 learning-front 的项目,模板是 Vue;进入目录;安装依赖;启动开发服务器。
终端会输出一个本地地址,通常是 http://localhost:5173。打开浏览器能看到 Vite + Vue 的欢迎页,说明环境通了。
2.3 认识目录:哪些文件该改,哪些不要动
创建出来的项目大致如下。刚开始只需要关注 src 和 index.html。
| 路径 | 作用 | 是否常改 |
|---|---|---|
| index.html | HTML 入口,里面只有 | 偶尔 |
| src/main.js | 创建 Vue 应用、挂载路由、引入全局样式 | 会 |
| src/App.vue | 根组件,通常放布局与 | 会 |
| src/components/ | 可复用组件 | 会 |
| src/views/ | 路由页面 | 会 |
| src/assets/ | 图片、字体等会被构建处理的资源 | 会 |
| vite.config.js | 开发服务器、代理、别名 | 按需 |
| package.json | 依赖与脚本 | 按需 |
2.4 入口文件与根组件
打开 src/main.js,Vite 模板默认是这样:
createApp(App) 创建应用,mount('#app') 把它挂到 index.html 里的 #app 上。之后页面上看到的所有内容,都是组件渲染出来的。
把 src/App.vue 改成下面这样,先做一个最小的学习平台首页:
保存后浏览器会自动刷新。{{ title }} 是插值,@click 是事件绑定,ref 是 Vue 3 的组合式 API。这里先用最小例子感受“数据变、页面变”,第 3 章会系统讲模板。
2.5 组件不是越多越好
把页面拆成组件,是为了让每一块“独立变化”。例如导航栏在多个页面出现,就适合做成 SiteHeader;课程卡片在列表和搜索结果里都用,就适合做成 CourseCard。如果一个块只出现一次、也没有独立逻辑,先留在页面里,等它真的变大再拆。
这段代码已经包含了后面要讲的三个核心:组件导入、v-for 循环、props 传值。现在看不懂没关系,先知道“页面是由组件拼起来的”。
2.6 开发服务器与构建产物
npm run dev 启动的是开发服务器,带热更新,适合写代码。它不能直接上线。上线前要执行:
构建结果在 dist/,里面是压缩后的 HTML、CSS、JS 和静态资源。这个目录才是 Nginx 要托管的东西。可以用下面的命令本地预览构建结果:
| 命令 | 用途 | 产物 |
|---|---|---|
| npm run dev | 开发,热更新 | 内存中的开发服务器 |
| npm run build | 生产构建 | dist/ 目录 |
| npm run preview | 本地预览构建结果 | 临时静态服务器 |
2.7 用 Git 留下退路
在项目根目录执行:
每次完成一个可运行的小功能就提交一次。不要等到“全部写完”才提交;一旦改坏,你至少能回到上一个能跑的版本。课程后面会频繁改代码,这个习惯比任何技巧都重要。
2.8 常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| npm 不是内部命令 | Node 没装或没进 PATH | 重装 Node,重开终端 |
| 端口被占用 | 5173 已被其他进程使用 | 按终端提示换端口,或结束占用进程 |
| 页面空白 | 入口挂载失败或组件报错 | 看浏览器 Console 第一条红色错误 |
| 改代码不刷新 | 开发服务器没启动/已退出 | 重新 npm run dev |
| npm install 很慢 | 网络或镜像问题 | 换镜像,删除 node_modules 后重装 |
2.9 本章练习
- 把
App.vue的标题改成你的名字,增加一个“学习进度”变量,用插值显示。 - 新建
src/components/SiteHeader.vue,放一个导航栏,在App.vue里引入。 - 执行
npm run build,打开dist/index.html看看为什么不能直接双击运行(提示:看浏览器 Console 的资源路径)。
下一章进入 Vue 的模板系统:数据怎么显示、怎么绑定到输入框、怎么根据条件切换内容。
《前后端穿透》课程目录
从浏览器里的一次点击出发,把 Vue 3 前端、Spring Boot 后端、MySQL 与 Nginx 串成一条完整链路