更换博客系统，从Typecho更换到Astro

夏叶

Hello World!

统计加载中...

公告

欢迎来到我的博客！

了解更多

989 字

5 分钟

更换博客系统，从Typecho更换到Astro

2025-09-09

实用技巧

/

博客

统计加载中...

前言#

博客已经建立7年了，最开始是使用WordPress，但后面因为太臃肿，最后更换了Typecho已经5年时间，其中换过好几个域名。

那么现在为什么要更换呢？今年看见了Astro这个框架，同时看见了Fuwari这个非常符合我审美的模板，我决定将博客更换到 Astro。

Astro是一个静态博客系统，使用Astro + Markdown + GitHub Pages进行搭建，使用Obsidian + Markdown进行文章编写，使用Astro进行博客渲染，有一些前端经验的我很容易上手修改一些想自定义的内容，使用基于Fuwari二次开发的Mizuki作为博客模板，同时我也是Mizuki维护者之一。

而博客构建托管使用的是腾讯云的EdgeOne Pages服务，CDN加速，以及全球的边缘节点，保证用户访问速度。且减少了购买服务器的成本。

链接#

Fuwari开源地址： https://github.com/saicaca/fuwari

Mizuki开源地址：https://github.com/matsuzaka-yuki/mizuki

导出Typecho文章#

首先需要将 Typecho 的数据导出并转换为 Markdown 格式，这里我们使用更简单的一个方法，使用PHP脚本直接从 Typecho 数据库导出文章。

复制下方代码在typecho网站根目录创建converter.php文件

1
<?php
2
// 启用错误显示，方便调试
3
error_reporting(E_ALL);
4
ini_set('display_errors', 1);
5

6
// 数据库配置
7
$dsn = 'mysql:host=localhost;dbname=数据库名';//数据源
8
$user = '数据库用户名';
9
$pwd = '数据库密码';
10

11
try {
12
    // 连接数据库，添加错误模式
13
    $pdo = new PDO($dsn, $user, $pwd, [
14
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
15
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
16
    ]);
17
    echo "数据库连接成功！\n";
18

19
    // 检查并创建posts目录
20
    if (!is_dir('posts')) {
21
        if (!mkdir('posts', 0755, true)) {
22
            throw new Exception("无法创建posts目录");
23
        }
24
        echo "已创建posts目录\n";
25
    }
26

27
    $sql = "
28
    SELECT
29
        c.title,
30
        c.text,
31
        c.slug,
32
        c.created,
33
        c.modified,
34
        GROUP_CONCAT(DISTINCT t.name) as tags
35
    FROM typecho_contents c
36
    LEFT JOIN typecho_relationships r ON c.cid = r.cid
37
    LEFT JOIN typecho_metas t ON r.mid = t.mid AND t.type = 'tag'
38
    WHERE c.type = 'post' AND c.status = 'publish'
39
    GROUP BY c.cid
40
    ORDER BY c.created DESC
41
    ";
42

43
    $stmt = $pdo->query($sql);
44
    $posts = $stmt->fetchAll();
45

46
    if (empty($posts)) {
47
        echo "没有找到需要导出的文章\n";
48
        exit;
49
    }
50

51
    echo "找到 " . count($posts) . " 篇文章，开始导出...\n";
52

53
    foreach ($posts as $index => $post) {
54
        // 使用标题作为文件名
55
        $filename = sanitize_filename($post['title']);
56

57
        // Windows系统下转换文件名编码为GBK，解决乱码问题
58
        if (strpos(PHP_OS, "WIN") !== false) {
59
            $filename = iconv("UTF-8", "GBK//IGNORE", $filename);
60
        }
61

62
        // 确保文件名唯一
63
        $originalFilename = $filename;
64
        $counter = 1;
65
        $fullPath = "posts/{$filename}.md";
66
        while (file_exists($fullPath)) {
67
            $filename = $originalFilename . "-" . $counter++;
68
            $fullPath = "posts/{$filename}.md";
69
        }
70

71
        // 处理日期
72
        $pubDate = date('Y-m-d', $post['created']);
73
        $updatedDate = date('Y-m-d', $post['modified']);
74

75
        // 处理标签
76
        $tags = $post['tags'] ? explode(',', $post['tags']) : [];
77
        // 转义标签中的特殊字符
78
        $tags = array_map(function($tag) {
79
            return addslashes($tag);
80
        }, $tags);
81

82
        // 构建frontmatter
83
        $frontmatter = "---\n";
84
        $frontmatter .= "title: \"" . addslashes($post['title']) . "\"\n";
85
        $frontmatter .= "published: $pubDate\n";
86
        $frontmatter .= "description: \"\"\n";
87
        $frontmatter .= "tags: [\"" . implode('", "', $tags) . "\"]\n";
88
        $frontmatter .= "category: \"\"\n";
89
        $frontmatter .= "draft: false\n";
90
        $frontmatter .= "---\n\n";
91

92
        // 组合内容
93
        $content = $frontmatter . $post['text'];
94

95
        // 写入文件
96
        $result = file_put_contents($fullPath, $content);
97
        if ($result === false) {
98
            throw new Exception("无法写入文件: " . $fullPath);
99
        }
100

101
        echo "已导出 " . ($index + 1) . "/" . count($posts) . ": " . $post['title'] . "\n";
102
    }
103

104
    echo "所有文章导出完成！\n";
105

106
} catch (PDOException $e) {
107
    die("数据库错误: " . $e->getMessage() . "\n");
108
} catch (Exception $e) {
109
    die("错误: " . $e->getMessage() . "\n");
110
}
111

112
/**
113
 * 清理文件名，移除特殊字符和路径分隔符
114
 */
115
function sanitize_filename($filename) {
116
    // 替换所有不允许的字符，特别是路径分隔符/和\
117
    $invalidChars = array(" ", "?", "\\", "/", ":", "|", "*", "\"", "<", ">");
118
    $filename = str_replace($invalidChars, '-', $filename);
119
    // 移除连续的短横线
120
    $filename = preg_replace('/-+/', '-', $filename);
121
    // 限制文件名长度，避免过长
122
    $maxLength = 100;
123
    if (strlen($filename) > $maxLength) {
124
        $filename = substr($filename, 0, $maxLength);
125
    }
126
    // 移除首尾的短横线
127
    return trim($filename, '-');
128
}
129
?>