第2章 前端工程与 Vue

第 2 节 / 共 17 节 课程:前后端穿透

上一章我们知道了请求要经过哪些站点。这一章先不写后端,把前端工程跑起来:装环境、建项目、改第一个页面,再用构建命令生成可以部署的静态文件。

你会遇到 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”。安装完重新打开终端,执行:

node -v
npm -v

能输出版本号即可。若提示“不是内部或外部命令”,通常是安装后没有重开终端,或者 PATH 没配好。

把 npm 的下载源换成国内镜像(可选,网络正常时不需要):

npm config set registry https://registry.npmmirror.com

2.2 用 Vite 创建第一个项目

新建一个专门放项目的目录,例如 D:\workspace,在终端进入该目录,执行:

npm create vite@latest learning-front -- --template vue
cd learning-front
npm install
npm run dev

命令的含义:用 Vite 创建一个名为 learning-front 的项目,模板是 Vue;进入目录;安装依赖;启动开发服务器。

终端会输出一个本地地址,通常是 http://localhost:5173。打开浏览器能看到 Vite + Vue 的欢迎页,说明环境通了。

Vite 5 要求 Node 18 及以上;Vite 6/7 要求更高。课程以 Vite 5 + Node 20 LTS 为基准。若命令报 Node 版本不满足,先升级 Node,而不是改项目配置。

2.3 认识目录:哪些文件该改,哪些不要动

创建出来的项目大致如下。刚开始只需要关注 src 和 index.html。

前端工程 learning-front后端工程 learning-apisrc/main.jsApp.vuerouter/index.jsviews/ 页面components/ 组件api/ axios 封装vite.config.jspackage.jsonsrc/main/java/.../controller/service/repository/entity/resources/application.propertiespom.xml页面只做展示和交互接口只做业务和数据目录分开,责任才分得开;不要在前端写 SQL,也不要在 Controller 里拼页面。
图 2-1 两个工程、两条边界
路径作用是否常改
index.htmlHTML 入口,里面只有
偶尔
src/main.js创建 Vue 应用、挂载路由、引入全局样式会
src/App.vue根组件,通常放布局与 会
src/components/可复用组件会
src/views/路由页面会
src/assets/图片、字体等会被构建处理的资源会
vite.config.js开发服务器、代理、别名按需
package.json依赖与脚本按需

2.4 入口文件与根组件

打开 src/main.js,Vite 模板默认是这样:

import { createApp } from 'vue'
import './style.css'
import App from './App.vue'
 
createApp(App).mount('#app')

createApp(App) 创建应用,mount('#app') 把它挂到 index.html 里的 #app 上。之后页面上看到的所有内容,都是组件渲染出来的。

把 src/App.vue 改成下面这样,先做一个最小的学习平台首页:

<template>
  <main class="page">
    <h1>{{ title }}</h1>
    <p>{{ subtitle }}</p>
    <button @click="count++">点击 {{ count }} 次</button>
  </main>
</template>
 
<script setup>
import { ref } from 'vue'
 
const title = ref('前后端穿透')
const subtitle = ref('从一次请求开始,理解完整链路')
const count = ref(0)
</script>
 
<style scoped>
.page { max-width: 760px; margin: 60px auto; font-family: system-ui, sans-serif; }
h1 { color: #173a6b; }
button { padding: 8px 16px; border-radius: 6px; border: 1px solid #1a73e8; background: #fff; color: #1a73e8; }
</style>

保存后浏览器会自动刷新。{{ title }} 是插值,@click 是事件绑定,ref 是 Vue 3 的组合式 API。这里先用最小例子感受“数据变、页面变”,第 3 章会系统讲模板。

2.5 组件不是越多越好

把页面拆成组件,是为了让每一块“独立变化”。例如导航栏在多个页面出现,就适合做成 SiteHeader;课程卡片在列表和搜索结果里都用,就适合做成 CourseCard。如果一个块只出现一次、也没有独立逻辑,先留在页面里,等它真的变大再拆。

<script setup>
import SiteHeader from './components/SiteHeader.vue'
import CourseCard from './components/CourseCard.vue'
 
const courses = [
  { id: 1, name: 'Java程序设计', bref: '从语法到项目' },
  { id: 39, name: '前后端穿透', bref: 'Vue + Spring Boot' }
]
</script>
 
<template>
  <SiteHeader />
  <main class="list">
    <CourseCard v-for="c in courses" :key="c.id" :course="c" />
  </main>
</template>

这段代码已经包含了后面要讲的三个核心:组件导入、v-for 循环、props 传值。现在看不懂没关系,先知道“页面是由组件拼起来的”。

2.6 开发服务器与构建产物

npm run dev 启动的是开发服务器,带热更新,适合写代码。它不能直接上线。上线前要执行:

npm run build

构建结果在 dist/,里面是压缩后的 HTML、CSS、JS 和静态资源。这个目录才是 Nginx 要托管的东西。可以用下面的命令本地预览构建结果:

npm run preview
命令用途产物
npm run dev开发,热更新内存中的开发服务器
npm run build生产构建dist/ 目录
npm run preview本地预览构建结果临时静态服务器

2.7 用 Git 留下退路

在项目根目录执行:

git init
git add .
git commit -m "init: vite + vue"

每次完成一个可运行的小功能就提交一次。不要等到“全部写完”才提交;一旦改坏,你至少能回到上一个能跑的版本。课程后面会频繁改代码,这个习惯比任何技巧都重要。

2.8 常见问题

现象原因处理
npm 不是内部命令Node 没装或没进 PATH重装 Node,重开终端
端口被占用5173 已被其他进程使用按终端提示换端口,或结束占用进程
页面空白入口挂载失败或组件报错看浏览器 Console 第一条红色错误
改代码不刷新开发服务器没启动/已退出重新 npm run dev
npm install 很慢网络或镜像问题换镜像,删除 node_modules 后重装

2.9 本章练习

  1. 把 App.vue 的标题改成你的名字,增加一个“学习进度”变量,用插值显示。
  2. 新建 src/components/SiteHeader.vue,放一个导航栏,在 App.vue 里引入。
  3. 执行 npm run build,打开 dist/index.html 看看为什么不能直接双击运行(提示:看浏览器 Console 的资源路径)。

下一章进入 Vue 的模板系统:数据怎么显示、怎么绑定到输入框、怎么根据条件切换内容。