VSCode运行正常但终端执行Python脚本遇MinIO初始化错误

原因分析 #

• 终端直接执行python main.py时，代码严格按从上到下的顺序执行：先执行from logisticsVerification import start，此时start.py里的minioclient = MinioClient(bucket_name=bucket_name)会立即初始化，而这时候load_dotenv还没运行，.env中的环境变量未加载，导致MinIO客户端因缺少必要参数报错。
• VSCode调试时，其Python插件默认会在启动Python进程之前，自动扫描工作目录下的.env文件并将环境变量注入到运行环境中。因此哪怕代码里load_dotenv在导入语句之后，MinIO初始化所需的环境变量已经存在，所以能正常运行。

解决方法 #

方案1：调整代码执行顺序（最稳妥） #

确保load_dotenv在所有依赖环境变量的导入语句之前执行，也就是你已经验证有效的写法：

from pathlib import Path
from dotenv import load_dotenv

# 先加载.env
env_path = Path(__file__).resolve().parent / ".env"
load_dotenv(dotenv_path=env_path)

# 再导入依赖环境变量的模块
from logisticsVerification import start

这种写法不依赖外部环境配置，在任何运行场景下都能保证环境变量先加载。

方案2：让终端自动加载.env #

如果不想调整代码，可以配置终端自动加载.env文件，和VSCode调试环境保持一致：

• bash/zsh终端：在项目目录下执行以下命令（或把命令添加到~/.bashrc/~/.zshrc，但需注意路径问题）：

  export $(grep -v '^#' .env | xargs) && python main.py
  

• 使用python-dotenv的命令行工具：安装python-dotenv后，通过以下命令运行脚本，会先加载.env再执行代码：

  python -m dotenv run python main.py
  

• VSCode集成终端同步配置：在项目的.vscode/settings.json中添加以下配置，让VSCode的集成终端自动加载指定的.env文件：

  {
    "python.envFile": "${workspaceFolder}/.env",
    "terminal.integrated.env.linux": {},
    "terminal.integrated.env.osx": {},
    "terminal.integrated.env.windows": {}
  }
  

内容的提问来源于stack exchange，提问作者user26558855