Typecho主题制作全攻略：零基础到独立开发你的专属博客主题

52JinY 助手

说真的，我最开始接触Typecho主题制作的时候，完全是被逼出来的。用了几个现成主题，不是这里看着不顺眼，就是那里功能缺一块，改别人的代码又总是牵一发动全身，改到最后自己都不知道动了哪里。于是狠下心，从零开始自己撸一套。

先说一个很多新手忽视的基础——Typecho的主题系统其实相当轻量，入门门槛没你想象的那么高。你需要做的第一件事，是在 usr/themes/ 目录下新建一个文件夹，名字就是你主题的标识符。然后在这个文件夹里创建两个必须存在的文件：index.php 和 functions.php。没错，就这两个文件，Typecho就能识别你的主题。当然，光靠这两个文件做出来的主题是个空壳，但它能跑起来，这对新手来说是很重要的心理建设——你的代码是有效的，方向是对的。

functions.php 是整个主题的"神经中枢"，里面要写 themeConfig 函数来配置主题选项，还要写 themeInit 来做初始化操作。很多人一开始绕着这个文件走，觉得复杂，其实静下心来看，无非就是注册一些钩子、定义一些变量。Typecho提供的API文档虽然不算豪华，但基本的东西都有。我建议新手直接下载一个轻量级的开源主题，比如官方自带的那个 default 主题，对照着读，比单纯看文档要快得多。

模板文件的拆分是个很关键的设计决策。你可以只用一个 index.php 把所有逻辑塞进去，但这种写法维护起来是灾难。比较合理的做法是：index.php 处理首页列表，post.php 处理文章详情，page.php 处理独立页面，archive.php 处理归档，然后把公共的头部和底部抽出来放到 header.php 和 footer.php，用 $this->need() 方法来调用。这个结构清晰了，后面改起来才不会崩溃。

Typecho的模板变量语法也值得单独说一说。它用的是 $this 来调用各种输出方法，比如 $this->title() 输出文章标题，$this->content() 输出正文，$this->date() 输出时间。这些方法背后都有参数可以控制格式，多翻翻源码里的注释，很多细节都藏在里面。分页这个坑我当时踩了好久，后来发现直接调用 $this->pageNav() 就能解决大部分需求，不需要自己手写逻辑。

样式这一块，我个人建议不要一上来就堆一堆 CSS 框架。先用最原始的 HTML 结构把页面搭出来，确认数据都正确输出了，再考虑样式的事。很多人主题做一半发现布局有问题，回头一查，是模板逻辑本身就没写对，样式反而掩盖了问题。

最后想说的是，主题制作这件事说复杂也复杂，说简单也真的简单。复杂在于你想做出质感、做出细节，那需要对PHP、HTML、CSS都有一定积累；简单在于Typecho的架构足够清晰，不像WordPress那样层层嵌套让人头大。给自己定一个小目标，先做出一个能用的主题，哪怕丑一点，跑通整个流程才是最重要的。剩下的，慢慢打磨就是了。