科技 · 实用指南
TOML 提示表被重复声明？删标题前先核对键路径
引号名称、点分键和生成段可能在文字不同的情况下冲突。保留原文件，核对解析树，再验证下一次生成。
重复表错误指的是语义路径，不一定是两行完全相同的文字。删除标题、改键名或重跑安装器前，先保留文件并确认谁在写它。
1. 保留准确文件与写入者
编辑前复制原配置。记录应用真正读取的路径、解析器或 Python 版本、完整错误，以及文件是人工维护、合并还是生成的。报错行通常指出第二次声明；应向前寻找已占用同一路径的声明，而非立即删除该行。
检查输出时暂停失败的生成步骤，在笔记中区分工具管理值与用户自有值。不要把含凭据的完整配置提交在线验证器；制作脱敏的最小复现，保留冲突键结构即可。
2. 比较路径片段，不只比较标题字符串
CPython 3.12.14 样本中，[service.api] 后接 [service."api"] 会失败：给同一片段加引号不会创建新表。相反，[service."api.v1"] 与 [service.api.v1] 解析成不同的树；前者含字面键 api.v1，后者是 api 下再嵌套 v1。因此，改键名或移动引号可能改变应用配置，不只是格式。
逐项写出路径片段及其应有值。不要通过文本搜索把标题中的每个点都拆开：引号内的点属于名称。空白或等价引号写法都不能作为生成器判断唯一性的可靠依据。
3. 判断路径之前是怎样定义的
同组实验中，service=1 后接 [service.api] 会被拒绝；service.api.port=8000 后再写 [service.api] 也被拒绝。内联 service={api={port=8000}} 后尝试扩展 [service.api] 同样失败。这是值与表或声明的冲突，改缩进并不能修复语义。
隐式父表不同：先写含 port 的 [service.api]，再写含 name 的 [service]，实验可以解析。真正重复的 service.api 段合并为一个同时保留 port 与 host 的段，也可解析。先确定表由哪个声明管理，保留所有必需值；不要自创“最后一个覆盖前面”规则，也不要盲删整段。
4. 验证解析树，再测试下一次写入
用应用支持的解析器处理候选副本。Python 3.11+ 的 tomllib.load 接收二进制打开的文件，tomllib.loads 接收字符串；它检查 TOML 语法，不检查应用允许哪些选项，也不会写入 TOML。我们的 8 组样本在 CPython 3.12.14 按 TOML 1.0 规则运行；Python 3.15 增加 TOML 1.1 支持，版本差异应明确。
核对解析结果中的必需键路径、类型和值，再执行应用自带的安全配置检查。若文件由生成器维护，在一次性副本上连续运行两次，确认两份输出都可解析、用户值保留且没有新增重复表。然后才在留有备份的前提下替换正式文件。下次生成又损坏的人工修补不算完成，应修复写入工具或使用其文档明确的修正版。
