Python ConfigParser 百分号排错：字面值、插值和读取边界怎么选
配置能读进来，为什么取值时才报错
脚本原先只读取目录，后来新增一个带百分号编码的下载地址，配置文件照常加载，真正使用地址时却抛出异常。此时不宜先怀疑网址失效。配置解析器可能在取值阶段解释了百分号，而地址里的百分号本来属于网址自身。排错要先区分文件语法、插值语法和最终消费者这三个环节。
官方文档说明，默认插值使用百分号括号形式引用当前节或默认节中的选项，两个连续百分号表示一个字面百分号；解析按需发生。单次读取可用 raw=True 绕过插值，整个解析器则可设置 interpolation=None。两者都不等于修复占位符，只是选择把保存的文字直接交给调用者。
AI生成概念示意图，非真实界面
同一类内容，用三个解析器作对照
下面代码只处理内存字符串，不会访问示例地址。第一组保留目录引用和转义后的进度文字，同时故意放入未转义的网址；第二组把所有值当作字面文本；第三组启用扩展插值，展示跨节引用。每组使用独立实例，避免某次配置修改影响下一组结论，适合直接保存成文件运行。
from configparser import (
ConfigParser, ExtendedInterpolation,
InterpolationSyntaxError, InterpolationMissingOptionError,
)
basic = ConfigParser()
basic.read_string("""[job]
root = /srv/demo
output = %(root)s/out
label = progress 80%%
url = https://example.invalid/a%20b
""")
assert basic.get("job", "output") == "/srv/demo/out"
assert basic.get("job", "label") == "progress 80%"
assert basic.get("job", "label", raw=True) == "progress 80%%"
try:
basic.get("job", "url", fallback="unused")
except InterpolationSyntaxError:
print("basic percent URL: interpolation error")
else:
raise AssertionError("expected percent syntax error")
print("raw URL:", basic.get("job", "url", raw=True))
literal = ConfigParser(interpolation=None)
literal.read_string("""[job]
url = https://example.invalid/a%20b
output = %(root)s/out
""")
assert literal["job"]["url"].endswith("a%20b")
assert literal["job"]["output"] == "%(root)s/out"
print("literal placeholder:", literal["job"]["output"])
extended = ConfigParser(interpolation=ExtendedInterpolation())
extended.read_string("""[paths]
root = /srv/demo
[job]
output = ${paths:root}/out
url = https://example.invalid/a%20b
price = $$8
missing = ${not_defined_here}
""")
assert extended["job"]["output"] == "/srv/demo/out"
assert extended["job"]["url"].endswith("a%20b")
assert extended["job"]["price"] == "$8"
try:
extended["job"]["missing"]
except InterpolationMissingOptionError:
print("missing config reference: error")
else:
raise AssertionError("expected missing reference error")
print("extended output:", extended["job"]["output"])默认模式中，目录会替换成实际路径，进度文字中的双百分号会还原成一个。原始读取则保留双百分号，也能取出网址。网址选项存在但插值失败时，备用值并不会接管这个异常；因此不要用增加 fallback 掩盖语法错误。程序启动时主动读取实际使用的字段，能比等到工作开始后再失败更容易定位。
选择语法以后，约定谁负责转义
如果配置主要保存网址、日志格式或外部模板，关闭插值往往更直观；但已有的目录占位符也会原样返回，不能只修好新增网址而漏掉旧字段。迁移时应列出每个关键字段的预期最终值，比较迁移前后结果。不要对整个文件机械替换百分号，否则原本正确的引用也会变成普通文字。
若仍然需要默认插值，写配置的一方必须按该语法转义字面百分号。这里的转义只服务于配置层，不会完成网址解码，交给网络客户端前还应保留它需要的原始编码。对于程序生成的配置，最好让写入端和读取端共享一份规则，避免编辑器展示一个字符串、运行时却得到另一个字符串。
扩展插值也有自己的边界
扩展模式用美元符号和花括号进行引用，字面美元符号写成两个；百分号可以直接保留。示例中的跨节目录能够展开，但缺失引用明确报错。花括号内的名称是在配置中查找，不会因为长得像 shell 变量就自动读取进程环境。环境变量展开是另一项独立操作，应明确需要哪些名称后再引入。
人工验收应覆盖正常引用、字面百分号、字面美元符号、缺失引用和循环引用，并核对最终值而非只检查加载是否成功。把原始值与解析结果对照记录时，也应避开真实口令等内容。对可由外部人员修改的配置，插值只解决文字组合，不能替代路径范围、地址范围和数值类型等业务校验。
