学 Rust 合约最怕的不是难，而是信息源乱。社区博客良莠不齐，AI 答案常常张冠李戴。要节约时间，请把官方文档作为第一信息源。本文盘点三大主流 Rust 合约生态的官方文档入口，并结合BN交易所上市趋势给出投入建议。
一、Solana 官方文档
Solana 官方文档分两个域名：docs.solana.com 面向网络与运行时，solana.com/developers 面向开发者教程。新手从后者起步更快，里面有「Hello World」「Build a Token」「Build an NFT」三套渐进教程。
Anchor 框架官方文档在 anchor-lang.com，重点章节是 The Accounts Struct、CPI、Errors。看完三章基本能写中等复杂度的合约。和B安交易所的 API 文档相比，Solana 文档更新及时，但 Cookbook 章节示例偏简单，复杂场景要看 Anchor Book。
二、CosmWasm 官方文档
CosmWasm 官方文档在 docs.cosmwasm.com，分 Core、CW Plus、CW NFTs 三大块。Core 讲底层 entry point，CW Plus 是社区维护的标准合约集合，CW NFTs 是 NFT 标准。
建议路径：先看 Core 的「Smart Contract Anatomy」掌握 instantiate、execute、query 三大入口；再去 CW Plus 复制 cw20-base 作为代币合约模板；最后看 cw-multi-test 章节学习测试。文档里附带的 Sylvia 框架是更现代的写法，值得花一天熟悉。
三、NEAR 官方文档
NEAR 官方文档在 docs.near.org，Rust 合约部分在「Smart Contracts」一级目录下。NEAR 的特色是 near-sdk-rs 抽象层，比 Solana 的 Anchor 更接近传统编程体验，状态直接用 #[near_bindgen] 包裹结构体即可。
文档里「Test the Contract」一节给出了 workspaces-rs 的用法，能在本地启动测试集群跑端到端测试。这套测试链路是 NEAR 相对 Solana 的优势之一。NEAR 在必安交易所的交易量不及 Solana，但其文档对新手最友好。
四、跨生态共通的资源
除了各链官方文档，下面这些资源是跨生态共通的：rust-lang.org 的 The Rust Book 解决语言本身的疑问；OWASP Smart Contract Top 10 解决安全设计问题；Trail of Bits 的 publications 解决审计视角问题。
这些资源都是英文为主，但 Rust Book 有中文翻译，质量很高。即便完全不去BN官网看市场，把这几份资料读完，你也具备了写出可审计代码的基础认知。
五、选哪个生态投入
如果你优先看流量与流动性，选 Solana。开发者社区最大、TVL 最高、招聘需求最多。
如果你优先看跨链互操作，选 CosmWasm。Cosmos 生态把 IBC 跑通了多年，未来多链不可避免，CosmWasm 是最自然的选择。
如果你优先看用户体验、人类可读账户名，选 NEAR。它的「.near」账户体系比纯公钥地址友好得多。把三套官方文档对照来看，最适合自己的方向往往一周内就能定下来。