ESP32 / ESP8266 MicroPython教程:读取文件

引言

本篇ESP32 / ESP8266 MicroPython教程主要说明如何从MicroPython的文件系统中读取一个文件。本教程在 esp32 和 esp8266 上进行了测试。

通常我会使用Putty与MicroPython命令行界面进行交互。但是为了演示，我在本篇教程中会使用Arduino Serial Monitor与设备进行交互。因为它也要与设备之间建立串行连接，所以这种交互方式其实与使用Putty没有什么不同。

打开Serial Monitor之后，只需选择正确的COM端口和波特率（115200）即可。请注意，我们还需要在波特率左边的下拉列表中选择回车或回车&换行选项，以使命令行界面知道命令终止。

您也可以使用Putty或其他您喜欢的其他软件与设备进行交互。

代码

首先，我们会在MicroPython文件系统中新建一个文件。有关如何新建文件的详细教程，请参考前面这一篇文章： ESP32 / ESP8266 MicroPython教程：写入文件 。我们会创建一个名为initialFile.txt的文件，并向文件中写入两行文本。然后，我们会关闭文件并列出当前文件夹下的所有文件，以确认其创建成功。

file = open ("initialFile.txt", "w")
file.write("First Line \n")
file.write("Second Line")
file.close()
import os
os.listdir()

代码运行之后，您将看到与图1类似的输出结果。

图1 - 将初始文件写入文件系统。

然后，我们仍然使用open（打开）函数将文件打开，该函数的第一个参数是文件名称，但是现在我们将第二个参数设置为字符串“r“，表示我们想要读取文件内容。

然后，只需调用file（文件）对象的read（读取）（https://docs.python.org/3/library/io.html#io.BufferedIOBase.read）方法，即可读取完整的文件内容。该方法可以接收一个输入参数，表示要从文件中读取的字节数。如果没有输入参数，那么它就会读取全部内容，直到文件结尾。

我们将在无参数条件下调用这个方法，所以测试结果将会返回完整的文件内容。在调用之后，您就会看到被打印出来的文件内容。注意换行符也会显式打印出来。

最后，调用close（关闭）方法，关闭文件。

file = open("initialFile.txt", "r")
file.read()
file.close()

我们可以使用readline方法（https://docs.python.org/3/library/io.html#io.TextIOBase.readline）（该方法会返回文件中的一行内容）代替read方法，然后重复上述测试。该方法会接收一个输入参数，以指定要从文件内一行内容中读取的最大字符数，一旦接收到指定数量的字符或者到达行尾，该方法就会停止执行。如果不指定任何参数，它就会读取一整行。因为文件中一共有两行文本，所以我们将调用它两次（都不指定参数）。

一旦到达文件末尾，该调用会返回一个空字符串（https://docs.python.org/3/library/io.html#io.TextIOBase.readline）。所以，如果我们无法提前知道行数，那么可以将此作为停止条件。最后，同样通过调用close（关闭）方法将文件关闭。

file = open("initialFile.txt", "r")
file.readline()
file.readline()
file.close()

两组命令的运行结果如下所示。

图2 - 两种不同方法的文件读取结果。

如图2所示，readline方法会将“\n”字符也打印出来。如果不想看到这个字符，可以在返回的字符串上调用rstrip方法（https://www.tutorialspoint.com/python/string_rstrip.htm），它的输入参数是一个字符串，内容是想要从右边删除的一组字符。如果没有找到这组字符，那么什么都不会发生。我们可以调用这个方法，并将“\n”字符作为参数传递给它。

file = open("initialFile.txt", "r")
file.readline().rstrip("\n")
file.readline().rstrip("\n")
file.close()

运行结果如图3所示，“\n“字符没有再显示出来。由于在原来的字符串中，“\n“前面加了一个空格，所以显示结果的第一行末尾也有一个空格。

os.remove("initialFile.txt")
os.listdir()

图3 - 删除字符串末尾的“\n”字符。

为了避免在文件系统中留下垃圾，我们将调用os模块的remove函数（输入参数为文件名）将文件删除。此时调用listdir函数，就不会再看到我们创建的文件了。

os.remove("initialFile.txt")
os.listdir()

图4所示是该命令的输出结果。如图所示，只有boot.py一个文件。请不要删除这个文件。

图4 - 从MicroPython文件系统中删除文件。

最后说明

最后，我会给您提供一个非常有用的方法，可以帮助您获取对象的可用方法和函数。这个办法其实很简单，只需将目标对象作为输入参数调用dir函数（https://docs.python.org/2/library/functions.html#dir）即可。

dir(os)
dir(file)
dir(str)

您会看到如图5所示的列表，其中包括了一些对象的可用方法。在您手头没有文档的情况下，这种方法非常有用。

图5 - 列出对象的可用方法。