CI3加字段需用$dbforge->add_column()而非SQL；CI4用$forge->addColumn()并建议先判断字段是否存在；加非空字段须分步：先加可空字段、再填充数据、最后改约束。
CI3 的 migration 文件里怎么加字段
CodeIgniter 3 不自带原生迁移功能，得靠第三方库（比如 ci3-migration）或自己手写 SQL。如果你用的是社区常用方案（如 jdenticon/ci3-migration），迁移文件本质是 PHP 类，加字段靠 $this->dbforge->add_column()。
常见错误是直接写 SQL 字符串，但 CI3 的 dbforge 不支持 ALTER TABLE ... ADD COLUMN 原生语法；必须用它的方法封装。
- 新建迁移文件，比如
application/migrations/002_add_status_to_users.php - 类名必须匹配文件名（
class Migration_Add_status_to_users），且继承CI_Migration - 在
up()方法里调用：$this->dbforge->add_column('users', ['status' => ['type' => 'TINYINT', 'default' => 1]]); -
down()方法里对应删掉：$this->dbforge->drop_column('users', 'status');
注意：字段类型字符串（如 'TINYINT'）必须是 DB 驱动识别的原生类型，不能写 boolean 或 enum —— MySQL 驱动不认这些别名，会报错 Unknown field type。
CI4 的 alterTable() 怎么安全加字段
CI4 原生迁移支持更直观的表结构变更，但 alterTable() 不是直接调用的方法，而是通过 Forge 类配合 modifyColumn() 或 addColumn() 实现。关键点在于：必须先获取当前表结构上下文，再构造变更指令。
典型写法是在 migration 的 up() 里这样写：
$forge = \Config\Database::forge();
$forge->addColumn('users', [
'is_active' => [
'type' => 'BOOLEAN',
'default' => true,
'null' => false
]
]);
容易踩的坑：
- 字段名重复时不会报错，但后续插入会因约束失败 —— 建议加判断：
if (!$this->db->field_exists('is_active', 'users')) { ... } - CI4 的
BOOLEAN类型底层映射为TINYINT(1)，如果已有数据，新字段默认值可能被忽略（尤其null => false但没设default） - MySQL 5.7+ 要求
ADD COLUMN必须指定位置（AFTER xxx），而 CI4 的addColumn()默认加到末尾；若强依赖顺序，得手动拼 SQL 执行
加字段后数据怎么初始化
迁移只改结构，不填数据。如果你加了个非空字段（比如 status TINYINT NOT NULL DEFAULT 1），但旧记录没值，MySQL 会拒绝执行 —— 因为已有行缺失该字段值。
解决办法不是在 migration 里塞 UPDATE，而是分两步走：
- 第一步：加可空字段（
'null' => true），跑迁移 - 第二步：单独执行数据填充逻辑（比如在控制器里跑一次脚本，或写个命令行命令）：
$this->db->update('users', ['status' => 1], ['status IS NULL']); - 第三步（可选）：再建一个迁移，把字段改成
NOT NULL—— 这需要先确保所有行都有值
跳过第二步直接设 NOT NULL DEFAULT 在某些 MySQL 模式下会失败，尤其是 STRICT_TRANS_TABLES 开启时。
为什么 dbforge->add_column() 在 CI3 有时没反应
最常被忽略的是数据库前缀问题。CI3 的 dbforge 默认会自动加前缀（比如 prefix_users），但你在迁移文件里写的表名是 users，如果实际表名是 myapp_users，而配置里 $db['default']['dbc_prefix'] 没设对，就会操作错表甚至静默失败。
验证方式很简单：
- 在迁移的
up()开头加一行：var_dump($this->db->database, $this->db->prefix, 'users'); exit; - 看输出的表名是不是你预期的物理表名
- 如果不对，要么改配置，要么显式传完整表名：
$this->dbforge->add_column($this->db->prefix . 'users', ...)
另一个隐蔽问题是字段定义数组里用了中文键名或非法字符（比如带空格、短横线），dbforge 会直接跳过该字段，也不报错 —— 建议只用英文下划线命名。
