应自定义http.client并设超时（如10秒），配transport复用连接；json解析用json.rawmessage延迟处理、字段名加json标签、非必填字段用指针；命令行用flag即可；本地缓存查词结果至usercachedir，以哈希命名、7天过期。
怎么用 net/http 调用字典 API 不卡死
Go 默认的 http.Client 没设超时，一遇到网络抖动或服务端响应慢，http.Get 就会卡住几秒甚至几十秒。这不是 bug，是默认行为。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 自己初始化
http.Client，设置Timeout（推荐10 * time.Second） - 别直接用
http.Get—— 它用的是全局默认 client，没法控制超时 - 如果要复用连接，顺手加上
Transport的MaxIdleConns和MaxIdleConnsPerHost，避免短连接风暴
client := &http.Client{
Timeout: 10 * time.Second,
Transport: &http.Transport{
MaxIdleConns: 20,
MaxIdleConnsPerHost: 20,
},
}
resp, err := client.Get("https://api.dictionaryapi.dev/api/v2/entries/en/hello")
JSON 解析时字段名对不上怎么办
字典 API（比如 dictionaryapi.dev）返回的 JSON 结构嵌套深、字段名带连字符（如 phonetic、audio）、还有可选字段（比如某些词没音标），直接用 struct 匿名嵌套容易 panic 或漏数据。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
json.RawMessage延迟解析不确定结构的部分（比如释义数组里的definitions） - struct 字段加
json:"field-name"标签，注意大小写和连字符 ——Phonetic string `json:"phonetic"`，不是phonetic - 所有非必填字段都用指针或加
omitempty，避免零值覆盖逻辑判断
type Entry struct {
Word string `json:"word"`
Phonetic *string `json:"phonetic"`
Phonetics []Phonetic `json:"phonetics"`
Meanings []Meaning `json:"meanings"`
}
<p>type Phonetic struct {
Text <em>string <code>json:"text"</code>
Audio </em>string <code>json:"audio"</code>
}
命令行参数解析选 flag 还是第三方库
就一个查词工具，flag 足够了。引入 cobra 或 urfave/cli 反而让二进制变大、启动变慢，还多一层学习成本。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
flag.String接收查询词，flag.Bool控制是否显示音标/例句 - 记得在
flag.Parse()后检查len(flag.Args()) == 0，否则用户不输词就跑，报错信息会很迷 - 别把帮助文案写死在
flag.Usage里 —— 改成函数调用，方便后续加颜色或格式化
word := flag.String("w", "", "word to lookup")
showAudio := flag.Bool("audio", false, "show audio url if available")
flag.Parse()
<p>if len(flag.Args()) == 0 && <em>word == "" {
fmt.Fprintln(os.Stderr, "error: missing word")
os.Exit(1)
}
query := </em>word
if query == "" && len(flag.Args()) > 0 {
query = flag.Args()[0]
}
本地缓存查过的词能省多少时间
查同一个词两次，走网络还是走磁盘？实测：本地 SSD 上读一个 2KB 的 JSON 文件，平均耗时 0.08ms；走一次 HTTP 请求（含 DNS + TLS + 网络往返），通常 300–1200ms。差三个数量级。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 缓存路径用
os.UserCacheDir()，别硬写./cache或~/.dict-cache - 文件名用
sha256(word)哈希，避免特殊字符或路径穿越问题 - 缓存有效期设为 7 天（用文件
ModTime判断），不用引入额外时间逻辑 - 写缓存时用
ioutil.WriteFile即可，不用考虑并发 —— 命令行工具天然单例
缓存不是银弹：API 返回 404 也得存，不然反复查不存在的词会一直打 API。存个空数组或带 "error": "No definitions found" 的结构更稳妥。
