PhpStorm 正确支持 Codeception 全栈测试的关键是：先执行 codecept build 生成 Actor 类，再将项目根目录和 _support 目录标记为 Sources Root，重载项目索引；运行配置必须用 vendor/bin/codecept 脚本而非 PHPUnit；测试目录需按 codeception.yml 中 paths.tests 配置精确标记为 Tests。
PhpStorm 要真正支持 Codeception 全栈测试（acceptance/functional/unit），关键不是“加插件”或“选框架类型”，而是让 IDE 正确识别动态生成的 Actor 类、走对 autoloader、并用对执行入口——否则补全失效、断点不进、报 Class 'Codeception\PHPUnit\TestCase' not found 都是常态。
为什么 AcceptanceTester 红标、$I->amOnPage() 没补全
根本原因：PhpStorm 没索引 _support/Actor/AcceptanceTester.php 这类文件。它们由 codecept build 生成，不在初始项目结构里，IDE 不会自动重载。
- 必须先在终端执行
codecept build（确保_support/Actor/下已生成AcceptanceTester.php等文件） - 右键点击项目根目录 → Mark Directory as → Sources Root（如果还没标）
- 右键点击
_support目录 → Mark Directory as → Sources Root（这步不可跳过，否则_support/Actor/不被解析） - 执行 File → Reload project from Disk，等右下角 “Indexing…” 提示消失
常见错觉：测试命令行能跑通，但 PhpStorm 里写 $I-> 没提示——这就是纯索引问题，不是代码写错了。
运行配置必须用 vendor/bin/codecept，别碰 PHPUnit 配置项
PhpStorm 内置的 “PHPUnit” 运行配置会强行加载旧版 PHPUnit autoloader，和 Codeception 4+ 的依赖结构冲突，直接触发 Class 'Codeception\PHPUnit\TestCase' not found。
立即学习“PHP免费学习笔记（深入）”；
- 在 Run → Edit Configurations 中新建一个 PHP Script（不是 PHPUnit！）
-
Script path填vendor/bin/codecept（Linux/macOS）或vendor\bin\codecept.bat（Windows） -
Script arguments填类似run acceptance LoginCest.php --debug -
Working directory设为项目根目录（含codeception.yml）
这样启动的进程完全走 Composer autoloader，Actor 类、Helper、模块都能正确加载，断点也能进到 AcceptanceTester 方法内部。
测试目录标记和 codeception.yml 必须对齐
PhpStorm 的 “Tests” 标记只是给编辑器看的，而 Codeception 运行时只认 codeception.yml 里的 paths: tests: 配置。两者不一致会导致“点运行没反应”或“找不到测试文件”。
- 检查
codeception.yml中的paths: tests:值（例如tests/acceptance） - 在 PhpStorm 中右键对应目录 → Mark Directory as → Tests（变成绿色图标）
- 如果用了自定义路径（如
tests/codecept_unit），必须用codecept bootstrap tests/codecept_unit初始化，不能只改 yml - 避免把
tests整体标为 Tests；应按 suite 拆分标记（tests/acceptance、tests/functional各自标）
标记错目录的典型表现：右键某个 *Cest.php 文件 → “Run” 菜单灰掉，或者运行后提示 “No tests executed”。
调试验收测试时，WebDriver 模块需额外注意
Acceptance 测试依赖 WebDriver 模块，但 PhpStorm 调试器默认不捕获浏览器进程输出，容易误判为“卡死”或“超时”。
- 确保
acceptance.suite.yml中启用了restart: true和clear_cookies: true，避免 session 污染干扰调试 - 在
Script arguments里加上--debug --steps，能看到每步执行日志 - 如果用 ChromeDriver，确认
chromedriver在 PATH 中，或在 yml 里显式指定port和url - 首次调试前手动跑一次
codecept run acceptance --debug看终端输出是否正常，再进 PhpStorm 断点
最常被忽略的是：ChromeDriver 版本与 Chrome 浏览器不匹配，此时 PhpStorm 里断点能进，但 $I->amOnPage() 之后就卡住，控制台无任何错误——得去终端看 WebDriver 的原始 stderr 输出才能定位。
