应使用yii迁移机制安全变更数据库结构：生成带utc时间戳的迁移文件，编写幂等的up()/down()方法，执行时指定数量或版本，严禁线上不带参数运行。
你需要在Yii项目中安全、可追溯地变更数据库表结构，而不是直接执行SQL或手动改表——这会导致团队环境不一致、上线失败、历史记录断裂。
创建迁移文件
进入项目根目录，运行命令生成带时间戳的迁移文件：
【必须用小写字母、下划线和数字组合命名，禁止空格或大写字母】
yii migrate/create add_status_to_user_table
命令执行后，会在 console/migrations/ 目录下生成类似 m260806_103900_add_status_to_user_table.php 的文件。注意：文件名中的时间戳是UTC毫秒级时间，【不可手动修改前缀或重命名】，否则 Yii 无法识别执行顺序。
如果提示 “Migration already exists”，说明同一毫秒内重复执行了命令，删掉刚生成的文件，再重试一次即可。
编写 up() 和 down() 方法
打开新生成的迁移文件，在 up() 中写入正向变更逻辑，在 down() 中写入逆向操作。关键原则是：两者都必须幂等且可反复执行。
方法一：添加字段（安全写法）
在 up() 中使用 $this->addColumn()，并先检查字段是否存在（避免重复添加报错）：
if (!$this->db->getTableSchema('user')->getColumn('status')) {<br> $this->addColumn('user', 'status', $this->smallInteger()->notNull()->defaultValue(10));<br>}
方法二：建表（带 MySQL 引擎与字符集适配）
若新建表，需显式声明 $tableOptions，否则在 MySQL 中可能默认使用 MyISAM 或无 UTF8 支持：
$tableOptions = null;<br>if ($this->db->driverName === 'mysql') {<br> $tableOptions = 'CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci ENGINE=InnoDB';<br>}<br>$this->createTable('{{%profile}}', [<br> 'id' => $this->primaryKey(),<br> 'user_id' => $this->integer()->notNull(),<br> 'bio' => $this->text(),<br>], $tableOptions);
方法三：删除字段（仅限开发阶段）
down() 中不要直接写 $this->dropColumn()——除非你确认该字段尚未被任何业务数据引用。生产环境一旦有数据，删字段就是高危操作，应改为注释掉字段、加弃用标记，而非物理删除。
执行迁移
第一步：确认当前迁移状态
yii migrate/status
第二步：执行单条迁移（推荐，尤其在线上）
yii migrate/up 1
第三步：若需执行指定版本，用完整类名（不含 .php 后缀）：
yii migrate/up m260806_103900_add_status_to_user_table
【生产环境严禁使用 yii migrate/up 不带参数，也不允许用 --include-all=1】——这会跳过依赖校验，可能因顺序错乱导致外键冲突或字段缺失。
回滚迁移
① 仅回退最新一条已执行的迁移：
yii migrate/down
② 回退指定数量（如最近两条）：
yii migrate/down 2
③ 回退到某具体版本（注意：该版本之后所有迁移都将撤销）：
yii migrate/to m260805_152000_init_user_table
⚠️ 提醒：如果某迁移的 down() 方法返回 false 或抛出异常，Yii 会中断回滚流程，并标记迁移历史为 corrupted——此时必须人工修复 migration 表，或重建测试库。
