Typecho：PHP 轻量博客程序安装与主题插件使用指南
Typecho 是一款基于 PHP 的博客程序，设计目标是成为「世界上最强大的博客引擎」。它在国内开发者中口碑极佳，占用资源小、运行轻快，支持多数据库、Markdown、插件与主题体系，是搭建个人博客的经典选择。
一、项目官方信息
| 项目 | 信息 |
|---|---|
| GitHub 仓库 | https://github.com/typecho/typecho |
| 官方网站 | https://typecho.org |
| 开源协议 | GNU General Public License 2.0 |
| 主要语言 | PHP（约 77.7%） |
| Star 数 | 12k+ |
说明：Typecho 官方仓库早已由原 zncoder 组织迁移为
typecho/typecho，本文使用官方仓库。
二、官方图片
Typecho 官方主题截图：
三、环境要求
- PHP 7.4.0 或更高版本；
- 数据库（任选其一）：MariaDB / MySQL 5.5.3+、SQLite 3.7.11+、PostgreSQL 9.1+；
- Web 服务器：Nginx / Apache（提供 PHP 解析）；
- 目录权限：安装与上传目录可写。
四、部署步骤
1. 下载程序
从官方仓库或官网下载 Typecho 源码包，解压后得到完整程序目录。
2. 上传到 Web 目录
把解压后的所有文件上传到 Nginx/Apache 的网站根目录（例如 /var/www/typecho）。
3. 准备数据库
在 MySQL/MariaDB 中新建一个数据库（或使用 SQLite 数据库文件），记下数据库名、用户名、密码。
4. 运行安装向导
浏览器访问你的域名，Typecho 会自动进入安装向导。向导会引导你：
- 填写数据库信息（数据库类型、主机、库名、用户名、密码）；
- 设置博客名称、站点地址、管理员账号与密码；
- 完成安装并生成配置。
5. 伪静态（Nginx）
Nginx 下为后台与伪静态配置 rewrite，保证文章/页面链接可正常访问（具体规则见官方文档）。
五、使用方法
- 发布文章：登录后台
/admin，撰写文章，支持 Markdown，可设置分类、标签、自定义页面； - 主题：把主题目录放入
usr/themes/，在后台「外观」中启用；官方与社区提供大量主题； - 插件：把插件放入
usr/plugins/，在后台「插件」中启用；插件可扩展评论、SEO、缓存等功能； - 自定义字段：文章支持自定义字段，满足个性化内容展示；
- 多数据库：可在 MySQL / MariaDB / SQLite / PostgreSQL 之间切换。
六、常见问题 FAQ
Q1：安装向导页面打不开？ 确认 PHP 版本 >= 7.4、网站根目录指向正确，且 PHP 已开启相关扩展。
Q2：数据库连接失败？ 核对数据库类型、主机、库名、用户名、密码；MySQL 需先手动建库；SQLite 需指定可写的文件路径。
Q3：主题/插件放哪？
主题放 usr/themes/，插件放 usr/plugins/，然后在后台对应页面启用。
Q4：支持哪些数据库？ MariaDB、MySQL（5.5.3+）、SQLite（3.7.11+）、PostgreSQL（9.1+）。
Q5：PHP 版本要求？ PHP 7.4.0 或更高。
Q6：链接 404 / 伪静态怎么配？ Nginx 需要配置 rewrite 规则（见官方文档），让文章与自定义页面的路由正确解析。
七、跳转链接
- GitHub 仓库：https://github.com/typecho/typecho
- 官方网站：https://typecho.org