如何使用Python创建可编辑TOML配置文件的GUI程序

你的需求本质是带约束规则的交互式TOML配置编辑工具，整个开发路径可以拆成3个独立环节，每个环节都有成熟的Python方案，不需要从零实现底层逻辑：

• 环节1：整理配置项的约束规则
  你现有TOML的注释里已经标注了部分配置项的可选值，你可以选择两种方式管理规则：
  • 写简单正则从行尾注释里提取可选值、配置说明，不需要额外维护规则文件；
  • 单独用Python字典维护一份配置Schema，明确每个Section下每个配置Key的类型、可选值、默认值、说明文本，灵活度更高，后续新增配置项时维护成本更低。
• 环节2：实现交互式选择逻辑
  你要检索的核心方向是Python交互式命令行组件，常用的成熟方案：
  • 要做终端内支持方向键操作的选择菜单，直接用questionary库，内置单选列表、多选列表、输入校验、数字输入等现成组件，只需要把可选值列表传入对应方法，就能直接生成可用的交互菜单，自动处理键盘监听、终端渲染、输入合法性校验等底层逻辑，不需要自己造轮子。
  • 只需要最简交互的话，不需要第三方库，直接用print输出带序号的可选值列表，引导用户输入对应序号选择，自己做简单的输入合法性判断即可。
  • 如果后续想做图形界面，检索Python轻量GUI配置编辑相关内容即可，PySimpleGUI等库可以快速生成带下拉选择框的界面，核心逻辑和命令行版本完全一致。
• 环节3：配置值回写
  不要直接用普通TOML解析库的dump方法覆盖原文件，这类库默认会丢失原文件的注释、空行、排版格式。要保留原有格式的话，用tomlkit库做TOML的读写，它支持完整保留原文件的所有注释和排版，只修改你指定的配置项的值，写回后不会破坏原有配置文件的结构。

最小实现逻辑参考 #

import tomlkit
import questionary

# 读取原有配置，完整保留格式与注释
with open("your_config.toml", "r", encoding="utf-8") as f:
    config = tomlkit.load(f)

# 配置规则Schema，也可以通过解析注释自动生成
config_schema = {
    "APU": {
        "apu": {
            "desc": "音频系统",
            "options": ["any", "nop", "sdl", "xaudio2"]
        }
    },
    "CPU": {
        "break_condition_gpr": {
            "desc": "GPR对比值",
            "value_type": int
        },
        "break_condition_op": {
            "desc": "对比运算符",
            "options": ["eq", "neq", "gt", "lt", "ge", "le"]
        }
    }
}

# 遍历配置项引导用户选择/输入
for section, key_rules in config_schema.items():
    for config_key, rule in key_rules.items():
        # 有可选值的配置项走选择逻辑
        if "options" in rule:
            selected_val = questionary.select(
                message=f"设置 {section}.{config_key}：{rule['desc']}",
                choices=rule["options"],
                default=config[section][config_key]
            ).ask()
            config[section][config_key] = selected_val
        # 数字类型配置项走输入逻辑
        elif rule.get("value_type") == int:
            input_val = questionary.text(
                message=f"设置 {section}.{config_key}：{rule['desc']}",
                default=str(config[section][config_key]),
                validate=lambda x: x.lstrip("-").isdigit()
            ).ask()
            config[section][config_key] = int(input_val)

# 写回配置文件，保留原有格式
with open("your_config.toml", "w", encoding="utf-8") as f:
    tomlkit.dump(config, f)

如果你不想引入第三方依赖，把questionary的交互部分换成自己写的print+input逻辑即可，tomlkit也可以替换成手动按行匹配修改的逻辑，只是开发量会稍大。

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