如何在WordPress主题激活时自动创建数据库表？

为啥你之前的写法没用？ #

register_activation_hook() 是WordPress专门给插件设计的激活钩子，主题的激活流程和插件完全不一样，所以你在主题functions.php里怎么调用这个函数都不会触发——这就是核心问题。

正确的姿势：用主题专属激活钩子 #

主题激活/切换时，WordPress会触发 after_switch_theme 动作钩子，这才是我们要绑定的目标。

直接能用的代码示例 #

把这段代码加到你主题的functions.php里：

// 绑定主题激活钩子
add_action('after_switch_theme', 'test_create_db_table');

// 建表函数（你已经确认过建表逻辑没问题，这里保留规范写法）
function test_create_db_table() {
    global $wpdb;
    $table_name = $wpdb->prefix . 'your_custom_table'; // 替换成你的表名，记得加WP前缀

    // 建表SQL，按需修改字段结构
    $sql = "CREATE TABLE IF NOT EXISTS $table_name (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        created_at datetime DEFAULT CURRENT_TIMESTAMP NOT NULL,
        content text NOT NULL,
        PRIMARY KEY  (id)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;";

    // 引入WP升级工具类，执行建表
    require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
    dbDelta($sql);
}

额外说明 #

1. 插件和主题的激活逻辑差异
   插件是通过后台插件管理页激活的，register_activation_hook()会绑定到插件主文件，激活时WP会主动调用；但主题是通过切换主题触发激活，走的是另一套流程，插件的钩子根本不会被触发。

2. 用dbDelta更稳妥
   推荐用dbDelta()而不是直接$wpdb->query()，它会自动检查表是否存在、结构是否需要更新，避免重复建表或结构冲突，符合WP开发规范。

3. 不用担心重复执行
   CREATE TABLE IF NOT EXISTS 和 dbDelta() 都会自动跳过已存在的表，所以多次激活主题也不会出问题。

内容的提问来源于stack exchange，提问作者Wp-PHP