本文介绍如何绕过预构建的 cesium.js，直接以 es 模块方式导入 cesium 未压缩源码（cesiumunminified），从而支持断点调试、源码阅读和本地开发定制。
Cesium 官方发布的 cesium.js 是经过打包、压缩和优化的生产版本，其内部结构已被扁平化，无法直接追踪原始模块逻辑。若需深入理解实现机制、添加自定义功能或在开发阶段精准调试（例如查看 Scene, Globe, Entity 等核心类的原始行为），推荐使用官方提供的 ESM 兼容构建产物 —— CesiumUnminified/index.js。
该文件位于 ./Build/CesiumUnminified/ 目录下，是 Cesium 源码（./Source/）经构建工具（如 Webpack + Babel）处理后的未压缩、保留原始模块结构（ESM）的输出，既支持 import 语法，又完整映射源码层级，是调试与二次开发的理想入口。
✅ 正确导入方式（ESM 环境）：
import * as Cesium from './Cesium/Build/CesiumUnminified/index.js';
// 或按需导入（需确保构建环境支持 tree-shaking）
// import { Viewer, Ion, Cartesian3 } from './Cesium/Build/CesiumUnminified/index.js';⚠️ 注意事项：
- 必须在支持 ES 模块的环境中运行（如现代浏览器中启用 <script type="module">，或使用 Vite / Webpack 5+ / Rollup 等构建工具）；</script>
- 不要直接 import './Cesium/Source/Cesium.js' —— ./Source/ 下的文件是未经构建的原始 TypeScript/JavaScript 模块，缺少模块解析上下文与全局依赖（如 define、require 兼容层），且未处理 AMD/UMD 适配，会触发 Cannot use import statement outside a module 或 Cesium is not defined 错误；
- 若使用 Node.js（非 ESM 模式）或旧版构建工具，请先配置 .mjs 扩展或 type: "module" 字段，并确保路径解析正确；
- CesiumUnminified 体积较大（约 20–30 MB），仅用于开发调试，切勿用于生产部署；生产环境请始终使用 Cesium.js 或 Cesium.min.js。
? 小贴士：
你还可以通过 VS Code 的 “Go to Definition” 跳转到 CesiumUnminified/index.js 中导出的变量，再进一步导航至对应 ./Source/ 文件（需确保项目已正确映射 source map，Cesium 默认内嵌 sourceMappingURL），真正实现“所见即源码”的开发体验。
总结：想看源码？别碰 ./Source/ 直接导入——用 ./Build/CesiumUnminified/index.js，它是为开发者而生的可调试、可导入、符合标准的 ESM 入口。
