异步函数返回 promise，需 await 或 .then() 等待解决后才能解构；推荐 async/await + 数组或对象解构，避免直接解构 promise 导致错误。
不能直接在调用异步函数后立刻解构，因为异步函数返回的是 Promise，不是最终数据。必须等 Promise 解决（fulfilled）后，才能拿到可解构的值。
用 async/await + 数组解构
这是最清晰、推荐的方式：把异步操作包装成返回数组的 Promise，再用 await 等待，最后解构。
例如封装 PayPal 创建发票函数：
function createInvoice(item_name, note_message, quantity, cost, payer_email) {
return new Promise((resolve, reject) => {
const invoiceData = {
merchant_info: { email: config.emailAddress },
billing_info: [{ email: payer_email }],
items: [{ name: item_name, quantity, unit_price: { value: cost } }]
};
paypal.invoice.create(invoiceData, (error, invoice) => {
if (error) reject(error);
else resolve([invoice.id, invoice.status, invoice.payer_email]);
});
});
}
// ✅ 正确使用：await 后再解构
async function handleInvoice() {
try {
const [id, status, email] = await createInvoice('商品A', '备注', 1, '99.99', 'user@example.com');
console.log('发票ID:', id, '状态:', status, '付款人:', email);
} catch (err) {
console.error('创建失败:', err);
}
}
用 .then() + 解构
适合不写 async 函数的场景，注意解构要放在 .then 的回调里，不能写在外部。
- .then 接收的参数是 Promise 成功后的值，此时才是真实数组
- 如果返回的是对象，也可用对象解构：
then(({ id, status }) => {...}) - 错误需用 .catch 单独处理，不能靠解构捕获
createInvoice('商品B', '', 2, '45.50', 'test@demo.com')
.then(([id, status, email]) => {
console.log('成功:', id, status, email);
})
.catch(err => {
console.error('出错:', err.message);
});
避免常见错误
以下写法都会导致解构失败或得到 undefined：
-
直接解构调用结果：
const [a, b] = createInvoice(...)→ 返回 Promise，不可迭代 - 在回调里 return，但函数本身没返回 Promise → 外部拿到 undefined
- 忘记 await 或 .then，就当同步函数用 → 解构目标是 pending Promise，报 “not iterable”
返回对象时的解构更灵活
比起数组，返回命名对象更易维护，尤其字段多或顺序可能变时：
// 修改 resolve 部分：
resolve({ id: invoice.id, status: invoice.status, payerEmail: invoice.payer_email });
// 调用时可按需解构：
const { id, payerEmail } = await createInvoice(...); // 不用关心顺序，也不用占位
