### 如何在 Python 项目中配置 `.env` 文件 要在 Python 项目中配置并使用 `.env` 文件，可以通过 `python-dotenv` 库来加载环境变量。以下是具体方法： #### 安装依赖库 首先需要安装 `python-dotenv` 库，这是用来解析和加载 `.env` 文件的核心工具[^1]。 ```bash pip install python-dotenv ``` #### 创建 `.env` 文件 创建一个名为 `.env` 的文件，并将其放置于项目的根目录下。该文件的内容应遵循键值对的形式，例如： ```plaintext DATABASE_URL=postgres://user:password@localhost:5432/mydatabase SECRET_KEY=mysecretkey123 DEBUG=True ``` #### 加载 `.env` 文件中的变量 通过以下代码片段可以轻松加载 `.env` 文件中的变量到当前环境中: ```python from dotenv import load_dotenv import os # 加载 .env 文件 load_dotenv() # 获取单个环境变量 db_url = os.getenv('DATABASE_URL') print(f'Database URL: {db_url}') # 或者设置默认值 debug_mode = os.getenv('DEBUG', 'False').lower() == 'true' print(f'Debug Mode: {debug_mode}') ``` 上述代码会自动查找位于工作目录下的 `.env` 文件并将其中定义的变量注入到系统的环境变量中。 #### 封装读取逻辑 如果希望进一步简化操作或者批量处理所有的环境变量，则可以构建如下函数[^2]: ```python def get_env_variable(name, default=None): """获取指定名称的环境变量""" value = os.getenv(name, default) if value is None: raise ValueError(f"Environment variable '{name}' not found.") return value def load_all_env_variables(): """加载所有环境变量至字典""" env_dict = {} with open('.env') as f: for line in f.readlines(): key, var = line.partition("=")[::2] env_dict[key.strip()] = var.strip() return env_dict ``` 调用方式如下所示： ```python all_vars = load_all_env_variables() for k, v in all_vars.items(): print(k, "=", v) specific_var = get_env_variable('SECRET_KEY') print("Secret Key:", specific_var) ``` 以上实现了从 `.env` 中提取特定变量以及全部变量的功能。 --- #### 注意事项 尽管 `.env` 和其他类似的配置文件（如 `env.properties`）都可以存储应用所需的参数，但它们的应用场景可能有所不同[^3]。对于更复杂的多平台部署需求来说，`.env` 更加轻量级且易于维护；而某些框架可能会优先支持像 Java 这样的语言所使用的 `properties` 格式文件。 ---