异步函数（如 async 声明的 API 调用）必然返回 Promise，不能直接获取解析后的值；需通过 await（在 async 上下文中）或 .then()（在同步上下文中）获取最终结果。
异步函数（如 `async` 声明的 api 调用）必然返回 promise，不能直接获取解析后的值；需通过 `await`（在 async 上下文中）或 `.then()`（在同步上下文中）获取最终结果。
在构建基于 Google Cloud Translation API 的翻译应用时，一个常见误区是误以为 async 函数会“自动等待”并直接返回解析后的数据。实际上，所有 async 函数都隐式返回 Promise——即使你 return 一个字符串（如 return translation），该字符串也会被包裹进 Promise.resolve(translation) 中。
以你的代码为例：
async function getTranslation(text) {
const res = await axios.post(
`https://translation.googleapis.com/language/translate/v2?key=${_API_KEY}`,
{ q: text, target: "de" }
);
const translation = res.data.data.translations[0].translatedText;
console.log(translation); // ✅ 正确输出：Hello Welt
return translation; // ⚠️ 实际返回：Promise<“Hello Welt”>
}因此，这行代码：
const message = getTranslation(text);
console.log(message); // → Promise {<pending>}，而非字符串输出的是未决 Promise 对象，而非翻译结果。
✅ 正确做法有三种，按使用场景选择：
1. 使用 .then()（适用于普通脚本、事件回调等非 async 环境）
getTranslation("hello world").then(message => {
console.log(message); // ✅ 输出：Hello Welt
// 在此处继续处理 message（如更新 DOM、存入 state）
});2. 使用 await（必须在 async 函数内部）
const doTranslate = async () => {
const { getTranslation } = apiTranslate;
const message = await getTranslation("hello world");
console.log(message); // ✅ 输出：Hello Welt
return message; // 可链式调用或用于后续逻辑
};
doTranslate();3. 使用 IIFE（立即执行异步函数）——简洁适合顶层逻辑
(async () => {
const { getTranslation } = apiTranslate;
const message = await getTranslation("hello world");
console.log(message); // ✅ Hello Welt
})();⚠️ 注意事项：
- ❌ 不要在顶层作用域（Top-level）直接
await getTranslation(...)（ES2022+ 支持 Top-levelawait，但需确保运行环境支持且模块类型为module）； - ❌ 避免
const message = getTranslation(...).then(...)—— 这仍赋值为 Promise，非结果； - ✅ 始终将异步操作的消费逻辑（如渲染、存储、校验）置于
.then()回调或await后续语句中； - ✅ 生产环境中务必添加错误处理：
try { const message = await getTranslation("hello world"); console.log(message); } catch (err) { console.error("Translation failed:", err.response?.data || err.message); }
掌握 Promise 消费模式是前端异步编程的核心基础。记住：async 函数 ≠ 同步函数，它只是让异步流程写起来更像同步——但调度权仍在事件循环手中。
