Skip to content

Cesium 快速入门指南

环境准备

创建vue项目,安装Cesium,安装vite插件(为了解决渲染错误),若不下载vite-plugin-cesium,则需要配置window.CESIUM_BASE_URL(参考官网教程

bash
# 创建vue项目 npm 7+,需要添加额外的 --
npm create vite@latest my-vue-cesium -- --template vue
# 安装Cesium
npm install cesium --save
# 安装vite插件(为了解决渲染错误)
npm i vite-plugin-cesium -D

工程配置

直接将下面代码复制到vite.config.js文件中

js
import { defineConfig } from "vite";
import vue from "@vitejs/plugin-vue";
import cesium from "vite-plugin-cesium";

// https://vite.dev/config/
export default defineConfig({
  plugins: [vue(), cesium()],
});

组件实现

vue
<template>
  <div ref="cesiumContainer" style="width: 100%; height: 80vh;"></div>
</template>

<script setup>
import { ref, onMounted } from "vue";
import * as Cesium from "cesium";
const cesiumContainer = ref(null);
let viewer = null;

onMounted(() => {
  // 初始化Viewer
  viewer = new Cesium.Viewer(cesiumContainer.value, {});
});
</script>

效果验证

未配置插件时的典型渲染错误 error

正确配置后的地球显示效果

success