Uvicorn 不解析 DEBUG、ENVIRONMENT 等环境变量，仅识别自身启动参数；需在代码中用 os.getenv() 手动读取并传给 uvicorn.run() 的 reload 和 log_level 参数，或在命令行前置设置（如 DEBUG=true uvicorn ...）。
Uvicorn 的 ENVIRONMENT、DEBUG 等环境变量不生效，通常是因为 uvicorn 没有读取它们——它压根不认这些变量。
Uvicorn 本身不解析通用环境变量
很多人误以为设置 DEBUG=True 或 ENVIRONMENT=development 就能让 uvicorn 自动切模式，但 uvicorn 实际只识别自己定义的启动参数（如 --reload、--log-level），对常见框架级环境变量（如 FastAPI 的 DEBUG、Django 的 DEBUG）完全无感。这些变量是否起作用，取决于你用的 Web 框架（比如 FastAPI）是否在代码里主动读取并响应它们。
- uvicorn 启动时不会自动加载
.env文件，也不会读取DEBUG、ENVIRONMENT、APP_ENV这类变量 - FastAPI 的
debug参数默认是False，必须显式传入或从环境变量中手动读取再传进去 - 如果你用的是
uvicorn.run()函数调用方式，所有配置都得写死或通过os.getenv()手动拉取
FastAPI 中正确读取 DEBUG 环境变量的写法
想让 DEBUG=True 控制重载和详细日志，得在 Python 代码里自己处理，不能指望 uvicorn“感知”到。
Uvicorn 0.52.1
下载
Uvicorn 0.52.1 是 Python ASGI Web 服务器，提供异步应用服务及 WebSocket 支持，常用于 FastAPI、Starlette 等应用的开发和部署。本下载为官方 PyPI 通用 wheel 包，可使用 pip 安装，并由包管理器处理所需依赖。
- 用
os.getenv("DEBUG", "False").lower() in ("true", "1", "on")安全转布尔值，避免字符串比较陷阱 - 把结果传给
uvicorn.run(..., reload=debug_mode)和log_level="debug" if debug_mode else "info" - 示例代码片段：
import os
import uvicorn
from fastapi import FastAPI
app = FastAPI()
debug_mode = os.getenv("DEBUG", "False").lower() in ("true", "1", "on")
if __name__ == "__main__":
uvicorn.run(
"main:app",
host="0.0.0.0",
port=8000,
reload=debug_mode,
log_level="debug" if debug_mode else "info",
workers=1,
)
注意：reload=True 仅在开发时有效，且要求源码可监听（不适用于打包后部署）；生产环境禁用 reload，否则会出错或被忽略。
使用 uvicorn 命令行时环境变量怎么传才有效
命令行启动时，环境变量需在执行前注入，而不是写在配置文件或靠 uvicorn 解析。
- Linux/macOS：用
DEBUG=true uvicorn main:app --reload --log-level debug，变量必须放在命令最前面 - Windows PowerShell：
$env:DEBUG="true"; uvicorn main:app --reload --log-level debug（注意分号后空格） - 不要写成
uvicorn main:app --env-file .env—— uvicorn 没有--env-file参数，那是docker run或poetry的 - 若依赖
.env，得用python-dotenv在代码里提前load_dotenv()，uvicorn 不负责这事
容易被忽略的关键点
真正卡住人的地方，往往不是语法，而是执行上下文错位：
- 用 systemd 或 Docker 启动时，环境变量要写在 service 文件的
Environment=字段或docker run -e里，shell 脚本里的export对子进程无效 - 某些 IDE（如 PyCharm）运行配置里设的环境变量，只影响调试器启动的进程，不等于终端里
uvicorn命令的行为 -
reload只监视 Python 文件和模板，默认不监视.env或配置 YAML，改了环境变量得手动重启
