PyCharm全局环境变量与项目级环境变量的区别与设置

“全局环境变量”这一概念常被误解为在 PyCharm 中为所有项目统一设定参数，但在实际排查问题时，我们往往需要区分两个不同层级的变量：一是 Windows 用户或系统级别的环境变量，二是特定项目的运行或调试配置变量。这两者的设置入口各异，影响范围也不尽相同。

首先明确判断标准：希望多个程序和项目都能继承的基础值，放在 Windows 环境变量中；只为某次脚本运行准备的值，放在对应的 Run/Debug Configuration 中。 此外，PyCharm 中还有一处常被误认为“全局”设置的终端配置，但它仅控制 PyCharm 内部终端会话的环境，并不等同于 Python 程序的运行配置。

先看变量属于谁：Windows 提供基础环境

Windows 用户变量仅对当前登录账户有效，而系统变量则作用于整台计算机。程序启动时会加载一份进程环境变量，新创建的子进程通常继承父进程的环境设置。因此，存储在 Windows 环境变量中的 PATH 或常用工具路径，可能被从该环境启动的 PyCharm、终端及其他应用程序共同读取。用户变量适合个人工具配置，而修改系统变量时需考虑其对其他账户及机器层面的潜在影响。

可通过 Windows “系统”属性中的“高级系统设置”进入“环境变量”界面，分别编辑用户变量或系统变量。变量值通常为文本格式；需注意，修改后已运行的程序不会自动更新环境。若 PyCharm 在修改前已启动，排查时应重启应用或相关终端以加载新环境，再观察结果。

系统变量提供启动环境，运行配置可为本次启动补充变量

项目只需一份值：放进运行/调试配置

例如，当开发与生产环境需要不同的 APP_MODE，或脚本依赖仅在本机提供的 DATA_DIR 时，可为对应的 Python Run/Debug Configuration 添加环境变量。打开运行/调试配置，选择目标配置，在 Environment variables 栏中编辑名称和值。PyCharm 将依据此配置启动脚本；同一项目可为不同脚本或用途保留独立配置，无需将临时值写入 Windows 公共环境。

在目标运行配置中维护只供该配置启动使用的值

此类设置仅作用于“由该配置启动的进程”，并非 Python 代码中的局部变量，也不会自动修改 Windows 用户变量。若在 PyCharm 终端中手动执行脚本，不应假定其会使用某 Run/Debug Configuration 的专属值，因为终端会话与运行配置属于不同的启动路径。涉及密码或令牌时，切勿将真实密钥直接写入可能提交或共享的配置文件，需先确认项目配置是否纳入版本管理。

名字相同要看启动路径和进程实际拿到的值

程序读取的是当前进程的环境变量。Windows 基础变量与运行配置中额外设置的变量可共存于启动环境中；若同名变量在不同层级均被设置，切勿凭“全局一定覆盖项目”或反之的猜测判断结果。解决冲突时，应先检查运行时进程实际读取的值，明确只保留一个来源，或在启动配置中显式设置该项。

在 Python 中，可使用 os.getenv("APP_MODE") 查看脚本当前获取的值。需注意，这仅反映程序运行时的环境状态，无法追溯变量最初来源是 Windows、PyCharm 配置还是启动终端。建议使用非敏感测试变量验证：在系统层设一个基础值，在单独运行配置设另一个值，分别从目标入口启动并观察输出。切勿使用真实密钥进行演示。

变量最终由启动进程读取，终端设置和运行配置属于不同入口

PyCharm 终端设置是另一条独立入口

在 PyCharm 的 Settings > Tools > Terminal 中，可以看到应用级与项目级终端设置。官方说明中，应用级设置影响当前 PyCharm 实例打开的各个项目的终端；项目级的 Environment variables 则用于当前项目中新建的终端会话。它们解决的是终端启动时的环境需求，不应与 Python 运行/调试配置的 Environment variables 混为一谈。

因此，首要问题是“谁需要读取这个值”：若多个 Windows 程序共用，应设置在操作系统层；若仅供某个脚本启动使用，则放在该运行配置中；若仅需 PyCharm 终端会话使用，则检查 Terminal 的应用级或项目级设置。正确选择作用范围，比将所有值堆砌在所谓的“全局环境”中更易于维护，也更有利于定位脚本读取意外结果的原因。