VSCode怎么配置Pest PHP测试_VSCode Pest测试发现与快捷运行配置-VSCode-PHP中文网

vscode需手动配置pest：设php-test-explorer.testframework为pest、executablepath指向${workspacefolder}/vendor/bin/pest，tasks.json定义shell任务调用该路径，launch.json用"program"指定该入口并配xdebug_mode=debug及pathmappings。

vscode怎么配置pest php测试_vscode pest测试发现与快捷运行配置

Pest 是 PHP 社区近年主流的测试框架，语法更简洁、开箱即用，但 VSCode 默认不识别它——你点“运行测试”没反应、右键找不到 pest 命令、终端里 ./vendor/bin/pest 能跑，VSCode 却报错“command not found”，这些都不是 Pest 本身的问题，而是 VSCode 没被正确告知“怎么找它、怎么调它”。

VSCode 找不到 `pest` 命令？先确认 CLI 环境和 VSCode 进程是否一致

VSCode 的调试器、任务、终端（即使开了集成终端）可能使用不同的环境变量。尤其在 macOS/Linux 下，GUI 启动的 VSCode 往往不继承 shell 的 PATH。

在 VSCode 终端里执行 which pest 或 ./vendor/bin/pest --version —— 如果失败，说明 VSCode 根本没看到你的项目 vendor/bin
不要依赖全局安装的 pest（它不推荐，且版本易冲突），必须用项目本地的 ./vendor/bin/pest
解决方案：在 VSCode 设置中搜索 terminal.integrated.env.，为 Linux/macOS 加 "terminal.integrated.env.linux": { "PATH": "/usr/local/bin:/opt/homebrew/bin:${env:PATH}" }；Windows 用户则确保系统 PATH 包含 PHP 和 Composer bin 目录
更稳的做法：所有任务都用绝对路径或工作目录约束，而不是指望环境变量自动生效

`tasks.json` 配置单文件/全量 `pest` 运行任务

VSCode 的任务系统能让你 Ctrl+Shift+P → “Tasks: Run Task” 快速触发测试，但默认没有 pest 模板，需手动定义。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在项目根目录建 .vscode/tasks.json，内容如下（适配 Pest v2+）：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "pest: current file",
      "type": "shell",
      "command": "${workspaceFolder}/vendor/bin/pest",
      "args": ["${fileBasename}"],
      "group": "test",
      "presentation": {
        "echo": true,
        "reveal": "always",
        "focus": false,
        "panel": "shared",
        "showReuseMessage": true,
        "clear": true
      },
      "problemMatcher": ["$php"]
    },
    {
      "label": "pest: all",
      "type": "shell",
      "command": "${workspaceFolder}/vendor/bin/pest",
      "args": [],
      "group": "test",
      "presentation": {
        "echo": true,
        "reveal": "always",
        "focus": false,
        "panel": "shared",
        "showReuseMessage": true,
        "clear": true
      },
      "problemMatcher": ["$php"]
    }
  ]
}

${fileBasename} 是关键：它只传文件名（如 CalculatorTest.php），pest 会自动匹配类名并加载；别写 ${file}（含路径），容易因命名空间解析失败
如果项目用了自定义 --tests 目录或 --config，记得加进 args，例如 ["--tests=tests/Feature", "--config=phpunit.xml"]

`launch.json` 调试 `pest` 测试时断点不命中？Xdebug 模式和入口脚本要对齐

pest 本质是封装了 PHPUnit 的 CLI 工具，调试它和调试 phpunit 类似，但入口不是 vendor/bin/phpunit，而是 vendor/bin/pest —— 这个细节常被忽略。

在 .vscode/launch.json 中添加配置：

{
  "name": "pest: debug current file",
  "type": "php",
  "request": "launch",
  "program": "${workspaceFolder}/vendor/bin/pest",
  "args": ["${fileBasename}"],
  "cwd": "${workspaceFolder}",
  "externalConsole": false,
  "env": {
    "XDEBUG_MODE": "debug"
  },
  "pathMappings": {
    "/var/www/html": "${workspaceFolder}"
  }
}

pathMappings 是 Docker / WSL 用户最容易漏的：如果你在容器里跑 PHP，本地路径和容器内路径不一致，断点永远不生效
env.XDEBUG_MODE=debug 必须显式设置——即使 php.ini 里写了 xdebug.mode=debug，VSCode 启动的进程也不会自动继承
别用 "request": "attach" 模式去连 pest：它不是长期运行的服务，"launch" 才是正解

右键菜单直接运行 `pest`？靠 `PHP Test Explorer` 插件补足

VSCode 原生不支持测试发现（test discovery），PHP Test Explorer 是目前唯一稳定支持 Pest 的插件，它能扫描 tests/ 下所有 *Test.php 文件并生成树状列表。

安装插件后，在设置中搜 php-test-explorer.testFramework，设为 pest
必须指定 php-test-explorer.executablePath 为 ${workspaceFolder}/vendor/bin/pest（绝对路径优先）
如果测试文件用了 uses() 或自定义 TestCase 基类，确保 composer.json 的 autoload-dev 正确加载了 tests/ 目录，否则插件扫描时会跳过它们
右键某个测试方法 → “Debug Test” 会自动构造参数并启动调试；但注意：它不会自动传递 --filter，所以方法名含特殊字符（如冒号）可能失败