typecho教程

Typecho 的安装包只有几百 KB，扔到服务器上解压，打开浏览器就能跑完安装向导。这套流程我重复过不下二十次，从虚拟主机到 VPS，从 PHP 5.6 到 8.2，它几乎没给过什么脸色看。对比隔壁 WordPress 动辄几十 MB 的体量和插件冲突，Typecho 的轻量是实打实的——数据库只建六七张表，前台查询通常个位数，打开速度肉眼可见地快。

但轻量不等于简陋。它的插件机制、主题模板、路由系统该有的都有，只是实现得克制。如果你写博客只是记录、分享，不折腾会员商城、多语言站群，Typecho 完全够用，甚至更省心。

先搞清楚目录结构

解压后的文件夹里，admin 是后台入口，var 存放核心代码和默认主题，usr 才是你真正要碰的地方——主题放 usr/themes，插件放 usr/plugins，上传的附件在 usr/uploads。这个划分比 WordPress 清爽得多，wp-content 里什么都往里塞，时间一长自己都分不清哪个文件夹是干嘛的。

安装时数据库前缀默认是 typecho_，如果你一个数据库要装多个程序，改掉它。其余信息按虚拟主机或 VPS 提供的填就行。有个坑：某些国内主机默认 PHP 版本过低，Typecho 1.2 要求 PHP 7.2 以上，装之前先确认版本，否则会卡在环境检测那一步，页面一片空白，什么提示都没有。

后台第一件事：改掉默认设置

登录 /admin/ 之后，别急着写文章。先去「设置」→「基本设置」把站点地址填对，带不带 www 要统一，否则前台样式可能加载不出来。再进「永久链接」把默认的 /index.php/archives/1/ 改成 /archives/1/ 这种干净形式，前提是服务器支持 rewrite。Apache 一般自动处理，Nginx 需要手动加一段 location 规则，官方文档里有现成的复制粘贴即可。

「评论」设置里建议开启审核，Typecho 默认没有验证码，垃圾评论会直接涌进来。装个 Typecho Comment Captcha 插件能挡掉大部分机器人，但别指望一劳永逸，手动删几条是常态。

换主题比装插件更影响观感

默认主题 default 能用，但太素。去 Typecho 官方论坛或 GitHub 搜「typecho theme」，挑个更新日期在近一年内的下载。解压后整个文件夹丢进 usr/themes，后台「外观」里就能看到并启用。注意有些主题依赖特定插件，比如 Links 或 Stat，作者会在 README 里写清楚，不装的话前台可能报错。

改主题别直接动源文件，Typecho 支持在 usr/themes/你的主题 下建一个 functions.php 写自定义函数，或者用「自定义 CSS」功能覆盖样式。这样主题更新时你的修改不会被冲掉，我吃过这个亏，手改的代码在升级后全没了。

插件装精不装多

必装的就几个：TeStore 用来在线安装主题插件，CodeHighlighter 给代码块上色，Mailer 让评论回复有邮件通知。其余按需，比如做图床加 Lsky Pro，要 SEO 加 Sitemap。装多了拖慢后台，Typecho 的插件生态本来就不大，挑口碑好的用就行。

有个细节：插件启用后如果前台白屏，多半是 PHP 版本不兼容或函数冲突。去 usr/plugins 把对应文件夹改名，后台会自动禁用，再进数据库把 typecho_options 表里 plugins 字段的值清空，就能恢复。

写文章时留意 Markdown 的脾气

Typecho 原生支持 Markdown，但它的解析器是 Parsedown，和 GitHub 的 CommonMark 有细微差别。比如表格语法必须前后空行，否则不渲染；HTML 标签默认转义，想嵌入视频得用 @ 开头的短代码或者装 MarkdownExtra 插件。我习惯在「撰写」页面右下角切换编辑器模式，纯文本写 Markdown，需要插图时切到「可视化」拖拽上传，两不耽误。

附件默认存在 usr/uploads，按年月分文件夹。如果你用 CDN 或者对象存储，装个 Typecho Upyun 之类的插件把上传路径改掉，否则图片多了备份起来很痛苦——我那个 2GB 的 uploads 文件夹，每次迁移都要传半小时。

Typecho 的更新频率不高，但每次版本升级都值得跟。1.2 到 1.3 隔了三年，修了一堆 PHP 8 的兼容问题。升级前备份数据库和 usr 目录，覆盖 admin 和 var 两个文件夹，访问 /admin/upgrade.php 点一下就行。整个过程五分钟，比 WordPress 的升级流程还无脑。

说到底，Typecho 适合那种「我就想安静写点东西」的人。它不逼你学习复杂的钩子体系，也不拿一堆营销弹窗烦你。装好、配好、写就是了。