我之前也踩过dbDelta的坑，这个函数对SQL语法的要求比普通的数据库执行严格太多了，你的代码里的SQL写法刚好不符合它的规则，导致字段没创建成功，具体问题和修正方案如下：

你的SQL语句存在的问题 #

• 批量字段添加的格式不被支持：dbDelta不认可ADD (gender varchar(10), test varchar(10))这种用括号批量添加字段的写法，必须为每个字段单独声明添加操作。
• 缺少COLUMN关键字：虽然MySQL本身允许省略COLUMN直接写ADD，但dbDelta要求必须完整写出ADD COLUMN，否则它无法识别这是添加字段的操作。
• 字符集排序规则的位置错误：你把$charset_collate放在整个ALTER语句的最后，正确的姿势是把它附加到每个字段的定义后面，确保字段使用指定的字符集和排序规则。

修正后的代码示例 #

function new_columns_users(){
    global $wpdb;
    $charset_collate = $wpdb->get_charset_collate();
    $table_name = $wpdb->prefix . "users";
    // 拆分每个字段的ADD COLUMN语句，格式符合dbDelta要求
    $sql = "ALTER TABLE $table_name 
            ADD COLUMN gender varchar(10) $charset_collate,
            ADD COLUMN test varchar(10) $charset_collate;";
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );
}

额外注意事项 #

• 确保函数被正确触发：可以把这个函数挂在init或者admin_init钩子上，比如add_action('init', 'new_columns_users');，或者临时手动调用一次（注意调用后记得移除，避免重复执行）。
• 先手动验证SQL：可以先在phpMyAdmin或其他数据库管理工具里执行修正后的SQL，确认字段能正常添加，排除数据库权限、表不存在等环境问题。
• dbDelta的特性：它会自动检查字段是否已经存在，所以重复执行不会导致重复创建或报错，但第一次执行必须保证语法正确才能成功创建字段。

内容的提问来源于stack exchange，提问作者Willem van der Veen