fakerphp安装与使用需满足php≥7.4、用--dev安装、必须实例化后调用方法、用seed()控制随机性、确保autoload生效；常见问题多因环境配置或误用静态调用导致。
composer require fakerphp/faker 装不上？检查 PHP 版本和源
装 fakerphp/faker 失败，八成不是 Faker 本身的问题，而是环境卡在了依赖链上。它最低要求 PHP 7.4，如果你用的是 PHP 7.2 或更老版本，composer require 会直接报错“no matching package found”，连提示都未必明确说 PHP 版本问题。
实操建议：
- 先运行
php -v确认实际 CLI 使用的 PHP 版本（别只看 phpinfo） - 如果版本够但还是失败，临时切到国内镜像源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：PHP 8.2+ 推荐用https://packagist.org官方源，部分旧镜像已停更） - 避免全局安装——Faker 是开发时用的假数据工具，应该加
--dev标志：composer require --dev fakerphp/faker
Faker::name() 返回空字符串？没调用实例就直接静态调用
Faker 类不能当静态工具类直接用。Faker::name() 这种写法看似简洁，实际会返回空或报 Call to undefined method 错误，因为 Faker 本身只是工厂类，真正生成数据的是它创建的 Faker\Generator 实例。
常见错误现象：代码里写了 Faker::address() 却输出空白，调试发现对象根本没初始化。
实操建议：
- 必须先 new 实例：
$faker = \Faker\Factory::create(); - 地区语言可选传参，比如中文：
$faker = \Faker\Factory::create('zh_CN');（需确认已安装对应 locale 包） - 别在循环里反复
new—— 实例是轻量的，但没必要重复创建；一次创建，多次调用$faker->name()、$faker->email()即可
生成大量假数据变慢？用 seed() 控制随机性而非重实例化
批量插入测试数据时，有人每条记录都 new Faker 一次，还手动 mt_srand()，结果性能掉得厉害。其实 Faker 内部用的是 PHP 原生 mt_rand()，只要 seed 一致，序列就完全可复现，没必要靠新建对象来“隔离”随机状态。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
性能影响：10 万条数据中每次 new 实例，比复用一个实例慢 3–5 倍（实测 PHP 8.1 + Opcache 开启）。
实操建议：
- 统一 seed 控制可重现性：
$faker->seed(12345);（放在实例化后调用一次即可） - 避免在 for 循环里写
\Faker\Factory::create()—— 实例化开销虽小，积少成多 - 如果要不同语言混合生成（比如用户表中部分中文、部分英文），用多个预设实例更清晰：
$zhFaker = \Faker\Factory::create('zh_CN'); $enFaker = \Faker\Factory::create('en_US');
数据库迁移中用 Faker 报错 “Class 'Faker' not found”？autoload 没生效
在 Laravel 的 php artisan migrate 或自定义命令里用 Faker，常遇到 Class 'Faker' not found。这不是没装包，而是 Composer 自动加载机制没覆盖到当前执行上下文——特别是你把 Faker 放在 --dev 里，而生产环境跑了 composer install --no-dev，或者命令没走正确的 autoloader。
使用场景：Laravel 的 Seeder、自定义 Artisan 命令、CI 环境跑迁移。
实操建议：
- 确认是否真在 dev 环境下运行：Laravel 默认
APP_ENV=local才加载 dev 包，检查.env和config/app.php中的debug和env配置 - 强制重生成 autoload：
composer dump-autoload（尤其改过autoload配置后） - 在 Seeder 中加命名空间引用：
use Faker\Factory as Faker;，然后$faker = Faker::create();，比裸写\Faker\Factory::create()更稳
