PhpStorm项目级环境变量仅在显式配置的运行/调试配置中生效，Terminal不读取该配置，故getenv()返回false；需通过右键运行PHP文件或启用对应环境配置才能生效。
很多开发者容易混淆一个概念：PhpStorm 的项目级环境变量，并不是通过修改系统 PATH 或全局设置来实现的。它的生效范围非常明确——只在你明确指定的运行或调试配置里起作用，并且不会“污染”你的 CLI 全局环境。这既是它的设计特点，也是隔离不同项目配置的关键。
为什么 getenv() 在 Terminal 里读不到你配的变量
问题就出在这里。PhpStorm 内置的 Terminal 工具窗口，默认行为是直接继承你系统 shell 的环境（比如 macOS/Linux 下的 ~/.zshrc 或 ~/.bashrc，Windows 下的系统变量）。它完全不会去读取你在项目「Environments」里精心配置的那些变量。
这些变量，只为那些“被 PhpStorm 显式调用”的场景服务，比如执行一个 PHP 脚本、运行 PHPUnit 测试，或者启动一个特定的 CLI 工具配置。
- 所以，当你在 Terminal 里直接输入
php -r "var_dump(getenv('APP_ENV'));"并得到false时，别慌，这是正常现象。因为这条命令绕过了 PhpStorm 的环境注入机制。 - 反过来，如果你右键点击一个 PHP 文件，选择
Run 'xxx.php'，或者执行一个已经绑定了正确环境的 PHPUnit 配置，那么代码中的getenv('APP_ENV')就能顺利拿到预设的值。 - 有个小技巧可以验证环境是否成功注入：在运行配置里，点击「Modify options」，然后勾选「Show command line afterwards」。执行前，你会看到 PhpStorm 实际拼装的命令，里面通常包含了类似
-d variables_order=EGPCS和明确的变量定义如APP_ENV=local。
怎样创建并绑定一个项目专用的环境
首先，别在全局 Settings 里大海捞针——那里设置的“环境变量”只是影响所有新项目的默认值，无法实现项目级隔离。真正的项目级配置，必须使用「Environments」功能。
具体路径是：在项目视图中，右键点击你的 Project 根目录，选择 New → Environment。
- 命名有讲究：建议名称里带上项目缩写和环境标识，比如
myapp-dev。这能有效避免与团队其他成员或不同项目的环境产生冲突。 - 变量设置规范：添加变量时，键名应避免空格和特殊符号。如果值是文件路径，Windows 用户需要注意：要么使用双反斜杠
C:\\myapp\\config，要么统一使用正斜杠C:/myapp/config；macOS/Linux 用户则使用标准斜杠即可。 - 启用是关键：创建环境后，它并不会自动生效。你必须手动右键点击这个环境，选择
Enable。同样，要禁用时就选择Disable。 - 多环境管理：你可以为同一个项目创建多个环境（如 dev、staging、prod），但同一时间只能启用一个。切换环境后，记得重启当前正在运行的配置，新环境变量才会生效。
运行/调试配置里怎么选对环境
这是最关键的一步。即使你创建并启用了名为 myapp-prod 的环境，如果不把它关联到具体的运行配置上，它就是个摆设。
操作核心在 Edit Configurations 对话框中，找到你需要配置的 PHP Script、PHPUnit 或 CLI Tools 配置。
立即学习“PHP免费学习笔记（深入）”；
- 打开目标配置后，切换到
Environment标签页。注意，这里不是让你手动填变量，而是在下拉框里选择你已启用的环境名称。 - 如果下拉框是空的，通常有两个原因：一是你还没有启用任何环境；二是项目结构没有及时刷新。可以尝试重启 PhpStorm，或者在项目根目录上右键选择
Reload project。 - 小心这个选项：
Include parent environment variables听起来方便，但可能是个陷阱。勾选后，它会将系统的 PATH、HOME 等变量全部引入，有可能意外覆盖你精心配置的DB_HOST等关键变量。为了保持环境的纯净和可控，通常建议不勾选。 - 重要区分：通过这种方式配置的环境变量，对于调试 Web 请求（例如使用 Xdebug）是无效的。Web 请求的环境变量需要通过 Web 服务器（如 Nginx、Apache）的配置，或者 PHP-FPM 的
env[XXX]指令来注入，这与 PhpStorm 的运行配置是两套独立的体系。
导出/导入环境配置的实操要点
在团队协作或需要配置 CI/CD 环境时，靠截图或口头传递变量容易出错。PhpStorm 支持将环境配置导出为 JSON 文件，但导入时有一些细节需要注意。
- 导出操作：在项目视图中，展开
Environments目录，右键点击目标环境，选择Export to file，保存为例如.env.json的文件。 - 文件格式必须严格：导入文件的内容必须是纯 JSON 数组，格式如下：
[{"name":"APP_ENV","value":"staging"},{"name":"CACHE_DRIVER","value":"redis"}]。如果 JSON 外层多了一个对象包装，或者里面包含了注释，都会导致导入失败。 - 导入后的状态：成功导入后，新环境不会自动启用，你仍需手动右键启用它。另外，如果已存在同名环境，PhpStorm 不会覆盖，而是会创建一个带编号的新副本，例如
myapp-dev (1)。 - 安全警告：切勿将包含敏感信息（如数据库密码、API密钥）的 JSON 文件提交到 Git 仓库。务必使用
.gitignore文件忽略*env.json这类文件。对于敏感配置，更推荐结合 dotenv 插件和.env.local（且被 .gitignore 忽略）的方式来管理。
最后，还有一个根本性的原理需要理解：PhpStorm 注入的环境变量，只对由它主动启动的 PHP 进程有效。它不会去修改 PHP 内核中 $_ENV 超全局变量的运行时快照，也不会让 putenv() 函数动态设置的值持久化。如果你的脚本内部使用 exec() 或 shell_exec() 调用了子进程，这些子进程能否继承环境变量，取决于 PHP 自身的进程派发行为，这已经超出了 PhpStorm 的控制范围。理解这一点，能帮助你在更复杂的调试场景中准确定位问题。
