15. 工具与资源索引 · 资料陈述 · 索引卡 1
开发与部署工具:按站型选择交付路径
静态内容、动态工具和CMS的运行时、数据、权限与部署要求不同,选错路径会增加故障和维护成本。
原知识点:讲者区分工具站与内容站:前者用功能完成任务,后者用信息覆盖问题,两者可组合但生产与变现模型不同。
执行步骤
- 写出用户最终拿到的是信息、浏览器内结果、服务端结果还是持续可编辑内容。
- 逐项回答是否需要服务端计算、数据库、登录、写入、定时任务、编辑后台和敏感密钥。
- 纯静态输出评估HTML/静态生成器+Pages;动态功能评估函数/应用运行时+数据服务;多人编辑再评估CMS。
- 在仓库固定运行时版本、安装/构建/测试命令、环境变量清单和产物目录。
- 创建预览部署,完成核心任务、404、移动端、权限和回滚验收后再进生产。
可复制工作表
任务:__ 用户交付物:__ 能力需求:服务端__|数据库__|登录/权限__|写入__|定时/队列__|编辑后台__|敏感密钥__ 候选路径|适用条件|运行时/版本|数据服务|部署产物|权限边界|维护/回滚|排除原因 静态/Pages|__|__|__|__|__|__|__ 动态函数/应用|__|__|__|__|__|__|__ CMS|__|__|__|__|__|__|__ 选择:__;依据:__ 仓库/分支:__;安装:__;构建:__;测试:__;产物目录:__ 环境变量:名称__|服务端/构建时__|来源__|轮换__ 预览验收:核心任务__|404__|移动端__|权限__|性能__ 生产:__;回滚点/命令:__;演练结果:__;返回章节:__。
完整示例
已填示例(这是一次可复现的站点交付记录,不代表排名或盈利):
任务=交付118张课程卡;服务端、数据库、登录、服务端写入、定时任务、后台和生产密钥均不需要。收藏、掌握、完成清单和笔记只写浏览器localStorage,不跨设备,清理站点数据会丢失;因此静态Pages通过,Workers+D1因无服务端写入需求排除,CMS因内容由Git审核排除。
代码证据:私库github.com/wwh66888/seo-shan-gold,基线提交321645f,Node 24.13.1。已登录GitHub的新目录复现命令=gh repo clone wwh66888/seo-shan-gold && cd seo-shan-gold && npm ci && npm test;测试生成dist/并通过内容、链接和路由校验。预览命令=npx serve dist -l 65337,本地URL=http://127.0.0.1:65337;生产URL=https://seo.shan.gold;Pages基线部署ID=ab24aa36,证据=validation/deployment/2026-08-01.md。
验收结果:核心学习主线18/18跳转、118/118卡片、404、390px移动端、无生产密钥均通过。实际回滚演练不切换当前工作区:先用git worktree add --detach /tmp/seo-shan-gold-baseline-321645f 321645f建立独立基线目录,基线提交没有第三方依赖且当时尚无lockfile,因此在该目录直接执行npm test,通过后再执行npx wrangler pages deploy dist --project-name seo-shan-gold --branch main并记录回滚部署ID;验证基线版本后回到已提交且干净的main工作区执行npm ci && npm test && npx wrangler pages deploy dist --project-name seo-shan-gold --branch main恢复新版,再验证生产域版本标识与浏览器审计。完成后用git worktree remove /tmp/seo-shan-gold-baseline-321645f移除临时工作树。所有部署ID、UTC时间和验证结果写入validation/deployment/2026-08-01.md。若以后增加账户、跨设备同步或服务端收藏,必须返回05/06/08/13章重新评估Workers+D1、数据库和权限边界。
完成清单
- 站型由真实运行时和编辑需求决定,不由流行框架决定。
- 新环境可按记录命令复现构建和测试。
- 秘密未进入仓库或浏览器静态包。
- 预览、生产、核心任务、404与回滚均有证据。
完成后返回
使用前先过门禁
当前官方依据
平台规则会变化,行动前以打开后的当前官方页面为准。
适用条件
选型取决于用户任务、技术成本和商业模式。
来源:哥飞:出海赚美元,养网站防老