Cesium EntityCollection使用问题：添加至viewer.entities后实体不显示

你的问题确实是由viewer.entities.add(collection)这行代码导致的。

原因说明 #

viewer.entities本身就是一个EntityCollection实例，但它的add方法仅支持添加单个Entity对象或Entity配置对象，无法直接添加另一个EntityCollection。当你传入collection时，Cesium不会解析这个集合内的实体，自然不会将它们渲染到地球视图中。

两种分组管理实体的可行方案 #

方案1：用CustomDataSource挂载EntityCollection

如果需要独立管理整个实体集合（比如统一显示/隐藏、移除），可以通过CustomDataSource将EntityCollection关联到场景：

const viewer = new Cesium.Viewer("cesiumContainer");
const collection = new Cesium.EntityCollection();

// 向集合添加实体
collection.add({
    id: 1,
    position: Cesium.Cartesian3.fromDegrees(118.0, 35.0),
    point: {
        pixelSize: 100,
        color: Cesium.Color.RED,
    },
});

// 创建自定义数据源并关联集合
const groupDataSource = new Cesium.CustomDataSource("我的实体组");
groupDataSource.entities = collection;

// 将数据源添加到viewer，实体即可显示
viewer.dataSources.add(groupDataSource);

// 后续可通过数据源统一管理集合
// 比如隐藏整个分组：groupDataSource.show = false;
// 移除整个分组：viewer.dataSources.remove(groupDataSource);

方案2：给实体添加分组属性，直接用viewer.entities管理

如果不需要独立的集合对象，仅需逻辑分组，可以给每个实体添加自定义属性标识分组，后续通过筛选实现分组操作：

const viewer = new Cesium.Viewer("cesiumContainer");

// 添加实体时指定分组属性
viewer.entities.add({
    id: 1,
    group: "group1", // 自定义分组标识
    position: Cesium.Cartesian3.fromDegrees(118.0, 35.0),
    point: {
        pixelSize: 100,
        color: Cesium.Color.RED,
    },
});

// 后续筛选分组内的实体
const group1Entities = viewer.entities.values.filter(entity => entity.group === "group1");

// 统一操作分组实体，比如隐藏
group1Entities.forEach(entity => entity.show = false);

内容的提问来源于stack exchange，提问作者Glad