前端工程化 / 系统课时

掌握常用命令与生命周期

掌握常用命令与生命周期

本课通过同一个最小项目观察 dev、build 与 preview 的执行差异。你将看到每条命令何时读取配置、是否生成 dist,以及为什么本地预览成功仍不能把 vite preview 当作生产服务器。

学习目标

  • 区分开发服务、生产构建和本地预览的职责
  • 使用配置函数识别 command、mode 与 isPreview
  • 按正确顺序构建、预览并验证生产产物

三个命令分别做什么

npm 脚本 Vite 命令 核心职责 是否写入 dist
npm run dev vite 启动开发服务器,按需处理模块并提供热更新 否
npm run build vite build 以生产构建方式处理入口和依赖,生成可部署产物 是
npm run preview vite preview 在本地读取已有构建目录并提供静态预览 否

dev 面向开发循环,源文件变化后由开发服务器即时响应;build 执行一次性生产构建并退出;preview 只检查已有产物的实际访问效果,不会替你重新构建。

Vite dev、build、preview 生命周期与读写对象

用配置日志观察加载时机

在项目根目录新建 vite.config.js。配置导出函数会在 Vite 解析配置时执行,并打印当前命令环境。

js
import { defineConfig } from 'vite'

export default defineConfig(({ command, mode, isPreview }) => {
  // command 只能区分 serve 与 build,preview 需要结合 isPreview 判断。
  console.log(
    `[vite-config] command=${command} mode=${mode} preview=${isPreview === true}`,
  )

  return {
    server: {
      host: '127.0.0.1',
    },
    preview: {
      host: '127.0.0.1',
    },
  }
})

这是完整配置文件。保存后,下面三条命令都会重新加载它;配置日志应出现在各自的启动或构建输出中。

运行开发服务器

执行开发命令,观察配置参数和本地地址。服务启动后按 Ctrl+C 结束,避免占用终端。

bash
npm run dev

预期输出

text
[vite-config] command=serve mode=development preview=false
VITE v<VITE_VERSION> ready in <TIME> ms
Local: http://127.0.0.1:<PORT>/

开发阶段的 command 是 serve,默认 mode 是 development。这一过程不会创建生产用 dist,浏览器访问的是开发服务器即时处理的模块。

构建生产产物

执行构建命令。它读取同一份配置和 HTML 入口,将处理后的文件写入默认构建目录 dist,完成后自动退出。

bash
npm run build

预期输出

text
[vite-config] command=build mode=production preview=false
transforming...
✓ <MODULE_COUNT> modules transformed.
dist/index.html <SIZE>
✓ built in <TIME>

模块数、文件大小和耗时取决于项目内容。构建成功的关键证据是命令退出码为 0,且 dist/index.html 与相关静态资源已经生成。

预览已有产物

必须先成功执行构建,再启动预览。示例显式指定 production 模式,使配置日志更容易核对。

bash
npm run preview -- --mode production

预期输出

text
[vite-config] command=serve mode=production preview=true
Local: http://127.0.0.1:<PORT>/

打开终端给出的地址,页面内容应来自 dist。修改 src 后直接刷新预览页面不会得到新代码,因为 preview 不执行构建;需要重新运行 npm run build。

生命周期边界与排障顺序

在配置函数中,开发服务和本地预览的 command 都是 serve,因此不能只写 command === 'serve' 来判断预览。需要预览专属逻辑时,应同时检查 isPreview === true;生产构建则使用 command === 'build'。

常见问题可按以下顺序处理:

  • preview 提示找不到构建目录:先运行 npm run build
  • 预览内容仍是旧版本:停止预览,重新构建,再启动预览
  • 配置日志没有出现:确认命令在项目根目录执行,并检查配置文件名与语法
  • 端口与预期不一致:以终端输出为准;需要固定端口时再配置 server.port 或 preview.port
  • 准备正式部署:部署 dist 到经过生产配置的静态服务器或托管平台,不使用 vite preview 承担线上流量
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

掌握常用命令与生命周期

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通