Laravel不自动识别FormRequest规则，必须显式定义在public function rules(): array方法中；规则需规范命名、配合PHPDoc和静态分析工具提升可发现性、可维护性与可验证性。
Laravel本身不提供“自动识别”FormRequest验证规则的机制——规则必须显式定义在rules()方法中，框架不会扫描注释、配置文件或数据库结构来推导规则。所谓“自动识别”，实际是指通过规范写法+辅助工具+约定习惯，让规则更易被IDE识别、开发者理解、团队复用和测试覆盖。核心不在“识别”，而在“可发现、可维护、可验证”。
确保rules()方法被正确声明和返回
这是所有后续识别的前提。Laravel只执行rules()方法返回的数组，其他地方写的规则（如构造函数、属性、注释）一律无效。
- 方法签名必须为
public function rules(): array，返回关联数组，键为字段名，值为字符串或规则数组 - 避免在
rules()中做耗时操作（如DB查询），如需动态规则，用$this->route('id')或$this->user()等安全访问请求上下文 - 不要把规则写在
authorize()或messages()里，它们不参与字段校验
用PHPDoc标注字段与规则语义
虽然Laravel不解析注释，但主流IDE（PhpStorm、VS Code + Intelephense）能基于PHPDoc提示字段含义、类型和常见约束，提升可读性与协作效率。
- 在
rules()方法上方添加@return array<string, string|array> - 对关键字段加说明，例如：
/** @var array<string, string> 规则：name必填且为字符串，email需唯一 */ - 配合字段级PHPDoc（需手动维护）：
/** @property string $name 用户姓名 */可辅助IDE跳转和类型推断
统一规则命名与目录结构，便于全局搜索
“自动识别”的另一种实践是工程化管理：让规则位置固定、命名清晰，靠grep、IDE全局搜索或自定义脚本快速定位。
- 按业务域组织Requests类，例如
app/Http/Requests/User/StoreUserRequest.php、app/Http/Requests/Post/UpdatePostRequest.php - 类名使用动词+名词结构（
StoreUserRequest），一眼可知用途 - 规则字段名尽量与数据库列名、API参数名保持一致，减少映射歧义
借助静态分析工具辅助检查
可用工具提前发现常见疏漏，相当于“半自动识别”潜在问题。
-
phpstan+ Laravel插件：检测rules()返回类型是否为array，字段名是否拼写错误（配合模型属性反射） -
larastan：增强对FormRequest、Eloquent、Validation Rule的类型推断，提示未定义字段或冗余规则 - 自定义PHP_CodeSniffer规则：强制
rules()方法存在、非空、键名不含空格或特殊字符
