使用Golang操作二进制PLIST文件读取与写入

P粉602998670

发布时间：2026-02-19 10:27:52

418人浏览过

来源于php中文网

原创

go读二进制plist需先调用plist.registerbinaryformat()注册解码器，再用支持seek()的io.reader（如os.file）配合plist.decode解析；写入时须设enc.format = plist.binaryformat，否则默认输出xml格式。

使用golang操作二进制plist文件读取与写入

Go 读 PLIST 二进制格式会 panic：没注册解码器

直接用 plist.Unmarshal 或 xml.Unmarshal 读二进制 PLIST 文件，大概率触发 panic: unknown format 或解析出空结构。因为标准库不支持 PLIST，而社区主流包（如 howeyc/plist）默认只认 XML 格式，对二进制格式需显式启用解码器。

必须调用 plist.RegisterBinaryFormat()，且要在任何解码操作前执行一次（通常放 init() 或 main() 开头）
该函数内部注册了 binary 格式的 Decoder，否则 plist.Decode 会跳过二进制头直接报错
不调用它，哪怕文件确实是二进制格式，也会被当成损坏或未知格式处理

用 plist.Decode 读取二进制文件的正确姿势

别用 Unmarshal([]byte)，二进制 PLIST 不是纯文本，不能靠字节切片直解；得用带 io.Reader 的 plist.Decode，并确保底层 Reader 支持 Seek()（比如 os.File）。

打开文件用 os.Open，传给 plist.Decode，不要先 ioutil.ReadAll 再传字节切片
二进制 PLIST 头部含偏移表，解析器需要随机跳转，bytes.Reader 不支持 Seek，会导致 invalid offset table 类错误
示例关键行：dec := plist.NewDecoder(file); err := dec.Decode(&v)，其中 v 是目标 struct 或 map[string]interface{}

写入二进制 PLIST：Encoder 必须设 Format，否则输出 XML

默认 plist.NewEncoder 输出 XML 格式，即使你期望的是二进制——这容易导致下游工具（如 macOS 系统命令）无法识别。

青鸟内测（手机app封装、托管系统）

注意：请在linux环境下测试或生产使用青鸟内测是一个移动应用分发系统，支持安卓苹果应用上传与下载，并且还能快捷封装网址为应用。应用内测分发：一键上传APP应用包，自动生成下载链接和二维码，方便用户内测下载。应用封装：一键即可生成app，无需写代码，可视化编辑、直接拖拽组件制作页面的高效平台。工具箱：安卓证书生成、提取UDID、Plist文件在线制作、IOS封装、APP图标在线制作APP分发：

下载

必须显式调用 enc.Format = plist.BinaryFormat，在 Encode() 前设置
写入目标应为 *os.File 或其他支持 Write() 的 io.Writer，但注意：二进制格式对 writer 没 Seek 要求
若写入后用 plutil -p 查看提示 Invalid property list，八成是格式没设对，或结构里含不支持的 Go 类型（如 func、chan、未导出字段）

struct 字段映射到 PLIST 的隐含规则

PLIST 没有原生布尔/整数类型区分，全靠值内容推断；Go struct 字段名大小写和 tag 直接影响键名生成，稍不注意就写错键。

立即学习“go语言免费学习笔记（深入）”；

导出字段自动转为驼峰转中划线（BundleIdentifier → bundle-identifier），如需保留原名，加 plist:"BundleIdentifier" tag
bool、int、string、[]interface{}、map[string]interface{} 可直映射；time.Time 会被转成 NSDate 字符串，但二进制 PLIST 中实际存的是浮点秒数（自 2001-01-01），无需手动处理
嵌套 struct 若字段未导出（小写开头），对应键将丢失，PLIST 中表现为 null 或整个字段消失