技能介绍

要解决什么问题

在分布式系统里，组件之间往往需要解耦、削峰、异步重试，但又不想一上来就上 Service Bus 的复杂度与成本。Azure Queue Storage 提供的是轻量、按量计费的 FIFO 风格队列；Python 侧若直接翻官方文档，容易在鉴权方式（连接字符串 vs Entra）、同步/异步客户端混用以及消息可见性、毒消息等细节上踩坑。

本技能把 azure-storage-queue Python SDK 的常用路径整理成可照着写的模式，重点对齐生产里常见的约束。

技能覆盖的核心能力

鉴权与生命周期：优先 DefaultAzureCredential（本地 Azure CLI / VS Code，云端托管标识）；客户端与异步凭据用 with / async with 释放连接与令牌缓存。
队列操作：发送、接收（dequeue）、Peek（只看不删，适合监控）、更新、删除、清空队列，以及读写队列属性。
编码与客户端形态：Base64 编码说明；高吞吐场景倾向 异步客户端（azure.xxx.aio），且同一路径内不要混用同步与异步。
参考文档：references/capabilities.md 补充非核心能力与生产检查清单；references/non-hero-scenarios.md 面向次要/高级场景示例。

适用边界与注意点

处理后应删除消息，并按实际处理时间设置可见性超时；关注 dequeue_count 以识别毒消息；可为消息设置 time_to_live 避免陈旧堆积。
需要会话、主题等高级消息能力时，文档建议改用 Azure Service Bus，Queue Storage 更适合简单、高性价比的排队场景。