--path仅对php artisan make:migration有效，须为相对路径且目标目录需手动创建；模块迁移应使用module:make-migration而非--path；生成与执行的--path必须严格一致，否则迁移将被忽略。
用 --path 指定迁移文件生成位置
迁移文件默认生成在 database/migrations，但你可以用 --path 把它扔到任意子目录——只要路径存在、且是相对于项目根目录的。
常见错误是直接写绝对路径或未创建目标目录。Laravel 不会自动建文件夹，php artisan make:migration create_logs_table --path=app/Database/Migrations 会报错，除非你先手动运行 mkdir -p app/Database/Migrations。
-
--path值必须是相对路径，比如app/Database/Migrations或Modules/Report/Database/Migrations - 路径中不能含
..，也不支持以/开头（即不接受绝对路径） - 生成后，该迁移仍需通过
php artisan migrate --path=xxx显式指定路径才能执行，不会自动被migrate扫描
模块化项目中 --path 和 module:make-migration 的关系
如果你用的是 nWidart/laravel-modules 这类模块包，别直接对模块路径硬套 --path。模块命令如 php artisan module:make-migration create_reports_table Admin 会自动把文件放进 Modules/Admin/Database/Migrations/，并读取 Modules/Admin/module.json 中的 "migration" 字段决定最终路径。
这时候手动加 --path 不仅无效，还可能覆盖模块约定逻辑。例如：php artisan module:make-migration create_reports_table Admin --path=custom/mig 不会起作用，模块命令压根不解析这个参数。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 模块迁移应优先走
module:make-migration，它内部已封装好路径构造逻辑 - 若真要自定义模块迁移路径，请改
module.json里的"migration"键，而不是传参 -
--path只对原生make:migration有效，和模块命令不兼容
--path 和迁移执行时的 --path 必须严格一致
生成时用了 --path=app/Database/Migrations，那后续运行就得配对使用 php artisan migrate --path=app/Database/Migrations。Laravel 不会“记住”你上次生成的位置，也不会自动合并多个路径。
容易踩的坑是：生成时用了 --path，但执行时忘了加，结果 migrate 只扫默认目录，新迁移被完全忽略；或者路径写错一个字母，比如 app/Database/Migration（少了个 s），命令静默成功但没执行任何东西。
- 执行迁移前建议先用
ls确认文件真实存在：ls app/Database/Migrations/*create_logs_table*.php - 可以用
php artisan migrate --pretend --path=xxx预览将执行哪些 SQL，避免误操作 - 多个自定义路径需多次调用
migrate，不支持逗号分隔或通配符
自定义模板 + --path 组合使用的注意事项
如果项目统一用了自定义迁移模板（比如预置了软删除、UUID 主键等），模板路径和生成路径是两个独立控制点：--template-path 控制代码结构，--path 控制文件落盘位置。
两者可以同时用，但顺序无关紧要。不过要注意：自定义模板里若硬编码了命名空间（如 App\Database\Migrations），而你又把文件生成到了 Modules/Shop/Database/Migrations，那 PHP 自动加载就会失败——因为命名空间和物理路径不匹配。
- 推荐模板里用占位符
{{ class }}和{{ namespace }}，由 Artisan 动态注入 - 若手动改过模板，务必检查
use块和class声明是否与目标路径下的 PSR-4 规则一致 -
--template-path路径也必须存在，且需可读；否则生成直接中断，无提示
