Seeder 是 ThinkPHP 6+ 的数据库测试数据填充机制，用于向表中插入预设测试数据，不建表、不替代迁移，适用于开发与测试环境的数据初始化。
ThinkPHP 的 Seeder 是什么，它能干什么
Seeder 是 ThinkPHP 6+ 提供的数据库测试数据填充机制，本质是一段可重复执行的 PHP 代码，用于向数据库表中插入预设的测试数据。它不替代迁移（migration），也不负责建表，只管“填数据”。常见于本地开发、CI 流程初始化、API 接口联调前准备样本数据等场景。
- 它依赖
think-orm的 Db 或 Model 类操作数据库 - 每个 Seeder 类对应一次填充动作，可按需分组调用（比如
UserSeeder、PostSeeder） - 执行后不会自动记录状态，重复运行可能造成主键冲突或重复插入，需自行控制逻辑
如何创建并运行一个 Seeder
ThinkPHP 自带命令行工具支持快速生成和执行 Seeder：
- 运行
php think make:seeder UserSeeder会在database/seeders/下生成类文件 - 在
run()方法里写插入逻辑，推荐用Db::name('user')->insertAll(...)或模型批量写入 - 执行填充：运行
php think seed:run（默认运行所有 Seeder）或指定单个：php think seed:run --class=UserSeeder
注意：
-
seed:run命令默认只在app_debug = true环境下可用 - 若提示 “Command not found”，检查是否已启用
think\command\SeedRun命令（TP6.1+ 默认开启，旧版需手动注册） -
insertAll()接收二维数组，字段名必须与数据库列完全一致，否则静默失败
避免重复填充和主键冲突的关键处理
Seeder 不自带幂等性，直接反复运行会报 SQLSTATE[23000]: Integrity constraint violation（如主键重复、唯一索引冲突）。解决思路不是加 try-catch 吞错，而是主动判断：
立即学习“PHP免费学习笔记（深入）”；
- 使用
Db::name('user')->where('email', 'test@example.com')->find()先查是否存在，再决定是否插入 - 对自增主键表，慎用固定
id值；如需固定 ID（比如关联测试），先truncate表或用replaceInto()替换 - 复杂场景建议配合迁移使用：先
migrate:refresh清空并重建表结构，再seed:run填充
示例片段：
public function run()
{
$users = [
['name' => '张三', 'email' => 'zhang@example.com'],
['name' => '李四', 'email' => 'li@example.com'],
];
// 避免重复：先清空（仅开发环境）
if (app()->isDebug()) {
Db::name('user')->delete(true);
}
Db::name('user')->insertAll($users);
}
生产环境千万别跑 seed:run
seed:run 命令没有环境拦截机制，默认任何环境都能执行。但它的设计定位就是「仅限开发与测试」——填充的数据无业务意义、常含硬编码 ID 或测试邮箱，且不校验业务规则（比如密码未加密、状态字段随意设）。
- 生产部署脚本中务必移除或注释掉相关命令调用
- CI 流程中建议限定环境变量：
APP_ENV=testing php think seed:run，并在 Seeder 中用app()->isProduction()主动拒绝执行 - 更稳妥的做法是把 Seeder 放进
tests/目录，而非database/seeders/，靠目录权限和部署策略隔离
真正上线时，初始数据应走 SQL 脚本或后台导入，而不是靠 PHP 代码填充。Seeder 的价值只在快速复现、协作对齐、自动化测试准备这几个点上。
