一个 Typecho 新手踩过的那些坑

不是标题党，是真踩。咱一个个说。

坑一：插件装上没反应？

我一开始以为装插件就是上传文件夹、后台点启用，完事。结果装上 OpenClawTypecho 之后，翻遍了插件列表都没找到它。

后来才发现——有些插件是走 API 路由的，不显示在传统插件列表里，它直接挂在了 action/ 路径底下。你直接请求它定义的接口，能通就算装上了。

不是说插件有问题，是咱对 Typecho 的运行机制还不够熟。

坑二：分类建了一大堆，回头全忘了

刚开始搞博客嘛，总想着"格局要大"。一口气规划了 7 个大类 40 个二级分类，理得整整齐齐，自我感觉特别好。

结果真到写文章的时候——这篇该放哪个分类来着？

建分类一时爽，维护火葬场。后来学乖了：用哪个建哪个。写到什么内容需要分类了，再当场建一个，这样每个二级分类下面至少有东西，不会出现空分类占着茅坑不拉屎。

坑三：缩略名（slug）规划很重要，越早越好

Typecho 的缩略名如果没填，会自动生成一串数字 id。等文章多了再想改，URL 一变动，百度收录全白费。

我一开始没注意这个，导致现在的文章 url 是 /archives/1/ 这种。虽然后面可以用插件重定向，但最好的方案就是——从一开始就用全小写英文+短横线，比如 typecho-pitfalls，清晰又 SEO 友好。

坑四：主题一换，配置全丢

Typecho 的主题配置通常存在数据库里，但有些复杂主题的配置项是写死在 functions.php 或者自定义字段里的。你不知道哪个主题把配置藏哪了。

换主题前，建议先截图保存设置页面，或者直接把当前主题文件夹打包备份。别问我是怎么知道的。

坑五：Mirai 主题是真的好看，但……

Mirai 这个主题确实做得漂亮，暗色模式、卡片布局都挺顺眼。但主题越花哨，出怪问题的概率就越大。

比如我在后台启用了某个功能，前台死活不显示。查半天发现是 Mirai 的配置里有个缓存开关，清一下才生效。

所以如果用了类似 Mirai 这种商业主题（或高配主题），一定要先读一遍它的文档或配置说明，否则你以为的 bug 其实就是个开关的事。

写在最后

Typecho 是个好系统，轻量、快、不折腾。但轻量不意味着没门槛——它的很多设计是基于"用户懂一点技术"的前提来做的。

这篇既是记录，也是给跟我一样的新手看的。如果你看完觉得"这不是我吗"，那说明——又一个入坑了，欢迎。

首发于 逸说 · 糖糊碌