因为Typecho的机制，页面、附件都要占cid。而且点击一次创建文章cid就会增加一次，即使你没有书写内容，那个cid也被认为已经使用了，所以下一次生成的cid就会跳过那个，造成不连续。

虽然不影响什么，也无关紧要，但是对于有强迫症的人来说，真的是无法忍受，看到了非得给改一下不可。

**特别提醒：请在PHP 7以上版本的服务器上执行。本操作涉及数据库，请提前做好备份工作。**

## 文章cid

将以下代码保存为php文件并上传至网站根目录，在浏览器地址栏访问一下即可。

    <?php
    /**
    * Typecho重新排列文章cid让他连续
    */
    // 设置数据库参数
    $hostname_blog = "localhost";
    $database_blog = "数据库名";
    $username_blog = "数据库用户名";
    $password_blog = "数据库密码";
    // 连接到数据库
    $blog = mysqli_connect($hostname_blog, $username_blog, $password_blog, $database_blog) or die(mysqli_connect_error());
    // 设置计数器的初始值
    $no = 1;
    // 定义一个函数来更新文章cid
    function change_id($cid)
    {
    global $no, $blog;
    // 更新文章cid，并更新与类别、标签、自定义字段和评论的关系
    mysqli_query($blog, &quot;UPDATE typecho_contents SET cid = $no WHERE cid = $cid&quot;);
    mysqli_query($blog, &quot;UPDATE typecho_relationships SET cid = $no WHERE cid = $cid&quot;);
    mysqli_query($blog, &quot;UPDATE typecho_comments SET cid = $no WHERE cid = $cid&quot;);
    
    $no = $no + 1;
    
    }
    // 从数据库中选择所有文章cid，按其 cid 排序
    $query_postRecord = "SELECT cid FROM typecho_contents ORDER BY cid ASC";
    $result = mysqli_query($blog, $query_postRecord);
    // 循环浏览文章并更新其 cid
    while ($row = mysqli_fetch_assoc($result)) {
    change_id($row['cid']);
    }
    // 重置文章 cid 的自动递增值
    mysqli_query($blog, "ALTER TABLE typecho_contents AUTO_INCREMENT = $no");
    echo 'ok';
    ?>

Tips：文章cid重新排列后，上传的附件所属文章可能不正确，需手动修改。

## 分类标签mid

将以下代码保存为php文件并上传至网站根目录，在浏览器地址栏访问一下即可。

    <?php
    /**
    
    Typecho重新排列分类和标签（meta）不连续的mid
    */
    
    // 数据库参数
    $hostname_blog = "localhost";
    $database_blog = "数据库名";
    $username_blog = "数据库用户名";
    $password_blog = "数据库密码";
    $blog = new mysqli($hostname_blog, $username_blog, $password_blog, $database_blog);
    // 检查错误
    if ($blog->connect_error) {
    trigger_error($blog->connect_error, E_USER_ERROR);
    }
    // 定义全局变量以跟踪“no”值
    $no = 1;
    // 定义一个函数来更新 mid 及其关系
    function change_id($mid)
    {
    global $no;
    global $blog;
    // 更新mid
    $sql = &quot;UPDATE typecho_metas SET mid = ? WHERE mid = ?&quot;;
    $stmt = $blog-&gt;prepare($sql);
    $stmt-&gt;bind_param(&quot;ii&quot;, $no, $mid);
    $stmt-&gt;execute();
    
    // 更新关系
    $sql = &quot;UPDATE typecho_relationships SET mid = ? WHERE mid = ?&quot;;
    $stmt = $blog-&gt;prepare($sql);
    $stmt-&gt;bind_param(&quot;ii&quot;, $no, $mid);
    $stmt-&gt;execute();
    
    // 递增 no 值
    $no++;
    
    }
    // 从数据库中获取所有mid
    $query_postRecord = "SELECT mid FROM typecho_metas ORDER BY mid ASC";
    $all_postRecord = $blog->query($query_postRecord);
    // 循环遍历结果并调用 change_id() 函数
    while ($row_postRecord = $all_postRecord->fetch_assoc()) {
    change_id($row_postRecord['mid']);
    }
    // 重置typecho_metas表的自动增量值
    $blog->query("ALTER TABLE typecho_metas AUTO_INCREMENT = $no");
    echo 'ok';
    ?>


