Working directory设错会导致“找不到配置”或“只检查了部分文件”，必须设为$ProjectFileDir$以确保PHPStan、php-cs-fixer等工具正确加载根目录下的phpstan.neon、.php-cs-fixer.php等配置文件，避免因路径错误引发各类解析失败问题。
Working directory设错会导致“找不到配置”或“只检查了部分文件”
PHPStorm里几乎所有外部工具（PHPStan、php-cs-fixer、PHPUnit、自定义脚本）都依赖Working directory决定从哪开始找配置文件、解析相对路径、扫描源码范围。设成$ProjectFileDir$是最安全的选择——它指向你用PhpStorm打开的那个项目根目录，确保phpstan.neon、.php-cs-fixer.php、phpunit.xml这些文件能被正确加载。
常见错误现象：
- PHPStan报
Configuration file "phpstan.neon" not found，但文件明明就在项目根目录 - php-cs-fixer修复后没生效，或者提示
Could not open input file: .php-cs-fixer.php - PHPUnit运行时找不到测试类，或
--bootstrap路径报错
原因基本都是Working directory被误设为$FileDir$（当前文件所在目录）或空值。一旦工具从子目录启动，就看不到根目录下的配置。
External Tools配置中必须显式填$ProjectFileDir$
在Settings → Tools → External Tools里添加命令时，Working directory字段不能留空，也不能依赖IDE自动推断。必须手动输入：$ProjectFileDir$。
立即学习“PHP免费学习笔记（深入）”；
这个变量是PhpStorm内置宏，展开后就是你打开项目的绝对路径，比如/home/user/my-project或C:\dev\my-project。它和$ProjectConfigDir$（存.idea的目录）不同，后者可能指向别的位置。
实操要点：
- 不要用
$FileDir$：它会随你当前编辑的文件变化，比如你在src/Controller/下右键运行，工具就从那里启动，根本读不到根目录的phpstan.neon - 别写死绝对路径：跨机器、跨系统就失效；也别写相对路径如
../，PhpStorm不解析 - 验证方法：在External Tool的Arguments里加
--debug或pwd（Linux/macOS）/cd（Windows），看控制台输出的实际路径
Run Configuration里的Working directory影响PHPUnit和内置Web Server
不只是External Tools，Run → Edit Configurations里新建的PHP Script、PHPUnit、PHP Built-in Web Server也都需要检查Working directory。
对PHPUnit来说，设错会导致：
-
bootstrap文件路径解析失败（比如vendor/autoload.php找不到） - 测试数据文件（
tests/_data/）读取失败 - XML配置中
<php><include path="..."></include></php>失效
对PHP Built-in Web Server，Working directory虽不直接暴露，但它决定了Document root的基准——如果你把Document root设为public，而Working directory却是$FileDir$，那实际服务的根目录就可能变成/path/to/current/file/public，而非项目根下的public。
建议统一设为$ProjectFileDir$，再配合Document root填public或web等子目录名。
Working directory和Environment Variables共同决定临时路径行为
虽然PHP的upload_tmp_dir、sys_temp_dir必须在php.ini里改，但Working directory会影响你本地调试时某些工具的行为边界。
比如Composer安装、phpunit生成coverage报告、甚至Xdebug日志写入，都会受sys_get_temp_dir()返回值影响——而该函数优先读环境变量TMPDIR（macOS/Linux）或TEMP（Windows）。你在Run Configuration里设置的Environment variables，会覆盖系统默认值，但前提是Working directory正确，否则环境变量可能被忽略或作用域错乱。
所以：先保证Working directory是$ProjectFileDir$，再在Environment variables里加TMPDIR=/tmp/my-project-tmp，才能让所有子进程真正落到你指定的临时目录。
最容易被忽略的是：External Tools和Run Configuration是两套独立设置，改完一个不等于另一个也同步了。每个地方都要单独确认。
