yii2本身不提供静态分析错误的实时提示功能，需启用调试模式显示运行时错误，并借助phpstan等外部工具实现代码质量检查。
Yii2 本身不提供静态分析错误的实时提示功能——它不会像 IDE 或 PHPStan 那样在编码时标出类型不匹配、未定义变量或死代码。所谓“静态分析错误提示”，实际要分两层解决：一是让开发时真实错误不被静默吞掉，二是借助外部工具做代码质量检查。
为什么浏览器里看不到静态分析类报错
PHP 是动态解释型语言，undefined variable、Call to undefined method 这类错误只有在运行时触发才会抛出；它们不是语法错误，不会被 php -l 检出，也不会在保存文件瞬间提示。Yii2 的 ErrorHandler 默认只捕获运行时异常，对未执行到的“潜在问题”完全无感。
常见错觉是：“我改了模型字段名，表单提交就白屏”——其实不是静态分析没起作用，而是运行时访问了不存在的属性，触发了 Fatal error，但被生产模式下的 YII_DEBUG = false 拦截成空白页。
- 检查
web/index.php是否启用调试：defined('YII_DEBUG') or define('YII_DEBUG', true); - 确认 PHP 错误显示已打开：
error_reporting(E_ALL); ini_set('display_errors', '1'); - 若仍空白，查看 Web 服务器错误日志（如 Nginx 的
error.log或 Apache 的error_log），那里会记录真实的PHP Fatal error
用 phpstan / psalm 做真正的静态分析
要获得类似 TypeScript 的提前提示，必须引入第三方静态分析工具。Yii2 项目推荐搭配 phpstan，它能识别 ActiveRecord::findOne() 返回可能为 null、模型属性拼写错误、ArrayHelper::getValue() 键路径不存在等问题。
安装后初始化配置：
composer require --dev phpstan/phpstan vendor/bin/phpstan init
关键点：
- 在
phpstan.neon中添加 Yii2 扩展支持：includes: [vendor/phpstan/phpstan-phpunit/extension.neon, vendor/phpstan/phpstan-deprecation-rules/rules.neon] - 为 ActiveRecord 添加 stubs，否则会误报
getOldAttribute()不存在——可复制vendor/yiisoft/yii2/framework/base/Model.php到 stubs 目录并引用 - 运行命令：
vendor/bin/phpstan analyse --level max --configuration phpstan.neon ./models ./controllers
IDE 提示怎么补全 Yii2 特有逻辑
PhpStorm 等 IDE 默认不理解 @property 注解和 Yii2 的魔术方法（如 __get() 对关联关系的代理），导致跳转失败、自动补全缺失。
解决方式不是靠 Yii2 自身，而是靠插件和注释规范：
- 安装 PhpStorm 插件
Yii2 Support（JetBrains 官方维护） - 在 Model 类顶部手动补充 PHPDoc：
/** * @property int $id * @property string $name * @property User $author */ - 对
hasOne()关联，确保返回类型写清楚：public function getAuthor(): ActiveQuery，再加@return User|null注释 - 避免在
rules()里用字符串数组写验证规则（如['name', 'required']），改用常量或带类型提示的写法，方便 IDE 推导
真正卡住人的从来不是“有没有提示”，而是提示出现时你信不信它——比如 phpstan 报 Access to an undefined property，十有八九是你漏写了 @property 注解，或者关联方法返回类型没写对。这时候别绕开，补上注释比临时加个 @var 更治本。
