在VSCode的launch.json中配置多环境自定义变量方案咨询

方案1：通过launch.json直接传递环境专属参数 #

直接在VS Code的launch配置中为不同环境预设完整参数，让argparser保持原有必填校验逻辑，完全规避参数遗漏问题。

步骤： #

1. 提前整理好生产/开发环境的参数值，比如：

   • 生产环境：username=prod_user、server_ip=192.168.1.100、server_version=v2.3
   • 开发环境：username=dev_user、server_ip=127.0.0.1、server_version=v3.0-dev

2. 修改launch.json，添加两个配置项分别对应生产和开发：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Run Production",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "args": [
                "--username", "prod_user",
                "--server_ip", "192.168.1.100",
                "--server_version", "v2.3",
                "--password", "prod_pass"
            ]
        },
        {
            "name": "Run Development",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "args": [
                "--username", "dev_user",
                "--server_ip", "127.0.0.1",
                "--server_version", "v3.0-dev",
                "--password", "dev_pass"
            ]
        }
    ]
}

3. 代码中的argparser保持原有必填设置，无需修改：

import argparse

parser = argparse.ArgumentParser()
parser.add_argument("--username", required=True, help="Server username")
parser.add_argument("--server_ip", required=True, help="Server IP address")
parser.add_argument("--server_version", required=True, help="Server version")
parser.add_argument("--password", help="Server password (optional)")

args = parser.parse_args()

# 后续直接使用 args.username、args.server_ip 等参数

选择对应launch配置运行时，程序会自动获得对应环境的完整参数，argparser会正常校验必填项，不会出现参数遗漏问题。

方案2：代码中先加载环境配置，再给argparser设默认值 #

通过代码先加载对应环境的配置文件，将配置值作为argparser参数的默认值，既支持环境切换，又允许用户通过命令行覆盖默认值，同时保持参数校验逻辑。

步骤： #

1. 在项目根目录创建两个环境配置文件：

   • prod.env：

     USERNAME=prod_user
     SERVER_IP=192.168.1.100
     SERVER_VERSION=v2.3
     PASSWORD=prod_pass
     

   • dev.env：

     USERNAME=dev_user
     SERVER_IP=127.0.0.1
     SERVER_VERSION=v3.0-dev
     PASSWORD=dev_pass
     

2. 修改launch.json，通过环境变量指定运行环境：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Production",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "env": {"RUN_ENV": "prod"}
        },
        {
            "name": "Development",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "env": {"RUN_ENV": "dev"}
        }
    ]
}

3. 代码中使用python-dotenv加载配置并设置argparser默认值：

import argparse
import os
from dotenv import load_dotenv

# 根据环境变量加载对应配置文件
run_env = os.getenv("RUN_ENV", "dev")
load_dotenv(f"{run_env}.env")

# 校验配置文件中必填项是否存在
required_configs = ["USERNAME", "SERVER_IP", "SERVER_VERSION"]
for key in required_configs:
    if not os.getenv(key):
        raise ValueError(f"Missing required config {key} for environment {run_env}")

# 初始化argparser，将配置值设为默认值
parser = argparse.ArgumentParser()
parser.add_argument("--username", default=os.getenv("USERNAME"), help="Server username (defaults to config value)")
parser.add_argument("--server_ip", default=os.getenv("SERVER_IP"), help="Server IP address (defaults to config value)")
parser.add_argument("--server_version", default=os.getenv("SERVER_VERSION"), help="Server version (defaults to config value)")
parser.add_argument("--password", default=os.getenv("PASSWORD"), help="Server password (optional)")

args = parser.parse_args()

这种方式既保证了环境配置的有效性，又允许用户通过命令行参数临时覆盖默认值，argparser无需设置nargs='?'，避免了参数遗漏风险。

方案3：结合launch.json的envFile与代码参数兜底校验 #

利用launch.json的envFile加载对应环境的变量，代码中优先使用命令行参数，无参数时取环境变量，兜底校验必填项，兼顾灵活性与安全性。

步骤： #

1. 同方案2，创建prod.env和dev.env配置文件。

2. 修改launch.json，为不同环境指定对应的envFile：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Production",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "envFile": "${workspaceFolder}/prod.env"
        },
        {
            "name": "Development",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "envFile": "${workspaceFolder}/dev.env"
        }
    ]
}

3. 代码中实现参数优先级逻辑并校验必填项：

import argparse
import os

parser = argparse.ArgumentParser()
parser.add_argument("--username", help="Server username")
parser.add_argument("--server_ip", help="Server IP address")
parser.add_argument("--server_version", help="Server version")
parser.add_argument("--password", help="Server password (optional)")

args = parser.parse_args()

# 优先用命令行参数，无则取环境变量，都没有则报错
username = args.username or os.getenv("USERNAME")
if not username:
    parser.error("username is required (use --username or set in env file)")

server_ip = args.server_ip or os.getenv("SERVER_IP")
if not server_ip:
    parser.error("server_ip is required (use --server_ip or set in env file)")

server_version = args.server_version or os.getenv("SERVER_VERSION")
if not server_version:
    parser.error("server_version is required (use --server_version or set in env file)")

password = args.password or os.getenv("PASSWORD")

这种方式既保留了envFile的便捷性，又通过代码兜底校验确保必填参数不会遗漏，argparser无需修改原有结构。

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