Codex 教程 05：在 CLI 里跑命令与修复失败（日志/重试/定位）
从命令输出中提炼可行动结论：如何读日志、怎么重试、何时停下并缩小范围。
你将学到什么
CLI 场景最常见的失败来自环境、依赖、路径与权限。本篇把排错流程写成“先看什么、再做什么、如何缩小范围”。
你将获得
- 可复用的模板
- 可执行的步骤
- 可验证的清单
- 可回滚的策略
适合人群
- 希望把 AI 变成稳定生产力的开发者
- 需要为团队沉淀规范的人
- 正在做多页面内容站/工程项目的人
命令执行三步法
- 1) 复现：用最小输入跑出同样的错误
- 2) 定位：读日志，找到第一处异常（不是最后一行）
- 3) 修复：最小改动 + 再跑一遍验证
日志阅读要点
- 优先看 Exit Code 与异常栈第一处
- 区分：编译错误 / 运行时错误 / 环境缺失
- 先解决阻断项，再处理警告与风格
典型命令模板
python build.py
python -m http.server 8000
检查输出页面数量与关键 meta
抽样打开 download.html / tutorial.html / tutorial-01.html检查清单
通用验收清单
- 导航链接：点击可达、无同内容页面、无死链
- SEO：每页独立 title/description/keywords/canonical/og/robots
- 结构：H1 仅一个，H2/H3 语义清晰，段落足够长
- 性能：图片本地 webp + lazy-load + decoding=async
- 可维护：内容/模板集中管理，支持批量重建
前置条件与准备
- 明确当前页面/功能的‘唯一主题’（避免同质化）
- 准备一份验收清单（SEO/链接/内容/性能）
- 所有外链优先指向官方或可验证来源
- 每次改动都能重新生成并抽样检查关键页面
练习与作业
练习 A（10 分钟）
为站点新增一个‘专题页’，要求包含：表格 + FAQ + 相关链接。
练习 B（30 分钟）
为该专题页补齐 SEO meta，并将其加入站点地图与教程中心的相关链接。
相关链接
高频问答
如何判断页面内容是否足够‘丰富’？
至少包含：清晰的 H2/H3、多个段落、可执行步骤、示例/命令/表格/FAQ，并且与主题强相关。
为什么布局要做差异化？
布局差异化能降低模板感，提升阅读体验；同时让搜索引擎更容易区分页面意图与主题。
如何保持资料‘最新’？
关键链接与规格尽量指向官方来源；页面标注更新时间，并定期检查外链与版本信息。
如何避免‘越写越宽、越看越累’？
用更窄的内容容器（max-w-6xl/5xl）、更好的行高、更多分段与模块化卡片，让长文更精致。
进阶扩展
下一步建议：把本教程里的‘模板/清单/示例’固化为仓库内的文档与脚本。这样任何人接手都能按同一标准生成页面、校验 SEO、检查链接与内容密度，并持续扩展长尾专题。
