前端工程化 / 系统课时
掌握常用命令与生命周期
掌握常用命令与生命周期
本课通过同一个最小项目观察 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.config.js。配置导出函数会在 Vite 解析配置时执行,并打印当前命令环境。
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 结束,避免占用终端。
npm run dev预期输出
[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,完成后自动退出。
npm run build预期输出
[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 模式,使配置日志更容易核对。
npm run preview -- --mode production预期输出
[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承担线上流量