Typecho文章cid、分类标签mid不连续解决方案

从WordPress转到Typecho，首先要建立Typecho博客，建好后，首要的就是导入数据，这里选用Wordpress To Typecho插件直接将WordPress文章、评论、分类、标签等全部导入Typecho。

### 数据迁移

下载插件Wordpress To Typecho，并上传到 /usr/plugins 目录下。

这个插件是Typecho官方2014年前发布的，插件版本为(v1.0.3 Beta)，仅适用于WordPress 2.7，但实际上WordPress 6.3也能用。

1. 登录Typecho后台，进入菜单【控制台】→【插件】，将Wordpress to Typecho插件启用
2. 进入该插件的 设置 界面，填好WordPress所在数据库的地址、端口、用户名、密码、数据库名称、表前缀，并【保存设置】
3. 进入菜单【控制台】→【从Wordpress导入数据】，此时会看到导入提示界面，点击按钮【开始数据转换】即可
4. 当系统提示转换成功后，数据就全部迁移到了Typecho
5. 完成后，可以禁用或删除这个插件

如果转换失败，系统会给出失败原因，很多情况是因为数据库设置错误导致的，只需重新设置 WordPress 所在的数据库信息即可。

#### 可能出错

Wordpress to Typecho插件转换数据可能会出现database query error报错，需要把MySQL的严格模式关闭。

    mysql -u root -p
    SET GLOBAL sql_mode='';
    exit;

再次尝试数据转换，便可成功导入数据了。

### 还原文章图片、附件

1. 将WordPress的 wp-content/uploads 目录复制到Typecho的 usr/uploads 目录，注意保持目录结构不变
2. 利用SQL语句完成图片路径的替换：`update typecho_contents set text=replace(text,'wp-content/uploads', 'usr/uploads')`

### 新网站设置

导入数据库文件后，原来WordPress站点的文章、分类、标签、评论都完美导入到Typecho站点了，但网站标题、副标题等都没有，此时就需要在【设置】→【基本】中进行相应的设置。

#### 设置永久链接

Typecho设置永久链接后，需在服务器或者虚拟主机设置伪静态规则。

Apache环境下伪静态规则：

    <IfModule mod_rewrite.c>
        RewriteEngine On
        RewriteBase /
        RewriteRule ^index\.php$ - [L]
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . /index.php [L]
    </IfModule>

使用方法：在网站根目录创建.htaccess文件，将上述规则复制粘贴到.htaccess中即可。

### 其他问题

**Q1 这篇文章不是由Markdown语法创建的, 继续使用Markdown编辑它吗?**

出现这个问题有可能是，数据是从其他地方导过来的，文章正文开头缺乏一个特殊的语法内容：``。

这个语法内容决定了该篇文章是否采用Markdown语法进行解析。

**解决问题**：在未开启Markdown语法解析的文章正文开头都加入该语法内容：`update typecho_contents set text=concat('', TEXT);`。

**Q2 如何将JSON格式的数据导入到WordPress数据库中?**

**解决问题**：可以使用WP Import Export Lite插件将JSON格式的数据导入到WordPress数据库中。

以上就是从WordPress迁移到Typecho的整个过程。

WordPress迁移到Typecho全过程

## 本地开发环境

下载并安装Local：[https://localwp.com/](https://localwp.com/)

打开 Local，点击「+ Create a new site]，输入网站名称（例如：test），点击「Continue」->「Continue」，输入用户名、密码、邮箱，点击「Add Site」，稍等片刻，网站就安装完成了。

点击「Open site」，即可打开网站。

可能出现打不开网站的情况。如果之前安装过 VMware Workstation，端口 443 会存在冲突。打开「服务」应用，找到「VMware Workstation Server」，右键「属性]，启动类型改为「手动」。

## 创建新主题

在网站上右键「Go to site folder」，打开网站文件路径，进到`test/app/public/wp-content/themes`，新建文件夹（例如：mytheme），进入 mytheme/，新建文件 `index.php`、`style.css`，所有主题都需要这两个文件。

