跳到正文

构建

Build

中级通用

构建(Build)是把项目源代码、资源和配置处理成可运行或可发布产物的过程。它解决的是开发文件不能直接作为交付物使用的问题;例如把网站代码打包成可供服务器托管的文件。

你可能会说:「我写好的网站在本地能跑,想让它变成可以放到服务器上的文件。」

读之前建议先了解

动手看看

构建输入项目文件构建工具读取项目发布目录尚无产物托管服务器尚未部署
1

准备上线商品展示页,点击开始构建。工具先读取页面源码、商品图片和配置,确定要处理哪些文件。

要点

  1. 1

    输入是代码、资源和配置

    你写的组件、样式、图片会作为构建输入,配置则告诉工具从哪里开始处理、产物放到哪里。依赖也可能参与其中,所以同一份代码在不同配置下,构建结果可能不同。

  2. 2

    工具按项目需要处理文件

    构建可能包括编译、合并文件、压缩资源或检查类型,但不是每个项目都会做完这些事。比如网站项目可能把多份前端代码整理成浏览器能加载的文件。

  3. 3

    产物是这次构建的结果

    构建完成后,你通常会得到一组文件或一个可执行程序。先看构建有没有报错,再看产物是否符合预期;命令执行成功,只说明这一步完成了,不代表页面和功能都正常。

容易混淆的地方

构建处理的是项目文件,运行则是让程序实际工作;一个项目构建成功,运行时仍可能因接口或配置出错。部署上线是把产物放到用户能访问的环境中,通常发生在构建之后,但构建本身不会自动让用户看到新版。

什么时候用

适合用

  • 你和 AI Agent 做完网站功能,准备把代码变成可托管的文件,先执行项目的构建命令并检查产物。
  • 你修改了 App 代码,想生成供测试人员安装的版本,需要通过构建得到对应安装包。
  • 你准备发布后台服务,想在部署前确认代码能否生成可运行的程序或文件。

不适合用

  • 你只是在已经上线的网站后台修改一段文章内容,保存并发布内容即可,不必重新构建网站代码。
  • 你只想在浏览器里打开一个独立的 HTML 文件查看排版,直接打开文件即可,不必先引入构建流程。
  • 页面已经上线,但某个接口偶尔报错;这时先查运行日志和接口响应,重新构建不能代替排查。

练一练

你让 AI Agent 修改了网站首页,代码在本地开发服务中显示正常。接下来要把新版交给托管平台,哪一步最符合“构建”的含义?

让 AI 帮你做

请先查看这个项目的配置,找出实际的构建命令和产物位置,再执行构建。若失败,请根据报错定位原因并修复;若成功,请说明生成了什么、是否还需要测试,以及后续该部署哪些文件。不要把启动开发服务当成构建。

接下来学什么