大家好，我是程序员晚枫。

99% 的 Python 学习者，从不读官方文档。

他们学 Python 的方式是：百度 → CSDN → 复制粘贴。

但凡是读了官方文档的人，都会有这种感觉：

"原来 Python 是这样设计的！"

今天这篇文章，5 分钟教你用 Python 官方文档。

学会之后，你的 Python 水平能超过 90% 的人。

一、Python 官方文档在哪里？

官方地址：

👉 https://docs.python.org/3/

特点：

  • ✅ 完全免费
  • ✅ 中文版本（部分）
  • ✅ 永远最新
  • ✅ 包含所有版本
  • ✅ 可以下载离线版

这是 Python 学习的"唯一真理来源"。

百度、CSDN、知乎，都是二手货。

二、官方文档的 3 件套

官方文档分 3 部分：

文档链接适合谁
Tutorial（教程）https://docs.python.org/3/tutorial/新手
Library Reference（库参考）https://docs.python.org/3/library/中级
Language Reference（语言参考）https://docs.python.org/3/reference/高级

这 3 件套，你必须全部会查。

三、第 1 件套：Tutorial（教程）

Tutorial 是什么？

  • 官方写的入门教程
  • 从 0 开始
  • 包含所有 Python 基础
  • 16 个章节

Tutorial 目录

  1. 开胃菜：为什么学 Python
  2. 使用 Python 解释器
  3. Python 简介：基本语法
  4. 流程控制：if/for/while
  5. 数据结构：list/tuple/dict/set
  6. 模块：import 机制
  7. 输入输出：文件读写
  8. 错误和异常：try/except
  9. 类：面向对象
  10. 标准库简介：常用模块
  11. 标准库第 2 部分：更多模块
  12. 虚拟环境和包
  13. 接下来怎么办

Tutorial 怎么读？

方式 1：完整读一遍（推荐新手）

  • 一周读完
  • 边读边敲代码
  • 配合练习题

方式 2：当工具书（推荐老手）

  • 忘记语法时查
  • 想看新特性时查
  • 不用从头读

Tutorial 适合谁？

✅ 完全没编程基础的人
✅ 学过其他语言想转 Python 的人
✅ 想知道 Python 基础全貌的人
❌ 不适合查具体 API（用 Library Reference）

四、第 2 件套：Library Reference（库参考）

Library Reference 是什么？

  • Python 标准库的完整文档
  • 200+ 模块 全部解释
  • 每个函数、每个类、每个参数
  • 10 万+ 词条

这是 Python 学习的"字典"。

Library Reference 分类

分类内容
内置函数print, len, range 等
内置常量True, False, None
内置类型int, str, list 等
文本处理str, re, string 等
数据结构collections, heapq 等
算法bisect, array 等
数字和数学math, random, statistics
日期时间datetime, time, calendar
文件目录os, pathlib, shutil
数据持久化pickle, json, csv
数据压缩zipfile, gzip
加密hashlib, hmac
并发threading, multiprocessing, asyncio
网络socket, http, urllib
互联网协议email, json, xml
多媒体audio, image
国际化gettext, locale
开发工具unittest, pdb, profile
运行时sys, atexit, traceback
解释器main, site

200+ 个模块，每个都解释清楚了。

Library Reference 怎么用？

场景 1：不知道某个函数怎么用

1
2
Google 搜索: python list sort
或者直接: docs.python.org/3/library/stdtypes.html#list.sort

场景 2：不知道某个模块存在

1
2
Google 搜索: python how to zip file
或者直接: docs.python.org/3/library/zipfile.html

场景 3：想找某个功能对应的模块

1
2
3
Google 搜索: python how to read excel
→ 看到 openpyxl 库
→ 查 openpyxl 文档

Library Reference 适合谁？

✅ 经常写 Python 的人
✅ 想知道标准库能做什么
✅ 想要权威解释
❌ 不适合完全新手（先读 Tutorial）

五、第 3 件套：Language Reference（语言参考）

Language Reference 是什么？

  • Python 语言本身的完整定义
  • 解释 Python 语法、语义、运行时
  • 偏底层、偏理论

