cesiumjs

项目地址： https://github.com/CesiumGS/cesium

官方文档： https://cesium.com/learn/cesiumjs-learn/

API 参考： https://cesium.com/learn/cesiumjs/ref-doc/

Sandcastle： https://sandcastle.cesium.com/

最新版本： 1.146.0（截至 2026-10，npm cesium）

许可证： Apache-2.0

概述

CesiumJS 提供：

• 三维全球：WGS84 椭球体、地形（Quantized-Mesh）、卫星影像
• 3D Tiles：海量三维流式（倾斜摄影、BIM、点云、城市模型）
• glTF / GLB 模型：标准 PBR 渲染
• CZML / Entity API：高层声明式数据模型，时序动画
• Primitive API：底层高性能 API
• 可视化分析：通视/剖面/缓冲/裁剪/视频投影/光影

---

安装

方式一：npm

npm install cesium
npm ls cesium            # 验证：应显示 [email protected]

import { defineConfig } from 'vite';
import cesium from 'vite-plugin-cesium';

export default defineConfig({ plugins: [cesium()] });

方式二：CDN

<link href="https://cdn.jsdelivr.net/npm/[email protected]/Build/Cesium/Widgets/widgets.css" rel="stylesheet">
<script src="https://cdn.jsdelivr.net/npm/[email protected]/Build/Cesium/Cesium.js"></script>

# 验证 CDN 版本可达
curl.exe -I https://cdn.jsdelivr.net/npm/[email protected]/Build/Cesium/Cesium.js   # 期望 200

打包器接入

• Vite：用 vite-plugin-cesium，按上面的 vite.config.js 注册，插件负责拷贝静态资源
• Webpack：将 node_modules/cesium/Build/Cesium/{Workers,Assets,Widgets} 拷到输出目录，并在入口最早处设置 window.CESIUM_BASE_URL

1.146 变更： 数学/几何/时间/工具类被拆分为新包 @cesium/core（[email protected] 依赖 @cesium/core@^0.1.0）。从 cesium 主包导入的代码不受影响；直接按子路径引用 @cesium/engine 的代码需改从 @cesium/core 导入（旧导出计划在后续版本移除，1.146 仍可用）。

---

快速上手

<div id="cesiumContainer" style="width:100%;height:100vh"></div>
<script type="module">
  import * as Cesium from 'cesium';
  import 'cesium/Build/Cesium/Widgets/widgets.css';

  Cesium.Ion.defaultAccessToken = 'YOUR_ION_TOKEN';

  const viewer = new Cesium.Viewer('cesiumContainer', {
    terrainProvider: await Cesium.createWorldTerrainAsync(),
    timeline: false, animation: false
  });

  viewer.camera.flyTo({
    destination: Cesium.Cartesian3.fromDegrees(116.397, 39.908, 5000)
  });
</script>