OpenWeatherMap免费版支持实时天气和每小时预报，需注册获取appid，调用时注意城市英文名、units=metric和lang=zh_cn参数；系统TTS优先用macOS的say、Linux的espeak或Windows的SAPI；轮询间隔建议10分钟并加异常处理；温度四舍五入、风速湿度需映射口语化描述。
用 requests 调天气 API 前先确认接口是否免费且带实时数据
很多所谓“天气 API”实际是历史数据或延迟 1–3 小时的缓存，比如中国气象局官网接口不开放实时调用，OpenWeatherMap 免费版有每分钟 1000 次限制但支持当前天气（/weather）和每小时预报（/forecast），且返回 JSON 结构清晰。别直接搜“天气API Python”，先去 https://openweathermap.org/api 注册拿 appid，否则后续所有请求都会返回 401 Unauthorized。
常见错误：把城市名拼错（如传 "beijing" 却没加 units=metric，导致温度显示为开尔文值）；或者漏掉 lang=zh_cn 参数，结果播报全是英文。
实操建议：
- 用
https://api.openweathermap.org/data/2.5/weather?q={city}&appid={key}&units=metric&lang=zh_cn获取当前实况 - 城市名必须是官方支持的英文名（如
"shanghai"、"guangzhou"），中文会 404 - 首次调试时把完整 URL 粘贴进浏览器，确认能返回 JSON 再写代码
用 subprocess.run 调系统 TTS 而不是装第三方语音库
Python 本身不带语音合成，硬上 pyttsx3 容易在 macOS 或 Linux 上卡住（依赖 espeak 或 nsss，环境变量一错就报 OSError: [Errno 2] No such file or directory）。更稳的做法是复用系统自带的语音命令：
立即学习“Python免费学习笔记（深入）”；
- macOS：直接用
say -v Ting-Ting（粤语）或say -v Mei-Jia（普通话） - Linux：装
espeak后跑espeak -v zh -p 50 -s 140 - Windows：用
powershell -Command "Add-Type –AssemblyName System.Speech;(...)"太重，不如改用win32com.client.Dispatch("SAPI.SpVoice")，但需额外装pywin32
示例（macOS）：
import subprocess text = "上海现在气温22度，多云，空气质量良" subprocess.run(["say", "-v", "Mei-Jia", text])
终端实时播报要避免阻塞，用 time.sleep 控制轮询节奏
天气数据没必要每秒刷一次——API 有频控，前端也根本感知不到毫秒级变化。设成每 10 分钟抓一次比较合理，既降低失败率，又防止被限流。关键点是：别用 while True 狂刷，得加 try/except 包住网络请求，否则一次超时就整个脚本崩掉，播报中断。
容易踩的坑：
- 没捕获
requests.exceptions.Timeout或ConnectionError，导致程序退出 - 把
time.sleep(600)放在 try 块外，一旦出错就无限等待，再也无法重试 - 播报文本拼接时没做空值判断，比如
data["weather"][0]["description"]在异常响应里可能不存在，直接取会抛KeyError
本地化处理温度、风速、湿度等字段要注意单位和小数位
OpenWeatherMap 返回的温度是摄氏度但带小数（如 22.34），直接读出来很怪；风速单位是 m/s，普通人更习惯“2级风”或“微风”。别硬算换算公式，直接查它的官方文档附录：weather.main.temp 四舍五入到整数，weather.wind.speed 查表映射：
- 0.0–0.2 → “无风”
- 0.3–1.5 → “软风”
- 1.6–3.3 → “轻风”
- 3.4–5.4 → “微风”
湿度同理：data["main"]["humidity"] 是 0–100 整数，播报时加“%”即可，但低于 30 要提醒“干燥”，高于 80 提示“潮湿”，这些逻辑得自己补，API 不提供口语化描述。
复杂点在于：不同地区对“多云”的定义不同，API 返回的 description 字段（如 "partly cloudy"）翻译成中文后，还得人工校验是否符合本地习惯说法——这个没法全自动，得看实际播报效果再微调字典映射。
