PhpStorm 对 Behat 的支持需同时满足：behat.yml 在项目根目录、PHP 解释器已正确配置、Behat 可执行文件（vendor/bin/behat 或 behat.phar）被识别，缺一不可。
PhpStorm 对 Behat 的支持是开箱即用的，但前提是 behat.yml 存在、PHP 解释器已配置、且 Behat 可执行文件（vendor/bin/behat 或 behat.phar）能被正确识别。缺任意一环，Gherkin 高亮、步骤跳转、运行配置都会失效。
确认 PHP 解释器和 Behat 可执行路径
PhpStorm 不会自动猜你用的是哪个 PHP 版本或 Behat 安装方式。它只认「当前项目配置的 PHP 解释器」和「能被该解释器执行的 Behat 入口」。
- 进 Settings → PHP，确保「CLI interpreter」指向有效的 PHP 二进制（如
/usr/bin/php或php8.2），不是空或系统默认的旧版本 - Behat 必须通过 Composer 安装在项目本地（
composer require --dev behat/behat），否则 PhpStorm 无法发现vendor/bin/behat；手动下载的behat.phar需放在项目根目录并显式配置为「Custom autoloader」或「Path to behat.phar」 - 如果项目含多个子模块（如 monorepo），每个含独立
composer.json，PhpStorm 会为每个检测到 Behat 的子项目创建单独的 Test Framework 配置 —— 切勿混用主项目和子项目的配置
behat.yml 必须放在项目根目录
PhpStorm 只在项目根目录（或明确指定的子项目根）扫描 behat.yml 或 behat.yml.dist。放错位置会导致：步骤定义不识别、@Given 注解无跳转、运行时提示 No suites found。
- 文件名必须严格为
behat.yml（YAML 格式），不能是behat.yaml或behat.php - 最简可用配置只需包含
suites和contexts，例如：default: suites: default: contexts: - FeatureContext - 若使用 Mink 扩展，
Behat\MinkExtension必须在extensions下，且类名大小写敏感（MinkExtension不是minkextension）
Feature 文件与 Context 类的映射必须匹配
当你在 login.feature 里写 Given I am on the login page，PhpStorm 要能跳转到对应 PHP 方法，依赖两件事：注解正则匹配 + 类自动加载。
立即学习“PHP免费学习笔记（深入）”；
-
FeatureContext.php必须声明为class FeatureContext implements Context，且命名空间与behat.yml中contexts值一致（如App\Features\Context\FeatureContext） - 步骤注解里的中文/英文需与 Gherkin 行完全一致，包括空格和标点。例如
@Given("I am on the login page")无法匹配Given 我在登录页面—— 中文步骤必须用中文注解：@Given("我在登录页面") - Behat 3 使用 PCRE+ 正则，支持
{string}、{int}占位符，但 PhpStorm 的跳转功能对复杂正则（如@When("/^I input (.+) into field (.+)$/")）支持不稳定，建议优先用直白字符串匹配
运行配置里别忽略「Default configuration file」
即使 behat.yml 在根目录，PhpStorm 新建的 Behat 运行配置也可能没自动绑定它，导致测试跑不起来或报 Context class not found。
- 新建运行配置时（Run → Edit Configurations → + → Behat），检查「Default configuration file」字段是否填了
behat.yml的绝对路径（如$ProjectFileDir$/behat.yml） - 若项目有多个环境配置（如
behat-test.yml），需手动切换该字段，PhpStorm 不会根据 tags 或 CLI 参数自动选 - 「Test runner」选
Local即可，除非你真在远程容器里跑 Behat；选Remote却没配好 SSH，会卡在「Connecting…」
最常被忽略的是 behat.yml 的位置和 PHP 解释器的版本兼容性 —— Behat 3 要求 PHP ≥5.5，而 PhpStorm 默认可能继承系统老 PHP；一旦解释器版本低于要求，连 vendor/bin/behat --version 都执行失败，后续所有支持全崩。
