社区精选资源

先看哪一类

官方仓库与示例

• CesiumGS/cesium：CesiumJS 的全部源码与 issue 都在这个仓库，主分支已按 packages/engine、widgets 等拆包。解决的问题：文档和实际行为对不上时，可以直接翻源码或搜历史 issue，不用靠猜。
• Sandcastle 在线沙盒：官方示例环境，左边选示例、右边改代码、保存即重跑。解决的问题：想验证某个 API 在 1.121 里的真实行为，而不必先搭本地工程。
• CesiumJS 快速上手：从引入脚本到创建 Viewer、加载数据的完整步骤。解决的问题：需要一段与 1.121 同步的最小可运行代码，而不是年份不明的转载片段。
• CesiumJS API 参考：按类组织的接口文档，标了参数、默认值与引入版本。解决的问题：确认方法签名和参数名，避免照抄旧教程里的字段。
• CesiumJS 官方教程：官方维护的入门与专题教程集合。解决的问题：需要一个和当前版本同步的权威起点，而不是年份不明的转载。
• CesiumGS/cesium-native：C++ 实现的底层运行时，Cesium for Unreal 与 Unity 都建立在它之上。解决的问题：想知道 3D Tiles 请求、地形调度在引擎侧怎么落地时，看这份实现比看 JS 封装更清楚。
• CHANGES.md：逐版本记录新增、弃用与破坏性变更。解决的问题：升级前扫一遍，能提前发现被移除的参数，省掉大量"升级后不显示"的排查。
• CesiumJS Releases：带 tag 的发布记录。解决的问题：确认某个特性最早出现在哪个版本，需要回退时有明确目标。

教程、工程范例与中文社区

• Cesium 官方博客：新特性解读、3D Tiles 与平台能力更新。解决的问题：判断某个新接口是已发布可用，还是只停留在预告。
• cesium-webpack-example：官方给出的 webpack 构建样例，包含静态资源拷贝与 CESIUM_BASE_URL 设置。解决的问题：打包后 Worker、Assets、Widgets 样式 404 这一类高频故障。
• cesium-starter-app：最小可运行的工程骨架，演示 Viewer 初始化与模型加载。解决的问题：需要一个干净起点，而不是从零配构建、再逐个排除报错。
• TerriaJS：基于 Cesium 的大型地理数据门户，含图层目录、时间轴与数据源管理。解决的问题：想看生产级 Cesium 应用怎么组织状态与插件体系。
• 3d-tiles-samples：官方维护的 3D Tiles 样本集，覆盖多种扩展与压缩方式。解决的问题：自测加载器或瓦片管线时，需要能覆盖边界情况的样本数据。
• 掘金 Cesium 标签：中文社区里更新较快的 Cesium 文章聚合。解决的问题：国内底图接入、GCJ-02 偏移、性能调优这类问题的中文排查记录。
• Cesium 中文网社区：中文社区的学习资料与讨论区，含入门系列与实战帖。解决的问题：中文语境下的入门路径与国内底图、模型加载经验。

开源项目与工具

• 3d-tiles-tools：官方命令行工具集，可校验、优化、转换 3D Tiles。解决的问题：瓦片包打不开又看不出原因时，先用它跑一遍，把结构问题暴露出来。
• 3d-tiles-validator：专注规范校验的独立工具。解决的问题：判断一个 tileset 是数据不合规，还是加载代码写错。
• gltf-pipeline：glTF 与 GLB 的压缩、优化与格式转换，支持 Draco 与纹理压缩。解决的问题：模型体积过大拖慢首屏时，在入库前先压一遍。
• obj2gltf：把 OBJ 模型转成 glTF 或 GLB。解决的问题：上游只给 OBJ、而 Cesium 只吃 glTF 时的格式转换环节。
• cesium-terrain-builder：把 DEM 切片成 Cesium 可用的 quantized-mesh 地形。解决的问题：不想依赖 ion 地形、需要自建地形服务时的切瓦片工具。
• @cesium/engine（npm）：拆分后的引擎包，可不带 Widgets 单独引入。解决的问题：只要渲染内核、不要整套 UI 与样式时按需加载。
• awesome-cesium：社区维护的资源清单，按类别罗列库、工具与示例。解决的问题：想一次性浏览生态全貌，而不是逐个关键词搜。

规范、数据与发布包

• CesiumGS/3d-tiles：3D Tiles 规范的正文与版本演进记录。解决的问题：搞清 tileset.json 每个字段的含义，而不是靠试错。
• 3D Tiles 规范正文：按章节拆分的规范文档。解决的问题：自己实现加载或校验逻辑时对照原文，避免理解偏差。
• CesiumGS/glTF：Cesium 维护的 glTF 相关仓库，模型格式细节与扩展支持以它为准。解决的问题：确认某个 glTF 扩展在当前管线里是否被支持。
• SampleData：仓库自带的小体积示例数据，含模型、影像与 GeoJSON。解决的问题：写最小复现时不用到处找可用的测试数据。
• cesium（npm）：完整发行包，包含 Build 产物与 Widgets 样式。解决的问题：确认版本号、查看包内文件结构与样式路径。
• CesiumJS 产品页：列出平台能力边界、ion 资产与授权方式。解决的问题：判断某项能力是开源版自带，还是必须依赖 ion 账号。

社区问答

• Cesium 官方论坛：官方 Discourse 社区，Cesium 工程师会直接回复。解决的问题：API 行为疑问、ion 账号与授权、以及疑似库缺陷的确认。
• Stack Overflow · cesium 标签：英文问答存量最大的地方。解决的问题：拿报错原文直接搜，多数基础用法与配置问题已有答案。
• CesiumJS Issues：bug 与回归的正式入口，附复现步骤与修复进度。解决的问题：怀疑是库本身的问题时，先确认是否已有人报过、是否已有临时绕法。
• r/gis：Reddit 的 GIS 综合版，Cesium 讨论零散但视角偏实战。解决的问题：选型对比、性能取舍这类没有标准答案的经验交流。

注意事项

• Sandcastle 里能跑的示例，不一定在无 token 的环境里能跑。默认底图与地形走 ion，复制示例时要先确认这两项是否关闭。
• 3D Tiles 规范已演进到 1.1，旧 tileset 升级前先用 validator 校验，避免把规范差异误判成加载代码的问题。
• 中文文章里的天地图、高德 Key 与 GCJ-02 偏移要单独验证，这类内容随服务商政策变化，时效性比 API 更短。

怎么判断一篇教程是否过时

三条线索按顺序看，基本能在十秒内做判断。

• 版本号：正文有没有写清对应的 CesiumJS 版本。只写"Cesium"而不写 1.xx 的，按过时处理。
• 日期：文首或文末的发布日期、最后更新日期。Cesium 每年二十多技术栈，超过两年的文章大概率已经失效。
• API 是否已废弃：出现 imageryProvider（1.104 起由 baseLayer 取代）、旧的 Viewer 构造习惯、或已被移除的 Cesium3DTileset 旧字段时，说明作者没跟版本。

装包之后可以直接查本地版本与发布时间，比看文章自称的版本可靠：

npm view cesium version
npm view cesium time.modified
npm view cesium dist-tags

另外，CHANGES.md 里的 Breaking Changes 段落是判断"某写法还能不能用"的最终依据。 教程写得再细，也不如这一段的变更记录权威。