帝国CMS静态生成从零到一，手把手搭站，避开90%新手踩过的坑

刚接触帝国CMS、想用静态生成提高网站速度的站长；会复制粘贴但不懂底层逻辑的入门者；以及被“动态页面卡成乌龟”逼疯的强迫症患者，本文默认你会用FTP上传文件，知道域名和服务器是怎么回事，如果你连这些都没概念，建议先花一小时补基础,再回来。

为什么非要用静态生成？

动态页面每次访问都要查数据库、跑PHP，一旦流量上来，CPU直接拉满，页面打开像放PPT，帝国CMS的静态生成功能，能把文章、栏目甚至首页全部“拍扁”成纯HTML文件，访问时服务器只负责发文件，连数据库都不用碰，速度？那是质的飞跃，但很多人一看到“生成”两个字就犯怵，其实真没那么玄乎，跟着下面步骤走,半小时内你就能跑通。

完整搭建步骤（以Apache+PHP7.4为例）

第一步：装好帝国CMS
下载帝国CMS最新版，解压到网站根目录，浏览器访问你的域名，按提示填写数据库信息，完成安装，这里提醒一句：安装时给你的数据库前缀默认是empire_，别手贱改,后面省心。

第二步：进入后台，找到“静态生成”入口
登录后台，左侧菜单栏找“系统设置”下的“静态生成”，你会看到一堆选项，别慌，核心就三个：首页生成、栏目页生成、内容页生成，先什么都不动，直接点“生成首页”，去网站根目录看，是不是多了一个index.html？如果是，恭喜,静态生成已经活了。

帝国CMS静态生成从零到一，手把手搭站，避开90%新手踩过的坑

第三步：配置栏目和内容页规则
在“静态生成”页面上方有“栏目页生成规则”和“内容页生成规则”，默认是/listinfo-{栏目ID}-{页数}.html和/showinfo-{文章ID}-{栏目ID}.html,建议改成更友好的SEO结构，

• 栏目页：/channel/{栏目拼音}/ 或 /list-{栏目ID}/页：/article/{文章ID}.html 修改后，必须在“系统设置→URL设置”里同步更新,否则路径对不上。

第四步：批量生成整个站点
在“静态生成”页面下方，有“生成栏目页”和“生成内容页”的按钮，先点“生成栏目页”，选择全部栏目，确认生成，再点“生成内容页”，同样全选，点击“生成”，如果文章多，页面可能会卡，这是正常的,千万别关浏览器。

第五步：设置自动更新
动态站每次发文章会自动更新页面，静态站则要手动触发，在“静态生成”页面找到“同步生成”功能，勾选“发表文章时自动生成当前栏目页和内容页”，保存，这样后面发新文章，帝国CMS会自动生成对应的HTML,不用你再手动跑全站。

不可忽略的配置要点

生成目录权限
静态文件要写入服务器磁盘，Nginx/Apache的运行用户必须对根目录有写权限，命令就一句：chmod -R 755 /你的网站根目录，但注意，有些主机商把用户组隔离了，你得在FTP软件里把“权限”改成可写，常见错误是改完根目录忘了改/d（数据）和/e（扩展）目录，导致生成时报“无法写入”。

伪静态和静态混用的坑
如果你既要静态生成，又要保留动态接口，比如搜索、标签页，这些无法静态化，必须伪静态，帝国CMS的伪静态规则在后台“系统设置→URL设置”里选择“伪静态模式”，然后把.htaccess（Apache）或nginx.conf里的重写规则填好，纯静态生成才是真静态，伪静态只是“看起来像”,别混淆。

生成间隔与资源锁
后台“系统设置→系统参数设置→性能优化”里，有“生成静态页面间隔时间”，默认0秒，如果你的服务器是1核2G的小水管，建议改成200毫秒，不然一次生成500篇文章，CPU直接爆表，生成到一半超时失败,你哭都没地方哭。

常见踩坑提醒（全是血泪）

坑一：首页怎么生成都没变化
你改了首页模板，点“生成首页”，浏览器一刷新还是老样子，排查顺序：第一步，清空浏览器缓存，别用Ctrl+F5，直接开无痕窗口；第二步，看根目录index.html的时间戳是否更新；第三步，如果时间戳没变，去后台看“生成首页”时有没有报错，多半是模板里有PHP函数解析失败，把报错贴出来逐行排查，帝国CMS的默认首页文件名是index.html，但如果你开启了“列表页伪静态”，服务器会优先读index.php，你需要删掉或改名index.php才能生效,否则永远显示动态页。

坑二：生成内容页时“无法获取内容”或空白页
这是最经典的新手坑，原因基本都是模板变量写错，特别是自定义字段，打开内容页模板，检查有没有类似[!show_field_自定义字段!]的标签，如果字段名对不上，生成时直接跳过，解决方法：后台“模板管理→内容模板”，先复制一份默认模板，改一个字段，生成一篇测试文章,成功后再批量改。

坑三：栏目页生成数量不全
栏目下有5页文章，但生成栏目录只出第1页，这是“栏目页生成规则”里的“最多生成页数”被你填了1，去“静态生成→栏目页生成规则→每栏目生成页数”改成0（代表全部）,再重新生成。

坑四：静态生成后数据更新不同步
用户评论、投稿这类动态功能，不会自动写进HTML，如果你启用“文章评论”，生成的内容页评论区域是空的，因为评论是动态读取的，解决方案：评论还是用动态加载（iframe或Ajax），或者去掉评论功能，专心做内容展示，别想着把评论也静态化,那不是帝国CMS该干的事。

坑五：更换服务器后路径全乱
帝国CMS的静态文件里存的是绝对路径，你从/www换到/home，所有图片、链接全部404，必须重新生成全站，搬家后别偷懒，后台点“数据更新→更新所有页面”,重新跑一遍。

最后一句

静态生成是帝国CMS的看家本领，但不是无脑点“生成”就完事，你只要记住：模板决定输出，规则决定路径，权限决定能不能写，今天教你的这套流程，是自己写过上百个企业站、资讯站后沉淀出来的“不走弯路”版本，按着做,你的网站也能快得飞起。