viewer.entities.add 返回一个全局变量

### 关于 `viewer.entities.add` 方法返回全局变量的原因 在 Cesium 中，`viewer.entities.add` 是用于向地图实体集合中添加新实体的方法。该方法会返回一个表示所添加实体的对象实例。此设计的主要目的是为了便于开发者直接操作刚创建的实体而无需额外查询。 #### 返回全局变量的原因分析 1. **API 设计初衷** Cesium 的 API 设计倾向于提供简洁的操作方式。当调用 `viewer.entities.add` 时，它不仅将实体加入到内部管理列表中，还会直接返回这个实体对象以便立即使用[^1]。这种方式减少了开发者的编码负担，因为不需要再通过其他方法重新检索刚刚添加的实体。 2. **性能优化考虑** 如果每次都需要通过 `viewer.entities.getById(id)` 或者类似的查找函数去定位新增加的实体，则可能会引入不必要的开销。因此，直接返回新建的实体可以提升效率。 3. **灵活性需求** 开发人员可能需要立刻设置一些动态属性或绑定事件监听器给新建立好的物体；如果能够马上拿到引用就更加便利了。 然而，在某些情况下，这可能导致意外行为——即所谓的“返回全局变量”的现象发生： - 当未显式保存返回值至局部作用域内的变量名时，默认会在 JavaScript 执行上下文中作为全局变量存在； - 这种情况通常发生在严格模式 (`'use strict';`) 被忽略的情况下运行脚本环境里[^2]。 --- ### 解决方案 为了避免上述提到的问题，可以通过以下几种方式进行改进: #### 使用严格的声明语句 `'use strict';` 启用 ES5 提供的严格模式可以帮助防止无意间定义新的全局变量。只要在文件顶部或者特定功能块开头加上这一行代码即可生效: ```javascript 'use strict'; ``` 一旦开启严格模式之后，任何试图赋值给不存在的名字都会抛出错误而不是静默地创建一个新的全局变量。 #### 明确指定存储位置 始终记得把从 `viewer.entities.add()` 得来的结果存放到明确的地方(比如某个类成员、数组项或者其他合适的数据结构)，从而避免它们漂浮在外成为潜在污染源的例子如下所示： ```javascript const myEntity = viewer.entities.add({ name : 'Red box', position : Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883), box : { dimensions : new Cesium.Cartesian3(400000.0, 300000.0, 500000.0), material : Cesium.Color.RED } }); console.log(myEntity); // 正常打印实体信息而非挂载到window下 ``` 另外还可以采用现代模块化编程风格如 CommonJS/AMD/ES Modules 等封装逻辑单元减少对外暴露面积极大地降低风险水平[^3]。 --- ### 总结 综上所述，“`viewer.entities.add` 返回全局变量”实际上是由于未能妥善保管其返回的结果所致，并非真正意义上的缺陷所在。遵循良好的软件工程实践原则就可以有效规避此类隐患的发生。 ---