在哪里可以找到pyc字节码文件结构的权威解析参考资料？

所有pyc格式的规则本质是CPython实现的内部约定，没有独立的第三方通用标准，最准确的参考全部来自CPython官方代码与配套文档，具体可查的可靠渠道如下：

一级权威参考（零偏差，适配所有版本） #

• CPython源码对应实现，是100%准确的规则来源：
  • pyc文件头（魔数、校验信息、元数据段）的结构、各版本魔数值、版本迭代带来的头部长度变动，全部定义在Python/importlib/_bootstrap_external.py中，包括3.7版本新增的源文件长度字段、3.8版本新增的哈希校验模式头部结构，都能在该文件的pyc读写逻辑里直接找到对应定义
  • marshal序列化层的所有规则（包括你需要的类型标识位含义、各数据类型编码解码逻辑、嵌套对象递归解析规则）全部实现在Python/marshal.c中，核心读逻辑在r_object函数、写逻辑在w_object函数，每个类型对应的标识字节、整数/字符串/浮点数/复数/None/True/False/code object等所有类型的编码方式都有明确实现
  • code object的字段顺序、co_flags标志位的逐位定义、各版本新增/删除的code object字段，全部定义在Include/cpython/code.h头文件中——marshal序列化code object时完全按照该结构体的字段顺序写入，你对应版本按顺序读取字段即可，不会出现错位
• Python官方文档中dis、inspect模块的公开说明，其中列出了所有对外公开的字节码指令含义、code object标志位常量定义，可用于解码完成后的字节码反汇编、代码属性校验环节

二级参考（适配多版本，降低踩坑成本） #

• 成熟开源pyc解析/反编译项目的兼容实现：这类项目通常已经把近20个Python大/小版本的pyc结构差异、marshal格式变动、标志位新增规则做了全量适配，你可以对照其版本分支逻辑补全自己的兼容层，不用逐个翻遍所有历史版本的CPython源码找差异
• 注意不要采信网上零散的“pyc通用结构说明”，这类内容大多只覆盖Python 2.x或早期Python 3.x版本规则，Python 3.6之后对pyc头部、marshal编码、code object结构做过至少4次不兼容调整，直接套用老规则解析新版本pyc必然出错

解码核心避坑提示 #

• 不存在跨所有Python版本的固定pyc结构，解码第一步必须先读取文件前2字节的魔数，映射到对应的CPython版本后，再调用该版本对应的解析规则读取后续内容
• marshal序列化统一使用小端字节序，所有多字节数值类型不要按大端解析
• co_flags是按位存储的标志位集合，不同版本会新增标志位定义，不要用固定的硬编码映射表解析所有版本的标志位
• 你目前用的marshal+dis加载方案本质是调用当前Python环境内置的解码逻辑，只能用来校验同版本pyc的解析结果是否正确，不能作为独立解码器的实现逻辑，也无法解析其他版本生成的pyc文件

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