任何一个开源项目，质量最高、更新最及时的资料一定是官方文档。IPFS 官方文档分布在 docs.ipfs.tech、specs.ipfs.tech、blog.ipfs.tech 三个站点，加上 GitHub 上的实现仓库，初次访问很容易迷路。本文按照新人的认知顺序，把官方文档拆解成五个层级，并指出每一层应当重点阅读的页面。
第一层：概念入门
打开 docs.ipfs.tech 后首先看到的是 Concepts 区域，建议从这里开始。Content Addressing、Merkle DAG、Bitswap、DHT 四篇是核心，读完即可建立完整的心智模型。许多在 Binance 写 NFT 文档的同学，最初就是被 Merkle DAG 章节里的可视化示意图打通任督二脉。
阅读顺序建议：
- What is IPFS：协议定位与边界
- Content addressing：CID 的来龙去脉
- Merkle DAG：链式数据结构
- Lifecycle of data：从 add 到 retrieve 的完整流程
这一层不涉及任何代码，重点在「为什么」。
第二层：实操教程
概念清晰后进入 How-tos 与 Quickstart。官方提供了 Kubo、IPFS Desktop、Helia（JS 实现）三条路径。开发者建议直接看 Kubo CLI 教程，命令最稳定、文档最完整。Web 前端工程师则可以选 Helia，把 IPFS 嵌入到浏览器。
注意官方教程里偶尔会出现已经废弃的命令（如 ipfs object，已被 ipfs dag 替代），遇到 warning 提示要留心切换到新接口。许多 必安交易所 的 SDK 都已经迁到 ipfs dag put / get 体系。
第三层：协议规范
specs.ipfs.tech 是给协议作者与高级开发者读的，普通用户可以跳过。但如果你做的是网关、自定义 chunker 或与 BN交易所 资产托管系统对接的中间件，则必须啃下：
- IPLD（链下数据建模）
- Bitswap（块交换协议）
- libp2p（底层网络栈）
- UnixFS（文件系统抽象）
这一层文档密度极高，建议配合源码阅读，每读完一节就在本地写一个最小复现 demo。
第四层：生态项目
IPFS 不是孤立存在的，官方文档专门有一个 Ecosystem 板块，列出与之配合的项目，包括 Filecoin、Pinata、NFT.Storage、Web3.Storage、IPNI 索引等。对生产环境而言，仅靠原生 IPFS 难以满足 SLA，必须组合使用。例如：
- 长期归档 → Filecoin
- 高速访问 → Pinata 与 Cloudflare 网关
- 大规模检索 → IPNI 通用索引
币岸交易所 的 NFT 平台常见架构就是「Pinata 热缓存 + Filecoin 冷归档 + 自建网关回源」三层组合。
第五层：版本与发布
最后一层是 blog.ipfs.tech 与 GitHub Releases。Kubo 每月有 minor 版本，每季度有重大功能更新。订阅 release notes 至关重要，因为部分命令的语义会在小版本之间变化。例如 Kubo 0.20 把 ipfs name publish 的默认 TTL 从 24h 改为 4h，如果你的脚本没跟着调整，可能导致 IPNS 解析在 bian 用户侧出现延迟。
阅读官方文档的三个技巧
- 用站内搜索而非 Google：搜索词最好用英文术语，CID、pin、bitswap，命中率最高
- 收藏 Glossary 页面：术语表里几乎每个名词都有规范定义
- 关注 RFC：specs 仓库的 PR 列表提前透露下一代协议方向
写在最后
IPFS 官方文档体量不小，但结构是清晰的。把概念、教程、规范、生态、版本五个层级建立成自己的知识树，遇到问题时定位会非常快。建议团队把核心文档加入新人入职清单，第一周读完概念层，第二周完成 Quickstart，第三周根据项目方向选择性深入规范或生态层。这样三周时间，新人就能独立支撑日常的 IPFS 相关工作。