Ubuntu系统下Visual Studio Code如何设置环境变量

以下所有方案都不需要你在集成终端手动执行export类命令配置，配置完成后直接启动代码即可自动加载对应环境变量：

方案1：工作区launch.json配置（项目级，最推荐） #

配置仅对当前项目生效，不会污染全局环境，支持团队共享配置：

• 在项目根目录新建.vscode文件夹（已存在就跳过）
• 文件夹内新建launch.json文件，写入Python运行配置，环境变量直接定义在env字段即可
  参考配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 运行当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "env": {
                "PYTHONPATH": "${workspaceFolder}",
                "CUSTOM_VAR1": "test_value",
                "DB_PORT": "3306"
                // 按需追加键值对即可
            },
            "envFile": "${workspaceFolder}/.env"
        }
    ]
}

说明：就算你选集成终端作为输出控制台也没关系，环境变量是VSCode启动Python进程时直接注入的，不需要你手动在终端输任何配置命令。只要你通过VSCode左侧「运行和调试」面板启动代码，配置就会生效。

方案2：.env文件自动加载（适合多变量/敏感变量场景） #

VSCode官方Python扩展默认会自动读取工作区根目录下的.env文件，不需要额外安装插件：

• 在项目根目录新建名为.env的文件
• 按变量名=变量值的格式逐行写入环境变量，不要加export前缀，无特殊需求不要给值加引号
  示例内容：

PYTHONPATH=./src
DB_PASSWORD=your_private_password
API_KEY=abc123def456

如果你的.env文件不在项目根目录，修改launch.json里的envFile字段指向对应路径即可。

方案3：用户级全局配置（所有Python项目通用） #

如果是个人开发通用的环境变量，不想每个项目重复配置，可以设置全局生效的规则：

• 按Ctrl+Shift+P调出命令面板，搜索Preferences: Open User Settings (JSON)回车打开用户配置文件
• 加入对应配置，指定全局env文件路径即可：

{
    "python.envFile": "/home/你的用户名/.vscode_global_python.env"
}

之后你在指定的全局env文件里写通用环境变量，所有打开的Python项目运行时都会自动加载。

方案4：代码层面加载（脱离VSCode也能生效） #

如果希望代码不依赖VSCode的加载逻辑，哪怕换其他编辑器、部署到服务端也能自动读环境变量，可以用代码层面的加载方案，全程不需要操作终端：

• 给当前Python环境安装依赖：pip install python-dotenv
• 在项目入口文件的最顶部加两行加载代码：

from dotenv import load_dotenv
load_dotenv()

后续代码里直接用os.getenv("你的变量名")就能读取到对应值，只要.env文件放在对应路径下，不管用什么方式启动代码都能生效。

注意：存了密钥、数据库密码的.env文件不要提交到Git仓库，记得把.env加入项目的.gitignore列表。

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