在文件style.css写入：

    /*
        Theme Name: My Theme
        Author: GAGA
        Version: 0.1
    */

在文件index.php写入：

    <?php
        while(have_posts()){
            the_post(); ?>
            <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
            <?php the_content(); ?>
            <hr>
        <?php }
    ?>

- have_posts() 检查当前页面是否有文章
- the_post() 显示全部文章
- the_permalink() 显示永久链接/URL地址
- the_title() 显示标题
- the_content() 显示内容
- the_excerpt() 显示文章摘要
- get_the_excerpt() 获取文章摘要

可以在主题目录创建一张图片重命名为`screenshot.png`或者`screenshot.jpg`，WordPress会自动读取该图片为主题的缩略图。

### 文章和页面

在主题目录创建文件`single.php`、`page.php`，分别是「文章」详情页模版文件和「页面」详情页模版文件。

在文件single.php和page.php写入：

    <?php
        while(have_posts()){
            the_post(); ?>
            <h2><?php the_title(); ?></h2>
            <?php the_content(); ?>
        <?php }
    ?>

#### 自定义页面模板

在主题目录创建文件`page-event.php`，作为event页面的模版文件。

### 页眉和页脚

在主题目录创建文件`header.php`、`footer.php`，分别用于显示网站页眉和页脚。

在文件header.php写入：

    <!DOCTYPE html>
    <html <?php language_attributes(); ?>>
    <head>
        <meta charset="<?php bloginfo('charset'); ?>">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <?php wp_head(); ?>
    </head>
    <body <?php body_class(); ?>>
        <h1>这里是页眉</h1>

在文件footer.php写入：

    <p>这里是页脚</p>
    <?php wp_footer(); ?>
    </body>
    </html>

- wp_head() 头部输出函数，很多插件依赖这个函数
- wp_footer() 尾部输出函数，很多插件依赖这个函数
- language_attributes() 显示html标签的语言属性
- bloginfo() 显示站点信息
- body_class() 用来给 body 标签添加类

文件index.php修改为：

    <?php
        get_header();
        while(have_posts()){
            the_post(); ?>
            <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
            <?php the_content(); ?>
            <hr>
        <?php }
        get_footer();
    ?>

文件single.php和page.php修改为：

    <?php
        get_header();
        while(have_posts()){
            the_post(); ?>
            <h2><?php the_title(); ?></h2>
            <?php the_content(); ?>
        <?php }
        get_footer();
    ?>

- get_header() 加载header.php文件
- get_footer() 加载footer.php文件

### 模版函数文件

在主题目录创建文件`functions.php`，这个是WordPress保留的函数文件，它专门用于添加各种自定义函数代码。

    <?php
    // 定义函数
    function my_files() {
        wp_enqueue_style('my_main_sytles', get_theme_file_uri('/static/css/main.css'));
        wp_enqueue_script('my_main_js', get_theme_file_uri('/static/js/index.js'));
    }
    // 绑定动作，把函数 my_files 挂载到 wp_enqueue_scripts 下面
    add_action('wp_enqueue_scripts', 'my_files');

- wp_enqueue_scripts 钩子用于前端排队脚本和样式，如果是在后台调用，使用 admin_enqueue_scripts 钩子
- wp_enqueue_style() 用于引入样式文件
- get_theme_file_uri() 获取主题目录，如果没有使用子主题，使用 get_template_directory_uri() 可获得更好性能
- wp_enqueue_script() 用于引入js文件

#### 添加主题功能

    function my_features() {
        add_theme_support('title-tag');
        register_nav_menu('headerMenu', 'Header Menu');
        register_nav_menu('footerMenu', 'Footer Menu');
    }
    add_action('after_setup_theme', 'my_features');

- add_theme_support() 自动生成页面标题信息（title-tag），如果想通过 hook 调用，则必须使用 after_setup_theme 这个钩子
- register_nav_menu() 注册一个菜单
- after_setup_theme 钩子在主题被初始化之后在每个页面加载期间被调用

### 主页显示

1、设置 -> 阅读 -> 您的主页显示：您的最新文章

模板文件的调用顺序：front-page.php > home.php > index.php

