PhpStorm右键单个PHP文件Run报Class not found，因其默认不加载vendor/autoload.php且工作目录为项目根，导致PSR-4映射失效、相对路径解析错误、环境变量缺失；需手动chdir+require autoload.php或配置专用PHP Script运行配置。
不能直接“运行单一模块”——PhpStorm 没有模块级运行入口，所谓“剥离依赖”本质是绕过自动加载、控制工作目录和手动补全 require 链。
为什么右键单个 PHP 文件 → Run 会报 Class not found
PhpStorm 的 Run 操作默认使用项目根目录为工作目录，并且完全不加载 vendor/autoload.php。哪怕你的模块在 modules/user 下，文件里写了 new App\UserService()，也会直接 Fatal error: Class 'App\UserService' not found。
- 自动加载器未触发：没有执行
require 'vendor/autoload.php'，PSR-4 映射形同虚设 - 相对路径失效：文件中
include '../config/database.php'会按项目根目录解析，而非模块子目录 - 环境变量缺失：.env 或 config/*.php 不会被自动载入
临时运行模块内文件的可靠做法
核心思路：用 Ctrl+Shift+F10 启动，但提前在文件头部手动补全加载逻辑，把“模块独立运行”变成“脚本自举”。
- 在模块内目标文件（如
modules/api/test.php）顶部加三行：
<?php chdir(__DIR__ . '/../../'); // 跳回项目根，确保 autoload.php 可见 require_once 'vendor/autoload.php'; // 接着写你要测的代码，比如 new Api\V1\Handler()→handle();
- 确保该文件以
.php结尾，且含合法<?php标签 - 不要依赖
$_SERVER或框架生命周期钩子（如 Laravel 的app()->boot()），那些不在php test.php环境里 - 若模块本身无
composer.json，需确认其类已声明在主项目的autoload['psr-4']中，否则即使 require autoloader 也找不到类
永久配置：为模块创建专用 Run Configuration
适合高频测试的模块入口（如 modules/cli/runner.php）。它能固化路径、参数和工作目录，避免每次改代码头。
立即学习“PHP免费学习笔记（深入）”；
- 按
Alt+Shift+F10→0打开运行配置列表，选Edit Configurations… - 点
+→ 选PHP Script - 填入：
Script path设为模块内文件绝对路径（如$ProjectFileDir$/modules/cli/runner.php） -
Working directory设为$ProjectFileDir$（保持与 composer autoloader 一致） - 勾选
Use alternative configuration file并指向模块专属的.env.cli（如有） - 保存后，下拉选择该配置，按
Shift+F10即可复用
真正隔离模块？别信“模块运行”，用独立终端 + composer bin
当模块具备完整 composer.json 和命令行入口时，php -d variables_order=EGPCS ./vendor/bin/module-cli 才是真正的隔离。PhpStorm 的 Run 功能只是快捷执行器，不是容器。
- 在模块目录下运行
composer require --dev phpunit/phpunit，它不会污染主项目 - 用 PhpStorm Terminal 切到模块路径，执行
phpunit tests/—— 这才是模块级测试的正轨 - IDE 内的
Run始终共享项目解释器和全局 autoloader，所谓“剥离”只是人工模拟，稍有疏漏就崩
最易被忽略的一点：模块内 require_once 'config/common.php' 看似简单，但路径解析依赖当前 getcwd()；而 PhpStorm 的 Run 不保证这个值与你预期一致——必须显式 chdir() 或用 __DIR__ 锚定，不能赌 IDE 行为。
