PhpStorm不支持Shell表达式，仅通过宏变量（如$FilePath$、$ProjectFileDir$）实现路径动态替换，且仅在特定字段生效；含空格路径须用双引号包裹，Windows需用正斜杠，变量依赖焦点文件，调试可用echo查看实际参数。
PhpStorm 本身不支持在「外部工具」或「运行配置」里直接写 Shell 表达式（比如 $(pwd) 或 ${PWD}），所谓“动态替换执行路径”，实际靠的是 IDE 内置的宏变量（macro variables），不是 Shell 变量。用错地方会发现路径始终为空、报错找不到文件，或者参数被原样传给命令而没展开。
PhpStorm 宏变量在哪能用、哪些能用
宏变量只在特定字段生效，不是所有输入框都认：$ProjectFileDir$、$FilePath$、$FileNameWithoutExtension$ 这类最常用，但必须出现在「External Tools」的 Working directory 或 Arguments 字段，以及「Run Configuration」的 Script path、Program arguments 等位置。
-
$ProjectFileDir$：项目根目录绝对路径，不含尾部斜杠；Windows 下是C:/project，不是C:\project -
$FilePath$：当前编辑文件的绝对路径，含扩展名；如果没打开文件，这个值为空 -
$FileDir$：当前编辑文件所在目录，不含文件名；和$FilePath$配合可拼出相对路径 -
$UserHome$和$SystemRoot$也可靠，但$Env{PATH}这类环境变量宏在外部工具中基本无效——它不继承 shell 启动时的环境
写复杂参数时容易漏掉的转义和空格问题
当你在 Arguments 字段填 --input $FilePath$ --output $ProjectFileDir$/dist/$FileNameWithoutExtension$.json，看似合理，但一旦路径含空格（比如 C:/My Project/src/main.php），命令就会被拆成多个参数，--input C:/My 直接报错。
- 所有含空格或特殊字符的宏变量，必须用双引号包裹：
"$FilePath$"，不能只包一部分 - Windows 下路径分隔符反斜杠会被当作转义符处理，所以
$ProjectFileDir$\dist是错的；统一用正斜杠$ProjectFileDir$/dist，IDE 会自动适配 - 如果参数本身要传双引号（比如 JSON 字符串），得写成
--data "{\"key\":\"value\"}"，外层引号是 PhpStorm 解析用的，内层需手动转义 - Mac/Linux 用户注意：
$ProjectFileDir$返回的是 POSIX 路径，但如果你在 Arguments 里混用$(basename ...)这类 Shell 命令，它不会执行——那只是字符串字面量
为什么 $FileDir$ 有时返回空、$FilePath$ 不更新
这两个变量依赖当前焦点文件。如果没打开任何 PHP/文本文件，或者你从项目视图右键菜单触发外部工具（而非在编辑器里按快捷键），$FilePath$ 就是空字符串，导致命令执行失败或路径错误。
立即学习“PHP免费学习笔记（深入）”；
- 确保操作前已打开目标文件，并且光标落在编辑器内（哪怕只是点一下）
- 避免在「Project」面板中右键目录 → «Run xxx»，这种上下文不绑定具体文件，
$FilePath$失效 - 想对整个目录批量操作？改用
$ProjectFileDir$+ 手动拼路径，或写个 wrapper 脚本接收目录作为参数 - 调试方法：临时把外部工具的
Program设为echo（macOS/Linux）或cmd /c echo（Windows），看实际传入的参数长什么样
真正复杂的参数组合（比如带条件判断、多级目录查找、Git 当前分支名注入），别硬塞进宏变量；该写 shell 脚本就写脚本，让 PhpStorm 只负责传入稳定的基础路径，其余逻辑交给系统 Shell 处理。宏变量是捷径，不是万能补丁。
