为何在Python读写TOML文件需采用二进制模式？

核心原因有三点： #

• 强制UTF-8编码解析：TOML规范明确要求文件必须以UTF-8编码存储。用二进制模式打开后，tomli会自行以UTF-8解码内容，避免了Python文本模式下使用系统默认编码（比如Windows下的GBK）导致的解码错误或乱码问题。
• 严格校验换行符合法性：TOML规范仅允许LF（0x0A）或CRLF（0x0D 0x0A）作为换行符，单独的CR（0x0D）属于非法格式。如果使用Python的文本模式（默认开启通用换行），Python会自动将CR、CRLF、LF统一转换为LF，这会让tomli无法检测到单独CR这种不符合规范的情况，无法抛出正确的错误提示。而二进制模式下，tomli可以直接读取原始字节流，自行校验换行符是否符合TOML标准，确保解析的严格性。
• 精确控制换行处理逻辑：虽然TOML允许LF/CRLF，但在某些场景（比如多行字符串的解析）中，需要严格按照规范处理换行转换。比如TOML规定，基本字符串中的CRLF会被转换为LF，而字面量字符串中的CRLF则会被保留。如果让Python的通用换行提前处理，会破坏原始字节流的信息，导致tomli无法按照规范区分处理这些场景，进而引发解析结果不符合预期的问题。

正确使用示例 #

读取TOML文件：

import tomli

with open("path_to_file/conf.toml", "rb") as f:
    toml_dict = tomli.load(f)

写入TOML文件（需使用tomli-w库）：

import tomli_w

with open("path_to_file/conf.toml", "wb") as f:
    tomli_w.dump(toml_dict, f)

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