composer require fakerphp/faker 在 PHP 8.1+ 默认装 v2.x，但老项目用 Faker\Generator 会报错；v2.x 改用 Faker\Factory::create()，需注意 locale 设置、provider 加载及 seed 必须调用后设置。
composer require fakerphp/faker 会装错版本？
直接运行 composer require fakerphp/faker 在 PHP 8.1+ 环境下默认安装 v2.x，但很多老项目代码仍用 Faker\Generator 的 v1.x 风格调用（比如没用命名空间别名、直接 new Faker），会导致 Class 'Faker\Generator' not found。v2.x 已移除该类，改用 Faker\Factory::create() 入口。
- PHP 7.4–8.0 项目建议显式锁 v1.21.0：
composer require fakerphp/faker:^1.21 - 新项目统一用 v2.x，注意调用方式变更（见下一条）
- 若已有
autoload-dev里手动加了 faker 类映射，先删掉，v2.x 自带 PSR-4
Faker\Factory::create() 的 locale 和 provider 怎么配？
v2.x 必须通过 Faker\Factory::create() 获取实例，不能 new。locale 决定生成数据的语言/格式（如日期、姓名、地址），provider 是扩展数据类型（如信用卡、ISBN）。
Faker\Factory::create('zh_CN'); // 中文环境
Faker\Factory::create('en_US')->addProvider(new \Faker\Provider\zh_CN\Person($faker)); // 手动加中文人名 provider（v2.x 中 zh_CN 默认已内置常用 provider）
- 常见 locale：
en_US、zh_CN、ja_JP、fr_FR；不传参数默认en_US - 自定义 provider 必须继承
\Faker\Provider\Base，且构造函数需接收Faker\Generator实例 - 多次调用
create()会创建独立实例，互不影响；不要在全局缓存它，除非你明确需要固定 seed
测试中避免随机性干扰，怎么固定 faker 输出？
单元测试里 faker 输出必须可重现，否则断言会飘。核心是设置 seed —— 但注意：v2.x 的 seed 必须在 create() 后立刻设，不能传参。
$faker = Faker\Factory::create('zh_CN');
$faker->seed(12345); // 必须这样设，不是 create('zh_CN', 12345)
echo $faker->name; // 每次运行都输出 "张伟"
- seed 值用整数，相同 seed + 相同 locale + 相同调用顺序 = 完全一致输出
- Laravel 测试中可在
setUp()里统一设 seed，避免每个 test 方法重复写 - 别用时间戳或 rand() 当 seed，否则失去可重现性
为什么 vendor/bin/faker 命令行工具跑不起来？
v2.x 已移除命令行脚本 vendor/bin/faker，官方明确说明「CLI is removed」。试图执行会报 No such file or directory 或 Class 'Faker\Command\FakerCommand' not found。
- 替代方案：写个简单 PHP 脚本调用 faker，例如
php -r "$f = Faker\Factory::create(); echo $f->email.PHP_EOL;" - 需要批量生成 JSON/CSV？用 PHPUnit 数据提供器 + faker，或结合
fzaninotto/faker（v1.x）的 CLI（仅限遗留项目） - 别试图软链旧版 bin 文件到 v2.x vendor 下，命名空间和类结构已不兼容
