本周要回答: 能在自己的开发窗口里运行,与别人按说明就能使用,差了哪些步骤?
进入本周前: 已有一个小页面或本地工具,知道如何运行测试、检查网络和回退代码。
- 01锁定构建输入
- 02生成发布包
- 03干净环境验证
- 04演练回滚
学习内容与理解目标
本周区分开发服务、生产构建和发布版本。学习构建输入、依赖锁定、环境配置、最小相关检查与版本说明;发布不必等于公开上线,本地可运行包也是合格交付。能够交付一个普通工具,是后面部署 agent 的基础。
验证分层即可:核心逻辑用快速单元测试,界面做一条重要流程检查,发布前从干净环境启动。不要把每个 CSS 调整都升级成全站截图矩阵,也不要依赖“agent 说所有测试通过”。保留真实命令、退出结果和必要日志,而不是补写一个想象中的验收报告。
学习链接与选读范围
| 级别 | 官方或原始资料 | 本周只读这些 | 阅读预算 |
|---|---|---|---|
| 必读 | R05 · MIT Missing Semester:Shipping Code | 构建、版本与交付的相关部分。 | 45 分钟 |
| 必读 | R30 · Node.js:Learn | 运行环境与项目启动相关章节;静态项目只读所需部分。 | 35 分钟 |
| 选读 | R35 · W3C WAI:Web Accessibility Tutorials | 页面结构与表单反馈,用核心流程做一次检查。 | 40 分钟 |
实战拆解
选择一种交付:离线页面、本地命令行包,或仅含合成数据的私有测试站。没有实际需要,就不要同时发布三个平台。
写一个新人能照着执行的启动流程,明确版本、依赖、必要配置和离线限制;缺少配置时应清楚报错,不默认连接真实外部服务。
执行与改动范围相关的最小检查,再从新的目录或干净环境打开发布产物。对比开发版与发布版的核心行为,检查有没有测试数据混入。
保存一个已验证的版本和一份简短变更说明;实际回退一次。如果涉及数据结构变化,说明仅回退代码是否足够,必要时还要恢复数据。
做一次发布前内容审查:源文件、压缩包目录、截图、日志、构建文件、隐藏文件与代码历史。只把读者真正需要的文件纳入发布包。
交付与验收
| 本周交付 | 怎样确认真的完成 |
|---|---|
| 可使用的发布产物 | 从干净环境按说明运行,真实走完一条核心流程。 |
| 验收记录 | 明确已执行与未执行项目,不能用“应该通过”代替结果。 |
| 恢复路径 | 版本回退经过操作验证,数据迁移风险有说明。 |
不用代码生成器的练习: 自己制造一项无害的配置缺失,读错误并恢复;不用让模型重新生成整个项目。
隐私与安全检查: 不公开上传 .env、真实数据库、日志、聊天记录、浏览器导出或整个工作目录。公开地址不是私有认证;开发服务器也不应不加限制地暴露到外网。发布前排查方法可参考 R64 · GitHub:Removing sensitive data from a repository。
落到日常生活: 连续使用至少两次,记录你是否仍需要回到开发工具才能完成日常操作。减少对开发环境的依赖,是从玩具转成工具的标志。
过关或补课判断: 第三方或未来的自己能照说明运行、出错能停止、版本能恢复,即通过第一阶段。没有做到时先缩小交付范围,不进入复杂 agent 部署。
本周可复制的协作提示
请围绕当前最小工具制作一个可复现发布版本,仅执行与改动相关的检查。列清已验证、未验证、启动和回滚方法,检查发布内容是否含私人数据。不要公开部署,也不要大规模重构。
本周来源与核对范围
来源编号与核对说明沿用课程原文,基线为 2026-09-27。未逐一登录完成外部实验;实施前请核对最新版本与访问条件。
- R05MIT Missing Semester:Shipping Code ↗
2026 讲义;选构建、交付与版本相关部分。
- R30Node.js:Learn ↗
运行环境、异步与 HTTP 相关材料;使用实施时仍受支持的版本。
- R35W3C WAI:Web Accessibility Tutorials ↗
选表单标签、页面结构、键盘与反馈。
- R64GitHub:Removing sensitive data from a repository ↗
先撤销或轮换泄露凭据,再处理历史;无法承诺清除所有副本。