在 Google Earth Engine 的独立 Web 应用中，print() 不可用；需通过 getInfo()（同步）或 evaluate()（异步）将服务端对象转为客户端值后，再用 console.log() 输出。
在 google earth engine 的独立 web 应用中，`print()` 不可用；需通过 `getinfo()`（同步）或 `evaluate()`（异步）将服务端对象转为客户端值后，再用 `console.log()` 输出。
Google Earth Engine（GEE）采用客户端–服务器分离架构：JavaScript 代码在浏览器中运行（客户端），而影像计算、聚合统计等耗时操作均在 GEE 服务器上执行。因此，像 ee.ImageCollection、ee.Reducer 或 ee.FeatureCollection 等对象本质上是服务端代理（server-side objects）——它们仅封装计算指令，并不包含实际数据。直接对它们调用 console.log() 或 JSON.stringify()，只会输出空壳描述（如 Object { "type": "ServerObject", ... }），而非真实数值。
要真正获取并打印结果（例如 precipitation_sum 的均值），必须显式触发客户端化（client-side conversion）。GEE 提供两种核心方法：
✅ 推荐方式：evaluate()（异步、非阻塞）
evaluate() 是生产环境首选，它以回调函数接收已解析的纯 JavaScript 对象（plain JSON），不冻结主线程，用户体验流畅：
stats.evaluate(function(clientStats) {
console.log('完整统计结果:', clientStats);
console.log('班加罗尔年降水量均值（mm）:', clientStats.precipitation_sum);
});? 注意：evaluate() 是异步的，后续逻辑不能直接依赖 clientStats，需写在回调内或使用 async/await 封装（见下文进阶示例）。
⚠️ 备选方式：getInfo()（同步、阻塞）
getInfo() 会暂停 JavaScript 执行，等待服务器返回结果后再继续。适用于调试或简单脚本，切勿在用户交互密集场景（如按钮点击）中使用，否则导致页面卡顿：
// 同步获取并打印
stats.getInfo().then(function(clientStats) {
console.log('服务端返回:', clientStats);
console.log('降水均值:', clientStats.precipitation_sum);
}).catch(console.error);
// 或直接使用 getInfo()（不推荐，已废弃警告）
// console.log(stats.getInfo()); // ❌ 可能触发弃用警告且阻塞线程? 安全提示：getInfo() 和 evaluate() 均需认证权限（即已初始化 ee.initialize() 并完成 OAuth 登录）。未授权调用将抛出 Unauthenticated 错误。
? 进阶：配合 async/await 提升可读性
现代项目中，可将 evaluate() 封装为 Promise，实现更清晰的异步流：
function evaluateAsync(serverObject) {
return new Promise((resolve, reject) => {
serverObject.evaluate(resolve, reject);
});
}
// 使用示例
async function printBangaloreRainfall() {
try {
const clientStats = await evaluateAsync(stats);
console.log(`✅ ${year} 年班加罗尔平均降水量: ${clientStats.precipitation_sum.toFixed(2)} mm`);
document.getElementById('result').textContent =
`降水量: ${clientStats.precipitation_sum.toFixed(2)} mm`;
} catch (error) {
console.error('❌ 获取统计结果失败:', error);
}
}? 总结要点
- console.log() 是唯一等效于云编辑器 print() 的客户端输出手段；
- *永远不要对 `ee.对象直接JSON.stringify()`** —— 它们不是普通 JS 对象；
- 优先使用 evaluate() + 回调 或 async/await 封装，保障应用响应性；
- 避免 getInfo() 在交互逻辑中使用，仅限调试；
- 所有服务端对象转换均需网络请求，应添加错误处理（.catch() 或 try/catch）。
掌握这一转换机制，是构建健壮、可调试的 GEE Web 应用的关键一步。
