Faker 库不能用 composer install 安装，因其仅安装 composer.lock 或 composer.json 中已声明的包；必须用 composer require fakerphp/faker –dev 显式添加到 require-dev 并下载。
Faker 库不能直接用 composer install 安装，必须用 composer require 显式添加到项目依赖中。
为什么 composer install 不行？
composer install 只会读取当前目录已存在的 composer.lock 或 vendor/ 状态，安装已有声明的包。如果你还没把 Faker 写进 composer.json，它根本不知道要装什么。
- Faker 是开发阶段用的测试工具，通常应加到
require-dev而非require - 直接运行
composer require fakerphp/faker --dev会自动写入composer.json并下载包 - 误用
install还可能因缺少 lock 文件报错：No composer.lock file present.
composer require fakerphp/faker 的关键参数差异
官方包名是 fakerphp/faker（2020 年后从 fzaninotto/faker 迁移），旧写法现在会触发弃用警告甚至失败。
- 加
--dev：写入require-dev，适合仅测试使用（推荐） - 不加参数：写入
require，会进生产环境 autoload，不必要且有安全风险 - 指定版本：如
composer require fakerphp/faker:^1.23，避免意外升级到不兼容大版本
生成数据时常见报错和绕过方法
装完不能直接 new Faker() —— 它没有默认构造逻辑，必须传 locale 或显式实例化 FakerGenerator。
- 错误写法：
$faker = new Faker();→ 报class 'Faker' not found - 正确写法：
$faker = FakerFactory::create('zh_CN');（中文支持需额外装fakerphp/faker的 locale 包） - 如果提示
zh_CN不可用，说明没下语言包：运行composer require fakerphp/faker:1.23.*（带 locale 的稳定版） - 性能注意：每次
Factory::create()都会重建实例，循环里别反复调；可复用一个 $faker 实例
真正容易被忽略的是 locale 和版本绑定关系 —— 新版 fakerphp/faker 默认只带 en_US，zh_CN、ja_JP 等需对应版本支持，不是装上就“开箱中文”。