经纬志
首页 / Cesium / 使用示例

离线部署的路径设置

用 setBaseUrl 指定 Cesium 资源根目录,脱离默认的构建路径。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

为什么需要它

Cesium 运行时要读取内置着色器、星空贴图、默认图标等资源。默认按构建时的路径拼接,放到子目录或改名后会 404。setBaseUrl 改的正是这个前缀。

离线还缺什么

除了资源路径,还要避免使用默认的在线影像与地形:baseLayer: false、不传 terrain、不使用任何在线影像提供者,这三点做到才是真正离线。

设置示例值说明
setBaseUrl/cesium/资源根目录
baseLayerfalse不请求影像服务
terrain不传不请求地形服务

setBaseUrl 必须在创建 Viewer 之前调用;创建之后再改只影响之后加载的资源,已加载的贴图不会重新取。