phpstorm 默认不识别 yii 命令，因其将 yii 视为需 php 解释器驱动的 php 脚本而非静态可执行文件；必须手动注册为外部工具并标记 stubs 为 sources，才能实现参数补全、ctrl+click 跳转及一键执行。
PhpStorm 里直接点一下就运行 yii 命令，不是靠“框架支持”开关，而是得手动注册为外部工具并补全 stubs —— 否则连 yii migrate 都没参数提示，更别说快捷执行。
为什么 PhpStorm 默认不识别 yii 命令
PhpStorm 的 “Command Line Tool Support” 功能只认静态可执行路径（比如 php、composer），而 Yii2 的 yii 是个 PHP 脚本，必须由 php 解释器驱动。IDE 不会自动推断 vendor/bin/yii 是命令入口，也不会加载它的命令定义。
- 现象：在 Terminal 里敲
yii list正常，但在Tools → Run Command…里搜不到yii，或点了没反应 - 根本原因：没把
yii当成“外部工具”注册，也没告诉 PhpStorm 它有哪些子命令和参数结构 - 后果：无法 Ctrl+Click 跳转命令类、无参数补全、不能一键运行
yii g/crud这类高频操作
注册 yii 为外部工具（Windows / macOS / Linux 通用）
这步让 PhpStorm 知道“哪里找 yii”，并绑定到快捷键或菜单。
- 打开
Settings → Tools → External Tools，点击+ -
Program填php（确保是项目用的 PHP 解释器路径，不是系统默认） -
Arguments填$ProjectFileDir$/yii $FilePath$（$FilePath$会在选中控制器/模型时自动传入路径，方便后续生成代码） -
Working directory填$ProjectFileDir$ -
Alias设为yii（之后可在Run Command…里直接输yii） - 确认后，就能用
Ctrl+Shift+X（macOS 是Cmd+Shift+X）呼出命令框，输入yii migrate执行了
让 yii 命令有补全和跳转（关键！）
光注册工具还不够——没有命令定义，IDE 就不知道 yii g/model 后面该跟什么参数，也不会提示 --table-prefix 这种选项。
- 先生成 stubs：
./vendor/bin/yii2-stubs-generator（Linux/macOS）或php vendor\bin\yii2-stubs-generator（Windows），输出目录默认是stubs/ - 把生成的
stubs/目录右键 →Mark as → Sources（不是 Libraries，也不是 Excluded） - 重启 PhpStorm 或
File → Reload project from Disk，等索引完成 - 此时再在
Run Command…里输yii g/，就会出现g/crud、g/model等补全项；按 Tab 还能继续补全参数名
调试时断点不命中？入口文件没设对
命令行工具本身不涉及调试，但很多人混淆了“运行命令”和“调试 Web 请求”。如果你在 controllers/SiteController.php 里打了断点却从不触发，问题不在 yii 工具配置，而在 Web 调试配置。
- Web 请求永远从
web/index.php开始，不是index.php（根目录那个） -
Run → Edit Configurations → + → PHP Web Page，Index file必须设为web/index.php - 检查
web/index.php开头是否有defined('YII_DEBUG') || define('YII_DEBUG', true);，否则 Xdebug 可能跳过断点 - 别在
runtime/或vendor/下设断点——这些路径默认被 PhpStorm 排除在调试范围外（Settings → PHP → Debug → Skipped Paths可查）
真正卡住人的地方，从来不是“怎么加个工具”，而是忘了 stubs 要标记为 Sources，或者调试时死盯着控制器文件却没配对入口。这两步漏掉任何一环，yii 在 PhpStorm 里就只是个能敲的命令，不是能跳、能补、能查的开发伙伴。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
