VS Code命令行设置Flask环境变量不生效问题求助

可能原因及对应解决方案 #

1. 终端语法不匹配（Windows CMD vs PowerShell） #

你使用的set是CMD的环境变量设置语法，如果VS Code终端默认是PowerShell，该命令不会生效。PowerShell下需使用以下语法设置：

$env:FLASK_ENV = "development"
$env:FLASK_APP = "run.py"

执行完成后再启动Flask程序。

2. 虚拟环境未激活导致变量隔离 #

若使用了虚拟环境，必须先激活环境再设置变量：

# CMD环境激活虚拟环境
venv\Scripts\activate.bat

# PowerShell环境激活虚拟环境
venv\Scripts\Activate.ps1

激活后重新设置环境变量并运行程序。

3. VS Code终端会话缓存问题 #

关闭当前VS Code终端窗口，重新打开新终端，切换到run.py所在的remoire目录，重新执行环境变量设置命令后启动程序，避免旧会话缓存干扰。

4. 使用.env文件统一管理环境变量（推荐方案） #

无需每次手动设置，在项目根目录（与run.py同级）创建.env文件：

FLASK_ENV=development
FLASK_APP=run.py

安装python-dotenv包读取该文件：

pip install python-dotenv

修改run.py开头代码，自动加载环境变量：

from dotenv import load_dotenv
import os

load_dotenv()  # 加载.env文件中的变量

print(f"FLASK_ENV: {os.environ.get('FLASK_ENV')}")
from app import create_app

app = create_app()

if __name__ == "__main__":
    app.run()

5. 验证环境变量是否生效 #

设置变量后先在终端执行命令确认：

# CMD环境验证
echo %FLASK_ENV%

# PowerShell环境验证
echo $env:FLASK_ENV

若输出development，说明变量设置成功，再启动程序。

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