应安装 fakerphp/faker，因其是官方维护的唯一可用包，fzaninotto/faker 已废弃且不兼容 php 8.2+；需用 factory::create('zh_cn') 实例化以启用中文数据，locale 必须精确匹配且仅在创建时指定。
直接用 composer require --dev fakerphp/faker 安装，再调 Faker\Factory::create('zh_CN') 实例化——这是生成中文测试数据最稳的路径。别碰 fzaninotto/faker，它已归档，PHP 8.2+ 下会报 Declaration of Faker\Generator::format() must be compatible 这类兼容性错误。
装哪个包？为什么不能写 faker
Packagist 上没有叫 faker 的包，搜不到；fzaninotto/faker 是废弃包，Composer 会明确提示 Package is abandoned。唯一可用的是官方维护的 fakerphp/faker。
- 正确命令：
composer require --dev fakerphp/faker - 如果项目已误装旧包，先运行
composer remove fzaninotto/faker再重装 - 加
--dev是因为 Faker 只在开发/测试时需要，不该进生产 autoload —— 否则部署体积变大、类加载变慢
Faker\Factory::create('zh_CN') 为什么必须带参数
Faker\Factory::create() 默认返回 en_US 实例，$faker->name() 出来全是 “John Doe”。中文姓名、手机号、身份证号这些字段只在 zh_CN Provider 里实现（比如 vendor/fakerphp/faker/src/Faker/Provider/zh_CN/Person.php）。
- locale 必须写成
'zh_CN'（下划线，大小写敏感），写成'zh'、'cn'或'zh-cn'都会静默 fallback 到英文 - 没装对应语言包？新版
fakerphp/faker默认只含en_US，zh_CN在 1.23+ 版本中已内置，但若提示不可用，可强制指定版本：composer require --dev fakerphp/faker:^1.23 - 别想后期切换 locale：
$faker->setLocale()方法根本不存在，locale 只能在create()时定死
生成邮箱、手机号、身份证号时常见“假得离谱”问题
$faker->email() 返回 test@example.com 不是 bug，是安全模式；$faker->phoneNumber() 在 zh_CN 下默认带 +86 前缀；而 idCardNumber() 这类方法，必须确认 locale Provider 真有实现。
- 要真实风格邮箱：用
$faker->email('163.com')指定域名，或改用$faker->safeEmail()（固定返回example.org类安全域） - 中文手机号正确写法是
$faker->phoneNumber()，不是$faker->mobileNumber()（后者不存在） - 身份证号：查源码确认 —— 打开
vendor/fakerphp/faker/src/Faker/Provider/zh_CN/Person.php，看有没有idCardNumber()方法；Laravel Seeder 中若用factory()->count(10)->create()，底层也走这套逻辑
批量生成时性能掉得厉害？别在循环里反复 create()
每次 Faker\Factory::create() 都会扫描 provider 类、注册方法、初始化随机数器。10 万条数据里每条都 new 一次，实测比复用一个实例慢 3–5 倍（PHP 8.1 + Opcache）。
- 正确做法：实例化一次，循环内重复调用方法：
$faker = \Faker\Factory::create('zh_CN');放在循环外 - 要控制随机序列可重现（比如测试断言），用
$faker->seed(12345)，不是靠反复 new - 需混用中英文数据？建两个实例更清晰：
$zhFaker = \Faker\Factory::create('zh_CN');和$enFaker = \Faker\Factory::create('en_US');
真正容易被忽略的点是：locale 和版本强绑定，不是装上 fakerphp/faker 就自动支持中文；zh_CN 在 1.23+ 才稳定内置，低版本仍可能 fallback 到英文且不报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
