官方文档是理解Python行为边界的唯一权威来源，明确标注参数、返回值、副作用、设计意图及版本变更，比第三方教程更可靠及时，日常开发应养成随时查阅习惯。
非常重要，而且远不止是“查函数怎么用”那么简单。
它帮你避开90%的低级错误
比如你写 list.sort() 却没意识到它直接修改原列表、不返回新列表——这种坑，官方文档里第一行就写着 “Sorts the list in place”。类似地，str.split() 默认按空白分割且会忽略连续空格，json.loads() 要求输入是字符串而非文件路径……这些都不是靠试错能高效掌握的，而是文档里明确标注的行为边界。
- 参数类型、默认值、可选范围，文档都列得清清楚楚
- 返回值是什么、会不会修改原对象、有没有副作用，全在“Returns”和“Raises”部分说明
- 常见误区（如“Don’t do this”）常以警告框形式直接提醒
它是理解设计意图的唯一权威来源
当你看到 functools.lru_cache() 的 maxsize 参数允许设为 None，或 pathlib.Path 故意不支持 + 拼接而推荐 / 运算符——这些不是随意设计，文档里的“Why?”和“Note”段落会解释背后的权衡：性能、一致性、可读性。跳过这部分，你就只在用语法，没在用 Python。
它比 Stack Overflow 更可靠、更及时
第三方教程可能还在讲 Python 2 的 print 语句，旧版博客可能误传已弃用的参数。而 Python 官方文档随每个小版本更新，每个函数页底部都标着“Changed in version 3.x”，连 deprecated 的替代方案都给你指出来。遇到报错时，直接搜异常名（比如 TypeError: expected str, bytes or os.PathLike object），文档里对应类型的 “Notes” 或 “Changed in” 往往直击根源。
立即学习“Python免费学习笔记（深入）”；
用起来其实不难，关键在习惯
不用从头读完——80% 的使用场景只需要三步：
- 用
help()快速看内置函数：help(str.strip) - 查标准库模块，直接访问 docs.python.org/3/library/，搜索框比 IDE 提示更完整
- 遇到模糊行为（比如
dict.pop(key, default)中 default 为None时是否等价于无 default），宁可花 30 秒翻文档，别猜
文档不是考试前才翻的教科书，而是你写代码时一直开着的、最安静也最诚实的搭档。