2、设置 -> 阅读 -> 您的主页显示：一个静态页面

页面为“主页”，模板文件的调用顺序：front-page.php > page.php > index.php

页面为“文章页”，模板文件的调用顺序：home.php -> index.php

模板文件index.php能不用就不用。如果打算只设置为“您的最新文章”，可以不用模板文件front-page.php，使用home.php即可；如果打算设置为“一个静态页面”，建议“主页”使用模板文件front-page.php，不要使用模板文件page.php。

### 存档页

archive.php：默认存档页模版文件。

## 主题模板文件

### 主模板

- index.php
- home.php
- single.php
- page.php
- archive.php
- search.php
- 404.php
- comment.php

### 二级模板

- front-page.php
- author.php
date.php
tag.php
category.php
taxonomy.php

- attachment.php
single-post.php

### 分部模板

- 页头 header.php -> get_header();
- 页脚 footer.php -> get_footer();
- 侧边栏 sidebar.php -> get_sidebar();
- 搜索框 searchform.php -> get_search_form();
- 评论 comments.php -> comments_template();
- 自定义模板 xxx.php -> get_template_part();

### 可变模板

- tag-$id.php
tag-1.php
tag-2.php

- tag-$slug.php
tag-ios.php
tag-android.php

## 一些常见函数
is_category()判断当前页面是否为分类页面is_author()判断当前页面是否为作者页面is_admin()判断当前页面是否为管理页面is_post_type_archive()判断当前页面是否为文章类型列表页is_main_query()判断当前查询是否为主查询the_author_posts_link()获取当前作者文章归档页面链接the_archive_title()根据查询的对象显示归档标题the_archive_description()返回归档的相关描述the_time()时间函数。the_time('Y-m-d')显示为2022-06-30site_url()返回WordPress安装路径home_url()返回首页地址has_excerpt()通过id判断文章是否设置了摘要paginate_links()获取页面分页链接single_cat_title()用于在分类页输出分类标题get_the_ID()获取当前idget_the_category_list()获取文章所有分类列表get_permalink()获取当前文章的链接，get_permalink(99)获取指定id的文章或页面链接get_pages( )获取已定义页面列表，get_pages(array('child_of' => 2))get_the_content()获取文章内容get_post_type()根据文章id获取文章类型get_post_type_archive_link()获取指定文章类型的文章列表链接get_query_var()查询当前文章的分类及分页wp_get_post_parent_id()获取父级idwp_list_pages()显示页面列表，wp_list_pages(array('title_li' => NULL,'child_of' => 2))wp_nav_menu()引用菜单，wp_nav_menu(array('theme_location' => 'headerMenu'))wp_trim_words()截取字符串，wp_trim_words(get_the_content(), 20)
## 自定义查询WP_Query

    <?php
    // WP_Query 所使用的参数
    $args = array(
        'posts_per_page' => 3, //-1一次返回满足查询的所有内容
        'post_type' => 'post',
        'orderby' => 'title',
        'order' => 'ASC',
        'meta_query' => array(
            array(
                'key' => '字段名',
                'compare' => '>=',
                'value' => date('Ymd'),
                'type' => 'numeric'
            )
        )
    );
    // 调用 WP_Query 新建文章查询
    $the_query = new WP_Query($args);
    while ($the_query->have_posts()) {
        $the_query->the_post();
        the_title();
        the_excerpt();
    }
    wp_reset_postdata(); //重置WordPress查询
    ?>

## 自定义文章类型

创建一个新的自定义文章类型需要使用 register_post_type 函数来注册，在主题的 functions.php 文件下调用该函数即可。

这里推荐另一种方法，先在wp-content/目录下新建文件夹：`mu-plugins`，即必须使用（must-use）的插件。进入文件夹，新建文件（例如：`my_post_types.php`），写入：

    <?php
    function my_post_types() {
        register_post_type('event', array(
            'show_in_rest' => true, //支持古腾堡编辑器
            'supports' => array('title', 'editor', 'excerpt'),
            'rewrite' => array('slug' => 'events'),
            'has_archive' => true,
            'public' => true,
            'labels' => array(
                'name' => 'Events',
                'add_new_item' => 'Add New Event',
                'edit_item' => 'Edit Events',
                'all_items' => 'All Events',
                'singular_name' => 'Event'
            ),
            'menu_icon' => 'dashicons-calendar'));
    }
    add_action('init', 'my_post_types');

