【详细教程如何在PyCharm中设置环境变量】在使用 PyCharm 进行 Python 开发时，环境变量的设置对于项目运行、调试和部署非常重要。正确配置环境变量可以确保程序能够读取到所需的路径、数据库连接信息、API 密钥等关键数据。以下是一份关于如何在 PyCharm 中设置环境变量的详细教程。
一、说明
在 PyCharm 中设置环境变量主要有两种方式：通过运行配置（Run/Debug Configurations）设置，或通过项目解释器的环境变量设置。不同的项目结构可能需要不同的设置方法。此外，还可以通过 `.env` 文件配合 `python-dotenv` 库来管理环境变量，适用于开发阶段的灵活配置。
以下是常见的几种设置方式及其适用场景：
| 设置方式 | 适用场景 | 是否推荐 |
| Run/Debug 配置中的 Environment variables | 临时测试、调试 | 推荐 |
| 项目解释器的环境变量 | 全局项目配置 | 推荐 |
| .env 文件 + python-dotenv | 开发环境配置 | 推荐 |
| 系统环境变量 | 多项目共享、生产环境 | 不推荐 |
二、具体操作步骤
1. 通过 Run/Debug 配置设置环境变量
- 打开 PyCharm，点击右上角的运行配置（默认为 `Unnamed`）。
- 选择 `Edit Configurations...`。
- 在弹出窗口中找到你的运行配置（如 `Python` 或 `Script` 类型）。
- 在 `Environment variables` 字段中输入键值对，格式为 `VAR_NAME=value`，多个变量用分号 `;` 分隔。
- 点击 `OK` 保存设置。
> 注意：这种方式只对当前配置生效，适合调试阶段使用。
2. 通过项目解释器设置环境变量
- 打开 `File > Settings > Project: [项目名] > Python Interpreter`。
- 点击右侧齿轮图标，选择 `Show All...`。
- 选择当前使用的解释器，点击 `Interpreter Options`。
- 在 `Environment variables` 输入框中添加环境变量。
- 点击 `Apply` 和 `OK` 保存。
> 注意：此设置适用于整个项目的所有运行任务，适合统一配置。
3. 使用 `.env` 文件 + `python-dotenv`
- 安装 `python-dotenv`：
```bash
pip install python-dotenv
```
- 在项目根目录创建 `.env` 文件，格式如下：
```
DB_HOST=localhost
DB_USER=admin
DB_PASSWORD=123456
```
- 在代码中加载环境变量：
```python
from dotenv import load_dotenv
import os
load_dotenv()
db_host = os.getenv("DB_HOST")
```
> 注意：`.env` 文件不提交到版本控制中，适合开发环境使用。
三、常见问题与注意事项
| 问题 | 解决方案 |
| 环境变量未生效 | 检查是否重启了运行配置或解释器 |
| 环境变量冲突 | 确保变量名称唯一，避免覆盖 |
| 生产环境不建议使用 | 使用系统环境变量或配置文件更安全 |
| .env 文件被提交 | 在 `.gitignore` 中加入 `.env` |
四、总结
在 PyCharm 中设置环境变量是开发过程中不可或缺的一部分，合理使用环境变量可以提高项目的灵活性和安全性。根据项目需求选择合适的设置方式，例如：开发阶段使用 `.env` 文件，调试阶段使用 Run/Debug 配置，而全局配置则可通过项目解释器设置。掌握这些技巧，能有效提升开发效率和代码可维护性。
