悠悠楠杉
网站页面
Python环境变量配置全指南：从入门到实战
12/19
![]()
在Python开发中，环境变量是管理敏感信息（如API密钥、数据库密码）和区分不同运行环境（开发/生产）的核心工具。与直接硬编码在脚本中相比，环境变量能显著提升安全性和灵活性。本文将系统介绍环境变量的配置方法，并提供实战代码示例。
一、为什么需要环境变量？
- 安全性：避免将敏感信息暴露在代码仓库中。
- 环境隔离：同一套代码可适配开发、测试、生产不同环境。
- 跨平台兼容：解决不同操作系统路径或依赖的差异问题。
二、系统级环境变量配置
1. Windows系统
通过图形界面设置：
- 右键“此电脑” → 属性 → 高级系统设置 → 环境变量 → 在“用户变量”或“系统变量”中新增。
通过命令行（临时生效）：cmd
set MY_VARIABLE=my_value
2. Linux/macOS系统
临时生效（终端会话内）：bash
export MY_VARIABLE="my_value"
永久生效：将上述命令添加到~/.bashrc或~/.zshrc文件中。
三、Python代码中操作环境变量
1. 使用os模块
Python内置的os模块可直接读写环境变量：
import os
# 设置环境变量（仅当前进程有效）
os.environ["DB_HOST"] = "localhost"
# 获取环境变量
db_host = os.getenv("DB_HOST", "default_host") # 第二个参数为默认值
print(f"数据库地址：{db_host}")
2. 使用python-dotenv管理.env文件
项目根目录创建.env文件：env
SECRET_KEY=your_secure_key
DEBUG=True
通过python-dotenv加载：
from dotenv import load_dotenv
load_dotenv() # 自动加载.env文件
secret = os.getenv("SECRET_KEY")
if os.getenv("DEBUG") == "True":
print("调试模式已开启")
四、实战场景：Flask项目配置
在Web开发中，环境变量常用于配置框架参数。以Flask为例：
from flask import Flask
import os
app = Flask(__name__)
app.config["SECRET_KEY"] = os.getenv("FLASK_SECRET_KEY", "fallback_key")
@app.route("/")
def home():
return "环境变量配置成功！"
if __name__ == "__main__":
app.run(debug=os.getenv("FLASK_DEBUG") == "True")
五、注意事项
- 不要提交.env文件：将其添加到
.gitignore中。 - 类型转换：环境变量默认是字符串，需手动转换布尔值/数字。
- 容器化部署：在Docker中通过
-e参数传递环境变量。
通过合理使用环境变量，你的Python项目将更安全、更易于维护。现在就去尝试吧！
