PyCharm 中 Flask 调试运行时工作目录意外上移一级，根本原因在于 python-dotenv 的 load_dotenv() 默认行为：它会静默地将当前工作目录切换至 .env 文件所在路径。即使 PyCharm 配置完全正确，该行为仍会干扰文件加载逻辑。
pycharm 中 flask 调试运行时工作目录意外上移一级，根本原因在于 `python-dotenv` 的 `load_dotenv()` 默认行为：它会静默地将当前工作目录切换至 `.env` 文件所在路径。即使 pycharm 配置完全正确，该行为仍会干扰文件加载逻辑。
在 PyCharm 中配置 Flask 项目时，开发者常陷入一个典型误区：反复检查「Run/Debug Configurations」中的 Working directory、Project Structure 设置、Python Console 路径等——所有界面配置看似无懈可击，但运行时仍出现 FileNotFoundError: [Errno 2] No such file or directory: 'config.yml' 或路径解析为 ~/file.yml（而非预期的 ~/projectname/file.yml）。问题并非 PyCharm 配置失效，而是 Flask 生态中一个鲜为人知却影响深远的隐式行为。
核心症结：load_dotenv() 的副作用
Flask 默认启用 python-dotenv 自动加载 .env 文件（通过 flask run 或 app.run() 触发），而 dotenv.load_dotenv() 在内部调用 os.chdir(os.path.dirname(filepath)) —— 即一旦找到 .env 文件，就立即将进程工作目录切换至该文件所在目录。若你的 .env 文件位于项目根目录的父级（例如在 Paths to .env files 中填写了 ../.env），或 PyCharm 的环境配置意外指向了上级路径，load_dotenv() 就会“悄无声息”地把工作目录拽上去一级。这直接导致后续 open('config.yml')、pathlib.Path('static/') 等相对路径操作全部失效。
验证方法
在应用入口（如 app.py 开头）添加诊断代码：
import os
print(f"[DEBUG] Initial working dir: {os.getcwd()}")
from flask import Flask
# 此处 load_dotenv 可能已被自动触发
print(f"[DEBUG] After Flask init: {os.getcwd()}")启动调试后观察输出变化，即可确认是否被 load_dotenv() 修改。
可靠解决方案
✅ 推荐方案：禁用自动加载，显式控制环境变量
在 PyCharm 的 Run/Debug Configuration → Environment variables 中添加：
FLASK_SKIP_DOTENV=1
然后在代码中手动、安全地加载环境变量，确保不改变工作目录：
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
from flask import Flask
from dotenv import load_dotenv
import os
app = Flask(__name__)
# 方式1：指定 .env 路径，且禁止 chdir（Python-dotenv ≥ 0.19.0）
load_dotenv(dotenv_path=os.path.join(os.path.dirname(__file__), '.env'), override=True, verbose=True)
# 方式2：更兼容的写法（适用于旧版 dotenv）
# load_dotenv(dotenv_path='.env', override=True) # 注意：仍可能 chdir，需升级库
@app.route('/')
def hello():
return f"Working dir: {os.getcwd()}"✅ 替代方案：Shell 启动脚本中预加载（适合 CI/本地部署）
若使用自定义启动脚本，避免依赖 Flask 自动机制：
#!/bin/bash set -o allexport source "$(dirname "$0")/.env" # 显式指定路径，不触发 chdir set +o allexport export FLASK_APP=app.py export FLASK_ENV=development flask run --host=0.0.0.0:5000
⚠️ 重要注意事项
- 升级
python-dotenv至≥0.19.0，新版支持chdir=False参数（默认仍为True，务必显式关闭）； -
FLASK_SKIP_DOTENV=1仅禁用 Flask 的自动加载，不影响你手动调用load_dotenv()； - PyCharm 的「Paths to .env files」字段本身不会触发
load_dotenv()，但它常暴露配置惯性错误——建议统一将.env放入项目根目录，并在代码中用os.path.join(os.path.dirname(__file__), '.env')绝对定位； - 不要依赖
os.chdir()临时修复，这会引入竞态风险，尤其在多线程 Flask 场景下。
从根本上说，这不是 PyCharm 的缺陷，而是 python-dotenv 设计中一个反直觉的默认行为。通过显式接管环境加载流程，既能规避陷阱，又能提升配置透明度和跨环境一致性。
