PHP 8.5.7 不内置 AI 测试生成功能，需依赖 IDE 插件（如 PHPStorm 的通义灵码），且光标必须精准停在方法名上，否则因上下文丢失导致生成无效测试。
光标必须停在方法名上，否则生成的测试不可运行
PHP 8.5.7 本身不内置 AI 测试生成功能，得依赖 IDE 插件（如 PHPStorm 的通义灵码、Fitten Code 或 GitHub Copilot）——但所有插件都要求你把光标精确放在目标方法名上，比如 calculateTotal 这个词上，不能选中它，也不能停在注释、空行或类名处。停错位置会导致插件误判作用域，生成一个空壳测试类，里面连 @Test 注解都没有，更别说断言了。
常见错误现象：Class 'Tests\Unit\CalculateTotalTest' not found 或 Method calculateTotal does not exist，基本都是光标定位失误导致的上下文丢失。
- 确认光标只覆盖方法名字符，不带括号、不带空格
- 确保方法体语法完整，没有未闭合的
{或缺失的return - 如果方法调用外部服务（如
file_get_contents），先用Mockery或PHPUnit::createMock替换，否则 AI 无法推断异常路径
手动补全 @param/@throws 注释才能触发边界值生成
AI 工具不会猜你的业务规则。比如一个接收 $age 的方法，若没写 @param int $age 0-120，它大概率只生成 calculateTotal(25) 这种常规调用，漏掉 -1、121、null、"abc" 等边缘输入。
PHPDoc 必须包含三类信息才有效：
立即学习“PHP免费学习笔记（深入）”；
-
@param：标明类型 + 可接受范围（如@param float $amount >= 0） -
@throws：明确列出可能抛出的异常（如@throws InvalidArgumentException） -
@return：说明返回值约束（如@return string non-empty）
补完后右键触发生成，AI 才会输出类似这样的断言：
public function testCalculateTotalThrowsOnNegativeAmount(): void
{
$this->expectException(InvalidArgumentException::class);
$this->expectExceptionMessage('Amount must be non-negative');
$this->service->calculateTotal(-1.5);
}
覆盖率低时，直接对未执行行右键生成针对性用例
运行 phpunit --coverage-html coverage 后，打开 HTML 报告，找到标红的 else 块或 catch 分支——这些就是 AI 初始生成没覆盖到的地方。不要重跑整个方法，直接在那行代码左侧灰色区域右键，选「AI 生成该行测试」。
此时需输入简短提示，例如：
- “构造一个触发
catch (Exception $e)的输入，要求file_get_contents返回 false” - “让这个
if (strlen($name) < 2)为 true，且 $name 是 null”
注意：生成的 $this->expectException() 中异常类名必须和实际 throw 语句一致，写成 RuntimeException 却实际抛 LogicException 会导致测试永远失败。
PHP 8.5.7 的联合类型会影响 AI 输入推断
PHP 8.5 新增的联合类型（如 string|int|null）会让 AI 更难判断哪些值算“合法”。它可能忽略 null 场景，或把 int 和 string 混用（比如传 "123" 给期望 int 的参数）。
解决办法只有两个：
- 在 PHPDoc 里显式拆开写：
@param string|int|NULL $id，比string|int|null更易被解析 - 对含联合类型的参数，额外生成一组用例专门测类型冲突，例如
calculateTotal("123.5")应该触发TypeError或自定义校验
最常被忽略的是 mixed 类型——AI 几乎从不主动覆盖它，必须手动高亮该参数声明行，右键点「为选中行生成边界测试」，否则这部分逻辑永远裸奔。
