## 一、功能概述
生成静态页面模块用于将动态页面输出为静态文件，以提升访问速度与稳定性。该模块适用于日常更新、专题上线、模板改版和全站发布场景。
## 二、界面结构与功能说明
页面包含统计区、快速生成区、按栏目生成区、进度区和日志区。可执行“生成首页”“生成栏目”“批量生成全部”“清理静态文件”等操作，日志用于排查失败原因。
## 三、标准发布流程
1. 发布前检查栏目和内容审核状态。
2. 选择策略：日常更新用增量，结构改版用全量。
3. 先生成首页，确认核心入口可访问。
4. 再生成栏目或执行全站生成。
5. 查看日志与进度，处理失败项。
6. 发布后抽检首页、重点栏目页和详情页。
## 四、增量与全量使用原则
增量生成适用于高频更新，可减少重复处理。全量生成适用于模板改版、结构调整和历史异常修复。建议以增量为常态、全量为补充。
## 五、清理静态文件规范
清理静态文件属于高风险操作，执行后历史文件会移除。仅建议在模板大改、目录调整或文件冲突时使用。清理后必须立即执行全量生成，避免前台缺页。
## 六、发布窗口建议
建议将静态生成安排在固定发布窗口执行，避免与后台结构调整并行。
日常发布可按“首页-重点栏目-全站补齐”的顺序执行，优先保证核心流量入口可用。
重大活动上线前建议预留抽检时间，至少覆盖首页、活动页、详情页三类关键页面。
若站点更新频率高，可建立“增量日更、全量周更”的节奏，平衡效率与稳定性。
## 七、异常处理建议
单栏目失败时先记录并单独重试；首页成功但栏目失败时先保证首页可用，再分批修复；任务变慢可拆分栏目错峰执行；多次失败需检查模板、栏目配置和路径权限。
## 八、常见问题处理
问题一：已生成但前台仍显示旧内容。检查浏览器缓存、CDN缓存及静态文件更新时间。
问题二：全量生成耗时过长。建议拆分栏目分批执行，优先处理高访问栏目。
问题三：日志无报错但页面样式异常。检查模板文件引用路径与静态资源是否完整。
问题四：清理后出现缺页。立即执行全量生成并按栏目补齐缺失页面。
