🛠️ 从零到一：Typecho 的安装、迁移与版本更新指南

无论你是第一次接触 Typecho 的小白，还是打算从旧版本升级的老用户，这篇指南都能帮你避开那些“隐藏的坑”。

一、 环境准备 (The Prerequisites)

在开始之前，请确保你的服务器环境满足以下最低要求：

  • PHP: 7.4 或更高版本（推荐 PHP 8.0+，性能更强）。
  • 数据库: MySQL, PostgreSQL 或 SQLite。
  • Web 服务器: Nginx 或 Apache。

二、 全新安装：只需三步

Typecho 的安装过程以“极简”著称，通常只需几分钟。

  1. 下载源码：前往 Typecho 官网 或 GitHub 下载最新稳定版。
  2. 上传并解压：将压缩包上传至网站根目录，解压。

  3. 配置权限：

    • 确保 usr/uploads 目录有写入权限（通常是 755 或 777）。
    • 访问你的域名，跟随安装向导填写数据库信息。
💡 小贴士：如果安装时提示“无法连接数据库”，请检查你的数据库地址（localhost 或 127.0.0.1）以及用户名密码是否正确。

三、 版本更新：安全升级不丢数据

如果你收到系统提醒有新版本（例如从 1.2.0 升级到 1.2.1），请遵循以下流程，千万不要直接覆盖所有文件！

1. 备份（最重要的第一步）

  • 数据库：进入 phpMyAdmin 导出数据库。
  • 文件：备份整个 usr/ 目录。这里面藏着你的主题、插件和附件。

2. 删除旧文件

除了 usr/ 目录和 config.inc.php 文件，删除根目录下的其他所有文件和文件夹（包括 admin/, var/, index.php 等）。

3. 上传新版本

将新版本的压缩包解压，剔除掉新包里的 usr/ 目录，然后将剩余文件上传到服务器。

4. 完成升级

登录后台，系统可能会提示“检测到新版本，是否执行升级程序？”，点击确认即可。

四、 常见问题及避坑指南

  • 开启伪静态：安装后发现除了首页外其他页面都 404？记得在 Web 服务器（如 Nginx）中配置 Rewrite 规则。
  • 插件冲突：更新后如果后台报错，尝试重命名 usr/plugins 文件夹来禁用所有插件，排查是否有插件不兼容新版本 PHP 或 Typecho。

结语：
Typecho 的魅力在于它的纯粹。虽然现在有很多静态博客工具，但这种“动态的心，静态的魂”的体验，依然是写作的最佳选择。

如果你在安装过程中遇到了报错代码，或者想知道如何配置 Nginx 的伪静态规则，可以把具体的错误提示发给我，我帮你瞧瞧！