Cesium 静态资源

目录与版本

SDK 不会把 Cesium 的 Workers、数据和组件资源全部内联到 JS。消费项目必须单独托管与 Cesium 1.146.0 匹配的资源：

public/cesium/
├── Workers/
├── Assets/
├── Widgets/
└── ThirdParty/

npx shardx-copy-cesium-assets --out public/cesium

保留供应商许可证和第三方声明。升级 Cesium 时重新复制全量资源，避免旧文件混入。 开发和发布均需执行复制，不能仅依赖开发机器遗留的 public/cesium。

assetBaseUrl

在首次 createMap 前确定资源根路径，传入 assetBaseUrl。该参数是目录 URL，建议带结尾 /。 相对 URL 以 document.baseURI 解析，不是相对于 SDK npm 包的路径。

应用地址	资源 URL 示例
https://app.example.com/	https://app.example.com/cesium/
https://app.example.com/map/	https://app.example.com/map/cesium/
独立 CDN	https://cdn.example.com/cesium/1.146.0/

Vite 子路径部署时，应用的 base 与 import.meta.env.BASE_URL 应一致。 Cesium 资源根配置在同一页面中共享，不要让多个地图实例使用不同资源版本或运行中修改根路径。

CSS 与服务端配置

import '@shardx-map/sdk/style.css';
import 'cesium/Build/Cesium/Widgets/widgets.css';

部署时应保留 CSS 引用的图片路径。静态服务必须返回正确 MIME 类型，Worker JS 应返回 JavaScript，不能返回 SPA 首页。 资源不存在时应返回 404；对 /cesium/ 使用单独的静态路径规则，避免被 index.html 回退吞掉。

使用独立 CDN 时核对 CORS 与 Worker 加载；按实际网络面板调整 CSP 的 script-src、worker-src、connect-src、img-src 和样式策略。 不要直接套用允许所有来源的 CSP，亦不要把 unsafe-eval 作为未经验证的默认配置。 跨域 Worker、blob:、data: 等需求应在目标浏览器逐项验收。

验证

构建产物中检查四个资源目录；打开部署页面后检查网络状态、Worker 控制台和缩放交互。 assetBaseUrl 正确与否需要真实静态服务器验证，文档构建通过不能证明 Worker 可运行。