这是 Python 学习的"宪法"。

Language Reference 内容

章节内容
介绍Python 是什么
词法分析词法、标识符、关键字
执行模型Python 怎么运行代码
表达式运算符、比较、布尔运算
简单语句赋值、import、print
复合语句if/for/while/try
顶层组件完整脚本、模块

Language Reference 怎么用？

方式 1：精读（推荐进阶）

  • 想知道 Python 内部机制
  • 想知道某些"奇怪"行为的原理
  • 想知道 Python 和其他语言的区别

方式 2：当字典查

  • 写代码遇到奇怪问题
  • 想确认某个语法是否合法
  • 想理解某个错误信息

Language Reference 适合谁？

✅ 想深入理解 Python 的人
✅ 想知道 Python 内部机制的人
✅ 写技术文章/讲 Python 的人
❌ 日常写代码不常用

六、3 件套的配合使用

实际工作中怎么配合？

场景 1：完全新手

1
2
3
1. 读 Tutorial（建立基础）
2. 查 Library Reference（查具体函数）
3. 读 Language Reference（深入理解）

场景 2：有其他语言基础

1
2
3
1. 快速过 Tutorial（1-2 天）
2. 重点查 Library Reference（用到什么查什么）
3. 遇到问题查 Language Reference

场景 3：Python 老手

1
2
3
1. Library Reference 当字典（每天用）
2. Language Reference 偶尔查
3. Tutorial 给新人推荐

场景 4：写大型项目

1
2
3
1. Library Reference 查标准库
2. Language Reference 确认细节
3. Tutorial 给新人培训用

七、官方文档的 5 个隐藏功能

很多人不知道官方文档有这些功能：

功能 1：下载离线版

功能 2：搜索

功能 3：按版本切换

  • 文档顶部有版本切换
  • 3.10/3.11/3.12/3.13/3.14 都可查
  • 看到 3.10 的兼容性问题，直接切到 3.10 文档

功能 4：What's New

功能 5：HOWTO 文档

八、官方文档 vs 第三方教程

维度官方文档第三方教程
准确性✅ 100%⚠️ 可能有错
时效性✅ 最新❌ 可能过时
中文⚠️ 部分✅ 大多中文
易懂度⚠️ 偏官方✅ 更通俗
完整性✅ 全部❌ 选讲
例子⚠️ 简单✅ 实战
适合进阶/查字典入门/速成

最佳实践：

  • 入门：看第三方教程（视频、书、博客）
  • 进阶：官方文档
  • 查 API：官方文档
  • 写代码时：官方文档

九、5 分钟学会查官方文档

送你一个"5 分钟查文档"方法：

第 1 步：Google 搜索

1
python [你想查的功能]

第 2 步：找官方域名

  • 域名是 docs.python.org
  • 跳过所有其他网站

第 3 步：直接打开

  • 优先打开官方文档
  • 不行再找 Stack Overflow

第 4 步：看目录定位

  • 左侧目录树找到对应章节
  • Ctrl+F 搜索关键词

第 5 步：看示例代码

  • 官方文档的示例最权威
  • 直接复制运行

5 步搞定。

十、最后的最后

Python 官方文档，3 句话总结：

  1. 3 件套：Tutorial（入门）+ Library Reference（字典）+ Language Reference（宪法）
  2. 唯一真理：所有 Python 问题，官方文档都有答案
  3. 5 步查询：Google → 找 docs.python.org → 打开 → 搜索 → 看示例

你 Python 水平的分水岭，就是会不会用官方文档。

从今天开始，遇到问题先去查官方文档。

你会发现，CSDN/百度上的答案 80% 是错的。

官方文档看了 1 个月，你会有种"Python 突然变简单了"的感觉。

这就是官方文档的力量。

相关阅读

科技不高冷，AI很好用。
我是晚枫，关注我，带你一起玩AI！

🎓 AI 编程实战课程

程序员晚枫专注AI编程培训，通过 《50讲 · AI编程训练营》，让小白也能用AI做出实际项目。帮你从零上手！