React / 系统课时

构建发布与课程总结

构建发布与课程总结

这一节把一个已经能在开发环境运行的 React 项目收尾到“可发布”状态:生成生产构建、在本地模拟部署环境、检查静态资源与路由风险,并把后续学习重点整理成可执行方向。完成后,你应该能判断项目是否真的具备上线条件,而不只是“本机能跑”。

学习目标

  • 能使用项目现有脚本生成并检查 React 生产构建
  • 能在发布前验证静态资源、环境变量与前端路由
  • 能根据当前能力选择性能、状态管理、测试与工程化方向继续学习

生成生产构建

以常见的 Vite React 项目为例,先确认依赖已经安装,再执行构建脚本。生产构建会进行模块打包、资源压缩和文件名哈希,默认输出到 dist 目录。

bash
npm install
npm run build

预期输出

text
> <PROJECT>@<VERSION> build
> vite build

vite <VERSION> building for production...
✓ <COUNT> modules transformed.
dist/index.html                   <SIZE>
dist/assets/index-<ID>.css        <SIZE>
dist/assets/index-<ID>.js         <SIZE>
✓ built in <TIME>

<VERSION>、<COUNT>、<SIZE>、<ID> 和 <TIME> 会随项目、依赖版本与机器性能变化。真正需要确认的是命令以成功状态结束,并且生成了 dist/index.html 与对应静态资源。

在本地模拟发布结果

构建成功并不等于页面一定可用。继续用项目提供的预览服务器加载 dist,这样可以更接近静态托管后的访问方式。

bash
npm run preview -- --host 127.0.0.1

预期输出

text
> <PROJECT>@<VERSION> preview
> vite preview --host 127.0.0.1

Local: http://127.0.0.1:<PORT>/

打开输出中的地址后,至少验证首页能加载、核心交互可执行、刷新后控制台没有新的资源 404。<PORT> 由本地环境决定,实际值可能不同。

发布前检查关键风险

React 项目上线失败,很多时候不是组件代码报错,而是开发环境与部署环境存在差异。发布前优先检查以下几类问题:

  • 环境变量:只把允许暴露给浏览器的值注入前端。以 Vite 为例,客户端可访问变量通常使用 VITE_ 前缀;密钥和数据库凭据不能进入前端构建。
  • 资源路径:如果应用部署在子路径而不是域名根目录,需要确认构建工具的基础路径配置正确,否则 JS、CSS 和图片可能返回 404。
  • 前端路由:使用 React Router 的单页应用在直接访问 /users/42 这类地址时,服务器需要把未知前端路由回退到 index.html,否则刷新可能得到 404。
  • 接口地址:开发代理只在本地开发服务器中生效。生产环境要使用真实 API 地址、反向代理或同域网关配置。
  • 构建产物:不要把 src 源码目录直接当作静态站点发布;部署对象应是构建后的输出目录。

如果托管平台支持构建配置,通常应把构建命令设置为 npm run build,发布目录设置为 dist。不同平台的字段名称可能不同,但这两个信息的含义一致。

用一次验收代替“感觉没问题”

发布前可以用一个最小验收闭环判断是否达到交付标准:重新安装依赖、完成生产构建、本地预览、访问核心页面,再检查浏览器控制台和网络请求。只要其中一步依赖了本机临时状态,就说明项目还不够可复现。

接下来重点学什么

完成 React 基础项目后,不必一次追完所有生态工具。更有效的顺序是先补齐当前项目最明显的短板:组件越来越难维护时学习组件设计与状态建模;跨页面数据复杂时学习 Context 或状态库;接口请求增多时学习数据获取与缓存;担心回归时加入组件测试和端到端测试;首屏或交互变慢时再系统学习代码分割、懒加载与性能分析。

真正完成一次 React 项目,不是停在“页面写完”,而是能够从源码稳定地产生构建产物、解释部署所需条件,并在新环境中重复验证结果。做到这一点,后续学习才会从零散 API 记忆转向可维护、可测试、可发布的前端工程能力。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

构建发布与课程总结

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

登录哪都通