Globe.gl 项目中的 THREE.WebGLRenderer useLegacyLights 弃用问题解析

背景介绍

Globe.gl 是一个基于 Three.js 构建的 3D 地球可视化库。在 Three.js r155 版本中，对光照系统进行了重大更新，弃用了 useLegacyLights 属性，这影响了依赖 Three.js 的 Globe.gl 项目。

问题本质

Three.js 从 r155 版本开始引入了新的光照系统，并将 useLegacyLights 属性标记为已弃用。当 Globe.gl 项目设置这个属性时，即使设置为 false（使用现代光照行为），Three.js 仍然会发出弃用警告。

技术解决方案

Globe.gl 从 v2.29.0 版本开始已经更新了光照系统，强制将 useLegacyLights 设置为 false 以确保一致的现代光照行为。为了兼容不同版本的 Three.js，项目采取了以下措施：

1. 对于 Three.js r155 及以上版本，不再设置 useLegacyLights 属性
2. 对于旧版 Three.js，仍然设置 useLegacyLights=false 来强制使用现代光照行为

实现细节

项目通过检查 Three.js 的版本来决定是否设置 useLegacyLights 属性。具体实现逻辑是：

• 如果检测到 Three.js 版本低于 r155，则显式设置 useLegacyLights=false
• 如果 Three.js 版本是 r155 或更高，则完全不设置该属性，避免触发弃用警告

对开发者的影响

这一变更意味着：

1. 开发者不再需要担心光照系统的兼容性问题
2. 控制台不再显示关于 useLegacyLights 的弃用警告
3. 项目在不同版本的 Three.js 下都能保持一致的渲染效果

最佳实践建议

对于使用 Globe.gl 的开发者：

1. 建议升级到最新版本的 Globe.gl 以获得最佳兼容性
2. 如果自定义光照效果，应参考 Three.js 最新的光照文档
3. 注意检查项目依赖的 Three.js 版本，确保与其他库兼容

总结

Globe.gl 项目通过智能版本检测和条件属性设置，优雅地解决了 Three.js 光照系统更新带来的兼容性问题。这体现了项目维护者对 API 演进的积极响应和对开发者体验的重视。