【摘要：重点学习如何使用Python的官方文档，官方文档给出了标准库参考、入门教程等。】

在学习Python编程的过程中，学会使用Python官方文档是非常重要的。当你在编写Python程序的过程中，需要使用Python模块或函数，而又不清楚这些模块和函数如何使用时，Python官方文档会给你很大的帮助。

1、  为什么要使用Python官方文档？

在Python提供的中文文档中，有两部分是要重点关注的，也是我们学习Python的枕边书。

Python官方文档地址：

https://docs.python.org/zh-cn/3.9/

地址中的3.9对应Python的版本号，表示该文档对应Python3.9版本。

通过文档大纲页面可以看出，Python官方文档提供的内容是非常丰富的。包括了教程、标准参考库、语言参考、Python的安装和使用、常见问题等内容。

Python官方提供的教程对无编程基础的人来说，不是特别友好，有较多的专业语言和术语。

标准库参考描述了随同Python版本一同发行的标准库。标准库包含了多个内置模块。一些模块使用C语言编写，这些模块实现了系统级功能，例如文件 的输入与输出（I/O）；此外还有大量以 Python 编写的模块，提供了日常编程中许多问题的标准解决方案。

语言参考描述了Python的语法和语义，包括Python支持的数据模型、表达式、语句、完整的语法规范等内容。

常见问题以问答方式提供了使用Python开发经常遇到的问题，也许在这里可以找到你需要的答案。

Python学习者通过课程或图书可以快速入门Python，掌握学习Python的方法、知识点、基础知识和编程技巧。但课程或图书不可能对Python所有知识都讲的非常详细，过于详细和枯燥的内容既占用你的时间、也会让你缺乏成就感。课程或图书重点是教会你学习一门语言的方法、以及使用这门语言如何编写程序。

当你在编写Python程序的过程中，需要使用Python模块或函数，而又不清楚这些模块和函数如何使用时，Python官方文档会给你很大的帮助，你可以在官方文档的标准库参考部分找到你需要的答案。

当你在编写Python程序的过程中，对Python的数据模型、语句及语法感到困惑时，你可以在官方文档的语言参考部分找到你需要的答案。

当你在编写Python程序的过程中，遇到了一些问题，这些问题你不清楚如何解决，也许你能在官方文档的常见问题部分找到你需要的答案。

2、   深入了解print函数

print函数是Python的内置函数，在前面的课程中已经学习了print函数的使用。现在借助官方文档进一步学习print函数的使用。

内置函数的使用在官方文档标准参考库部分，下表是Python提供的内置函数。

下面是官方文档给出的print函数说明，对说明内容进行了整理。

print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)

print函数有五个参数，第一个参数objects是必选参数（调用print函数时，该参数必须要传入），后面四个参数是可选参数（调用print函数时可以省略）。

参数objects为输出的文本流（输出或输入的一个或多个字符串序列称为文本流）。由此可见，print函数可以输出任意多个变量或值，变量或值的内容在输出时都会转换为字符串。

sep参数用于设置分隔符，当print函数输出多个字符串时，用来分隔字符串，默认的分隔符是空格。

end参数用于添加一个字符到输出的末尾，print函数输出完内容后，会在输出的内容末尾添加一个字符串，默认的字符是换行符“\n”。

file参数指定print函数的输出目标，默认值为 sys.stdout，该默认值代表了系统标准输出，也就是屏幕。因此print没有指定输出目标时，会把内容输出到Shell窗口。

flush参数用于设置是否缓存输出，默认值为False，表示不适用缓存。

案例01演示了sep参数的使用，print函数输出多个字符串时，默认的分隔符是空格，可以通过sep参数设置分隔符。

案例02演示了end参数的使用，print函数输出完成，默认会添加一个换行符，下一个print函数会另起一行输出，可以通过end参数设置在输出末尾添加的字符，让多个print函数在一行输出。

3、   模块的使用

模块就是Python的代码文件，一个代码文件可以是一个模块，多个代码文件也可以是一个模块。一般来说，模块是一组完成类似功能的代码文件的组合，模块提供了一些函数供编程者调用，这些函数和Python的内置函数一样，都能完成一个确定的功能。

在代码中使用模块，需要导入后才能使用，导入模块使用import语句。

modulename是模块名称，name是该模块的别名，在调用模块函数时，可以直接使用name作为模块的名称。

调用模块函数的语法如下：

调用模块函数时，在模块别名后面跟一圆点符号，圆点符号后面紧跟模块中的函数名称即可。

下面借助Python官方文档掌握数学库的使用。

数学库在官方文档标准参考库部分，数学库由多个模块组成，math模块用于数学函数的计算，课程案例利用math模块的factorial函数来计算自然数n的阶乘。

下面是官方文档给出的factorial函数说明。

factorial(x)

以一个整数返回 x 的阶乘。 如果 x 不是整数或为负数时则将引发 ValueError。

从官方文档说明可以看出，factorial函数用于计算x的阶乘，x为传入的参数，如果传入的x不是整数或者为负数时，会引发ValueError异常（关于异常及异常处理，在后面的课程会学习）。

案例代码见课程资源（unit1/case02.py）

案例03代码导入了数学库的math模块，使用math模块的factorial函数计算自然数n的阶乘。

代码执行流程：

（1）使用input函数要求用户输入一个自然数，并使用int函数将input返回的字符串转换为整数，赋值给变量num；

（2）调用factorial函数计算自然数num的阶乘，函数返回结果赋值给变量result；

（3）使用print函数输出变量result的内容。

4、  上机操作

编写一个程序，创建一个1至100范围内的随机整数。

程序要求：

（1）    使用数学库的random模块的randint函数创建随机数；

（2）    使用代码编辑器编写代码；

（3）    在代码中适当添加注释。