必须用 composer require --dev fakerphp/faker 安装，因 composer install 仅安装已声明依赖，而 faker 未写入 composer.json 前无法识别；需指定 'zh_cn' locale 才支持中文字段，且方法如 idcardnumber() 仅存在于 zh_cn provider 中。
必须用 composer require --dev fakerphp/faker 安装，不是 composer install，也不是旧包 fzaninotto/faker —— 后者已归档，PHP 7.4+ 下会直接报错。
为什么 composer install 不行？
它只安装 composer.json 或 composer.lock 里已声明的包。Faker 没写进依赖列表前，install 根本不知道要下什么。你得先用 require 把它加进去。
- 执行
composer require --dev fakerphp/faker会自动写入composer.json的require-dev，并下载到vendor/ - 如果项目已有
composer.lock且版本冲突，可先删 lock 文件再重试，或加--update-with-dependencies - 国内下载慢？临时切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Faker\Factory::create('zh_CN') 必须带参数，否则全是英文
默认实例是 en_US，$faker->name() 返回 “John Doe”，不是“王芳”。中文字段（如手机号、身份证号）只在 zh_CN Provider 里实现，漏掉 locale 就等于没中文支持。
- locale 必须精确写成
'zh_CN'（小写 + 下划线），'zh-cn'、'zh'或'CN'都会静默 fallback 到英文 - 新版
fakerphp/faker（1.23+）已内置zh_CN，但若提示不可用，可锁定版本：composer require --dev fakerphp/faker:^1.23 - 别想后期切换：
$faker->setLocale()不存在，locale 只能在create()时定死 - 实例化时建议加反斜杠：
$faker = \Faker\Factory::create('zh_CN');，防命名空间污染
$faker->phoneNumber() 和 $faker->idCardNumber() 这些方法到底有没有？
不是所有方法都“开箱即用”，尤其地域专属字段。比如 idCardNumber() 只存在于 zh_CN/Person.php，而 mobileNumber() 根本不存在 —— 正确方法是 phoneNumber()。
- 查源码最靠谱：打开
vendor/fakerphp/faker/src/Faker/Provider/zh_CN/Person.php，看有没有你要的方法 - 邮箱想更真实？用
$faker->email('qq.com')指定域名，或$faker->safeEmail()（返回@example.org类安全域） -
$faker->realText()在中文场景容易返回空或报错，因依赖mbstring且底层用英文语料拼接；改用$faker->text(200)更稳 - 循环生成 1000 条数据？复用一个
$faker实例，别在循环里反复create()，否则内存增长快
真正卡住人的地方，往往不是不会装，而是 locale 写错、版本不匹配、或者误以为某个方法“应该有”却没查源码确认 —— Faker 的 Provider 是按 locale 分离的，没加载对应语言包，方法就不存在。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