在主题目录创建文件`single-event.php`，作为自定义文章类型（这里以event举例）详情页模版文件；新建文件`archive-event.php`，作为自定义文章类型存档页模版文件。

## 自定义字段

可以考虑使用插件：Advanced Custom Fields，允许添加多种形式的自定义字段类型。

插件安装启用后，可以使用 the_field() 和 get_field() 这两个函数。前者是直接输出字段值，后者是获取字段值以供其他函数调用。

## 自定义查询分页

一般来说，WordPress分页只能在默认查询中使用，想要自定义查询分页，需要做些工作。

    <?php
    $args = array(
        'paged' => get_query_var('paged', 1),
        'post_type' => 'post',
        'meta_query' => array(
            array(
                'key' => '字段名',
                'compare' => '>=',
                'value' => date('Ymd'),
                'type' => 'numeric'
            )
        )
    );
    // 调用 WP_Query 新建文章查询
    $the_query = new WP_Query($args);
    while ($the_query->have_posts()) {
        $the_query->the_post();
        the_title();
        the_excerpt();
    }
    wp_reset_postdata(); //重置WordPress查询
    echo paginate_links(array(
    'total' => $the_query->max_num_pages
    ));
    ?>

## hook 钩子

pre_get_post：修改主查询

    function my_adjust_queries() {
    if (!is_admin() AND is_post_type_archive('post' AND $query->is_main_query())) {
    $query->set('meta_key', 'event_date');
    $query->set('orderby', 'meta_value_num');
    $query->set('order', 'ASC');
    $query->set('meta_query', array(
    array(
    'key' => 'event_date',
    'compare' => '>=',
    'value' => date(format('Ymd')),
    'type' => 'numeric'
    )
    ));
    }
    }
    add_action('pre_get_post', 'my_adjust_queries');


WordPress主题开发笔记

## 🤝 交个朋友

文字因分享而产生共鸣，博客因连接而更有价值。诚挚邀请与本站主题、气质相投的独立博客交换链接，让文字产生共鸣，在思想之路上彼此呼应。

## ✨ 本站友链信息
**名称**阿伯手记**简介**一个专注分享优质网络资源与编程学习心得的个人博客**链接**`https://aboss.top`**头像**`http://aboss.top/content/images/2026/03/fan-ico.ico`*(请使用HTTPS协议)*
## 🎯 友邻原则

为确保链接质量与访问安全，申请站点原则上应满足：

✅ 拥有**原创内容**的技术/日志类个人博客
✅ 全站启用**HTTPS**安全协议
✅ 网站已被主流搜索引擎（如百度/Google）收录
❌ 暂不接受视频、资源下载、商业推广等非博客类站点

## 📮 申请方式

1️⃣ 请先在贵站添加本站链接 2️⃣ 然后**直接在本页面下方留言**告知我

我确认添加后，会在24小时内将您的链接放置在友链页面。

---

感谢您愿意在此驻足，并希望我们能成为彼此的灵感来源。

**以下是我们珍惜的博客邻居们，排名不分先后：**


友情链接

## Musicca

一个广受全球用户喜爱的音乐学习平台之一，使用免费且充满乐趣音乐学习方式帮助全球用户学习音乐。

网站提供课程、练习和互动工具，鼓励音乐学习者在校和家中都能按照自己的节奏来学习，帮助学习者理解音乐、学会读谱和演奏乐器，而且通过在学习过程中加入游戏的元素，使学习音乐的过程变得有趣。

除此之外网站还提供大量的在线虚拟音乐工具，例如钢琴、吉他、贝斯等等，可以在线模拟真实的乐器使用。

## 网站地址

Musicca：[https://www.musicca.com/zh](https://www.musicca.com/zh)


Musicca-免费且充满乐趣音乐学习工具平台

这里是 aboss.top 的自留地。写了十几年野路子代码，攒了些摸爬滚打的经验，做成系列课程慢慢讲；也留了一小块地方，记记代码之外的胡思乱想。