如何从JSON文件加载argparse命令行参数并强制校验必填项

核心思路是将JSON配置的参数先转换为argparse可识别的命令行参数列表，再和终端传入的参数合并后统一交给parse_args处理，完全复用argparse原生的校验逻辑，无需额外开发校验功能。

完整可运行代码 #

import argparse
import json
import sys

def load_args_from_json(json_path):
    with open(json_path, 'r', encoding='utf-8') as f:
        json_args = json.load(f)
    # 将JSON键值对转换为命令行参数格式的列表
    args_list = []
    for k, v in json_args.items():
        args_list.append(f"--{k}")
        # 适配布尔类型参数（action="store_true"类的参数，值为True时不需要额外传值）
        if not isinstance(v, bool) or not v:
            args_list.append(str(v))
    return args_list

if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    # 新增可选的配置文件参数，优先级低于终端直接传入的参数
    parser.add_argument("--config", type=str, help="JSON配置文件路径")
    
    # 原有参数定义完全不需要修改
    parser.add_argument("--image_path", type=str, required=True)     
    parser.add_argument("--count", type=int, required=True)
    
    # 先解析已知的配置文件路径参数，避免其他参数干扰
    temp_args, _ = parser.parse_known_args()
    
    json_args = []
    if temp_args.config:
        json_args = load_args_from_json(temp_args.config)
    
    # 合并参数：终端传入的参数在后，会覆盖JSON里的同名参数，可按需调整优先级
    final_args = json_args + sys.argv[1:]
    args = parser.parse_args(final_args)
    
    # 如需留存所有使用的参数（含默认值、JSON传入、终端传入的所有参数），直接导出即可
    all_used_args = vars(args)
    # with open("runtime_args.json", "w", encoding="utf-8") as f:
    #     json.dump(all_used_args, f, indent=2, ensure_ascii=False)
    
    print(args)

使用方法 #

1. 编写JSON配置文件args.json示例：

{
    "image_path": "./test.png",
    "count": 10
}

2. 运行脚本：python your_script.py --config args.json
3. 临时需要修改参数时直接在终端传参即可覆盖JSON配置，例如：python your_script.py --config args.json --count 20，最终count取值为20

方案优势 #

• 完全复用argparse原生的必填校验、类型校验、默认值逻辑，不需要额外开发校验代码
• 直接支持JSON格式配置，不需要转换为换行分隔的参数文件
• 配置文件参数和终端参数可同时使用，优先级可灵活调整
• 最终可直接导出所有运行参数（含默认值），满足参数留存需求

注意：如果参数定义使用了action="store_true"/action="store_false"，只需要在JSON中对应键传true/false即可，代码已做适配。

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