介绍
Python 的 print 函数是用于在控制台中显示信息的有用工具。然而，在某些情况下，你可能希望将此输出保存到文件中。这种能力对于日志记录、创建报告或保存程序结果以供后续分析尤其重要。
在这个实验（Lab）中，你将学习如何将 Python 的 print 函数的输出重定向到文件。你将从基本的 print 操作开始，然后逐步将输出定向到不同模式的文件中，最后探索此技术的一些实际应用。
理解基本的 Python print() 函数
在我们将输出重定向到文件之前，让我们首先了解一下 Python 中 print() 函数的工作方式。print() 函数是 Python 中用于显示输出的最常用函数之一。
print() 函数的语法
print() 函数的基本语法是：
print(value1, value2, ..., sep=' ', end='\n', file=sys.stdout, flush=False)
其中：
value1, value2, ...：要打印的值sep：值之间的分隔符（默认为一个空格）end：在最后一个值之后添加的字符串（默认为换行符）file：输出所在的文件对象（默认为控制台）flush：是否强制刷新流（默认为 False）
让我们创建一个简单的 Python 脚本来演示 print() 函数的基本用法。
- 打开 WebIDE，通过单击“File”菜单并选择“New File”来创建一个新文件
- 将文件保存为
/home/labex/project目录下的print_basics.py - 将以下代码添加到文件中：
## Basic print examples
print("Hello, Python!")
print("Multiple", "values", "with", "spaces")
print("Values", "with", "dashes", sep="-")
print("No newline at the end", end=" ")
print("This continues on the same line")
## Printing different data types
print("Integer:", 42)
print("Float:", 3.14)
print("Boolean:", True)
## Printing variables
name = "Alice"
age = 30
print("Name:", name, "Age:", age)
- 通过按 Ctrl+S 或单击“File” > “Save”来保存文件
- 通过打开终端并键入以下内容来运行脚本：
python3 print_basics.py
你应该看到类似于以下内容的输出：
Hello, Python!
Multiple values with spaces
Values-with-dashes
No newline at the end This continues on the same line
Integer: 42
Float: 3.14
Boolean: True
Name: Alice Age: 30
此示例演示了 print() 函数的基本功能，包括如何打印不同的值、自定义分隔符和控制行尾。
使用 print() 格式化输出
你还可以使用 f-string（格式化字符串字面量）或 format() 方法来格式化 print() 函数的输出。
让我们向我们的文件中添加一些格式化的 print 示例：
- 再次打开
print_basics.py文件 - 在文件末尾添加以下代码：
## Using f-strings (Python 3.6+)
name = "Bob"
age = 25
print(f"Name: {name}, Age: {age}")
## Using format() method
print("Name: {}, Age: {}".format(name, age))
## Formatting numbers
price = 19.99
quantity = 5
total = price * quantity
print(f"Price: ${price:.2f}, Quantity: {quantity}, Total: ${total:.2f}")
- 保存文件并再次运行它：
python3 print_basics.py
新的输出应该包括：
Name: Bob, Age: 25
Name: Bob, Age: 25
Price: $19.99, Quantity: 5, Total: $99.95
现在我们了解了 print() 函数的基础知识，我们可以继续将它的输出重定向到文件。
将 print() 输出重定向到文件
现在我们了解了 print() 函数的工作方式，让我们探索如何将其输出重定向到文件，而不是在控制台中显示它。关键是使用 print() 函数的 file 参数。
将输出写入文件
要将 print() 函数的输出重定向到文件，我们需要：
- 以写入模式打开一个文件
- 使用
file参数将文件对象传递给print()函数 - 完成后关闭文件
让我们创建一个新的 Python 脚本来演示这一点：
- 在
/home/labex/project目录中创建一个名为print_to_file.py的新文件 - 将以下代码添加到文件中：
## Open a file in write mode
output_file = open("output.txt", "w")
## Redirect print output to the file
print("This is line 1 of our output file.", file=output_file)
print("This is line 2 of our output file.", file=output_file)
print("This is line 3 with numbers:", 42, 3.14, file=output_file)
## Close the file
output_file.close()
print("Output has been written to output.txt")
- 保存文件并运行它：
python3 print_to_file.py
- 你应该在控制台中看到消息“Output has been written to output.txt”
- 让我们检查
output.txt文件的内容：
cat output.txt
你应该看到：
This is line 1 of our output file.
This is line 2 of our output file.
This is line 3 with numbers: 42 3.14
使用 with 语句（推荐方法）
在 Python 中使用文件的更好方法是使用 with 语句，即使发生异常，它也会自动处理关闭文件。让我们修改我们的示例：
- 在
/home/labex/project目录中创建一个名为print_to_file_with.py的新文件 - 将以下代码添加到文件中：
## Using the 'with' statement to handle file operations
with open("output_with.txt", "w") as output_file:
print("This line is written using the 'with' statement.", file=output_file)
print("The file will be automatically closed after this block.", file=output_file)
print("Numbers and other data types:", 100, 3.14159, True, file=output_file)
print("Output has been written to output_with.txt")
- 保存文件并运行它：
python3 print_to_file_with.py
- 检查新文件的内容：
cat output_with.txt
你应该看到：
This line is written using the 'with' statement.
The file will be automatically closed after this block.
Numbers and other data types: 100 3.14159 True
with 语句是 Python 中处理文件的推荐方法，因为它：
- 在块结束时自动关闭文件
- 适当地处理异常
- 使你的代码更简洁、更易读
现在你知道了如何使用传统的文件处理和更现代的 with 语句方法将 print() 函数的输出重定向到文件。
将输出追加到现有文件
在上一步中，我们使用“w”模式打开文件，这会创建一个新文件或覆盖现有文件。但是，有时你可能希望将新内容添加到现有文件的末尾，而不会擦除其当前内容。为此，我们使用“a”（追加）模式。
追加到文件
让我们创建一个脚本来演示如何将输出追加到现有文件：
- 在
/home/labex/project目录中创建一个名为append_to_file.py的新文件 - 将以下代码添加到文件中：
## First, create a file with some initial content
with open("append_example.txt", "w") as file:
print("This is the initial content of the file.", file=file)
print("Created on: 2023-09-01", file=file)
print("Initial content has been written to append_example.txt")
## Now, append to the file
with open("append_example.txt", "a") as file:
print("\nThis content is being appended to the file.", file=file)
print("Appended on: 2023-09-02", file=file)
print("Additional content has been appended to append_example.txt")
## Let's check the final content
print("\nFinal content of the file:")
with open("append_example.txt", "r") as file:
print(file.read())
- 保存文件并运行它：
python3 append_to_file.py
你应该看到类似于以下内容的输出：
Initial content has been written to append_example.txt
Additional content has been appended to append_example.txt
Final content of the file:
This is the initial content of the file.
Created on: 2023-09-01
This content is being appended to the file.
Appended on: 2023-09-02
创建一个简单的日志文件
将内容追加到文件的常见用例是创建日志文件，其中添加新条目而不会删除现有条目。让我们创建一个简单的日志记录示例：
- 在
/home/labex/project目录中创建一个名为simple_log.py的新文件 - 将以下代码添加到文件中：
import datetime
def log_message(message):
"""Append a timestamped message to the log file."""
timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
with open("application.log", "a") as log_file:
print(f"[{timestamp}] {message}", file=log_file)
## Simulate some application events
log_message("Application started")
log_message("Processing data...")
## Simulate some user activity
user = "Alice"
log_message(f"User '{user}' logged in")
## Simulate an error
try:
result = 10 / 0
except Exception as e:
log_message(f"Error occurred: {e}")
log_message("Application shutting down")
print("Log entries have been written to application.log")
print("\nContents of the log file:")
with open("application.log", "r") as log_file:
print(log_file.read())
- 保存文件并运行它：
python3 simple_log.py
你应该看到类似于以下内容的输出：
Log entries have been written to application.log
Contents of the log file:
[2023-09-10 15:30:45] Application started
[2023-09-10 15:30:45] Processing data...
[2023-09-10 15:30:45] User 'Alice' logged in
[2023-09-10 15:30:45] Error occurred: division by zero
[2023-09-10 15:30:45] Application shutting down
请注意，实际的时间戳将反映你当前的日期和时间。
这个简单的日志记录示例演示了将输出追加到文件的实际应用。每次脚本运行时，它都会将新的日志条目添加到文件中，而不会删除之前的条目。这对于跟踪应用程序执行的历史记录很有用。
通过将追加模式与 print() 函数一起使用，你可以持续地将新内容添加到你的文件中，这对于许多现实世界的应用程序（如日志记录、数据收集和记录保存）至关重要。
创建一个实际应用——报告生成器
在最后一步中，我们将创建一个更实际的应用程序，它演示了如何使用 print() 函数以及文件重定向来生成格式化的报告。此示例将展示如何在实际场景中应用此技术。
构建销售报告生成器
让我们创建一个脚本，根据一些示例数据生成销售报告：
- 在
/home/labex/project目录中创建一个名为sales_report_generator.py的新文件 - 将以下代码添加到文件中：
import datetime
## Sample sales data (product, quantity, price)
sales_data = [
{"product": "Laptop", "quantity": 5, "price": 899.99},
{"product": "Mouse", "quantity": 10, "price": 24.99},
{"product": "Keyboard", "quantity": 7, "price": 49.99},
{"product": "Monitor", "quantity": 3, "price": 149.99},
{"product": "Headphones", "quantity": 12, "price": 79.99}
]
def generate_sales_report(filename):
"""Generate a formatted sales report and save it to a file."""
today = datetime.datetime.now().strftime("%Y-%m-%d")
with open(filename, "w") as report_file:
## Print the report header
print("=" * 60, file=report_file)
print(f"SALES REPORT - Generated on {today}", file=report_file)
print("=" * 60, file=report_file)
print("", file=report_file)
## Print the table header
print(f"{'Product':<15} {'Quantity':<10} {'Price ($)':<10} {'Total ($)':<10}", file=report_file)
print("-" * 50, file=report_file)
## Print sales data and calculate totals
grand_total = 0
total_items = 0
for item in sales_data:
product = item["product"]
quantity = item["quantity"]
price = item["price"]
total = quantity * price
print(f"{product:<15} {quantity:<10} {price:<10.2f} {total:<10.2f}", file=report_file)
grand_total += total
total_items += quantity
## Print the summary
print("-" * 50, file=report_file)
print(f"{'Total':<15} {total_items:<10} {'':<10} {grand_total:<10.2f}", file=report_file)
print("", file=report_file)
print("=" * 60, file=report_file)
print("End of Report", file=report_file)
## Generate the report
report_filename = "sales_report.txt"
generate_sales_report(report_filename)
print(f"Sales report has been generated: {report_filename}")
print("\nContents of the sales report:")
with open(report_filename, "r") as file:
print(file.read())
- 保存文件并运行它：
python3 sales_report_generator.py
你应该看到包含以下内容的输出：
Sales report has been generated: sales_report.txt
Contents of the sales report:
============================================================
SALES REPORT - Generated on 2023-09-10
============================================================
Product Quantity Price ($) Total ($)
--------------------------------------------------
Laptop 5 899.99 4499.95
Mouse 10 24.99 249.90
Keyboard 7 49.99 349.93
Monitor 3 149.99 449.97
Headphones 12 79.99 959.88
--------------------------------------------------
Total 37 6509.63
============================================================
End of Report
此示例演示了如何使用 print() 函数和文件重定向创建一个格式良好的报告。该报告包括标题、表格布局中的格式化数据和摘要信息。
创建一个动态日志轮换系统
让我们再创建一个示例，演示一个日志轮换系统，该系统在每次脚本运行时都会创建一个新的日志文件：
- 在
/home/labex/project目录中创建一个名为rotating_log.py的新文件 - 将以下代码添加到文件中：
import datetime
import os
def create_log_file():
"""Create a new log file with a timestamp in the filename."""
timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
log_dir = "logs"
## Create logs directory if it doesn't exist
if not os.path.exists(log_dir):
os.makedirs(log_dir)
return os.path.join(log_dir, f"log_{timestamp}.txt")
def log_event(log_file, event_type, message):
"""Log an event to the specified log file."""
timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
with open(log_file, "a") as f:
print(f"[{timestamp}] [{event_type.upper()}] {message}", file=f)
## Create a new log file
log_filename = create_log_file()
print(f"Created new log file: {log_filename}")
## Simulate some application events
log_event(log_filename, "info", "Application started")
log_event(log_filename, "info", "Initializing modules...")
log_event(log_filename, "warning", "Configuration file not found, using defaults")
log_event(log_filename, "info", "Processing data batch #1")
log_event(log_filename, "error", "Failed to connect to database server")
log_event(log_filename, "info", "Retrying connection in 5 seconds")
log_event(log_filename, "info", "Connection established")
log_event(log_filename, "info", "Application shutting down")
print("\nLog file contents:")
with open(log_filename, "r") as f:
print(f.read())
- 保存文件并运行它：
python3 rotating_log.py
你应该看到类似于以下内容的输出：
Created new log file: logs/log_20230910_153045.txt
Log file contents:
[2023-09-10 15:30:45] [INFO] Application started
[2023-09-10 15:30:45] [INFO] Initializing modules...
[2023-09-10 15:30:45] [WARNING] Configuration file not found, using defaults
[2023-09-10 15:30:45] [INFO] Processing data batch #1
[2023-09-10 15:30:45] [ERROR] Failed to connect to database server
[2023-09-10 15:30:45] [INFO] Retrying connection in 5 seconds
[2023-09-10 15:30:45] [INFO] Connection established
[2023-09-10 15:30:45] [INFO] Application shutting down
此示例演示了 Python 中文件输出的更高级应用。每次脚本运行时，它都会创建一个新的日志文件，并在文件名中包含一个时间戳，这有助于日志组织和管理。
这些实际示例展示了如何将 print() 函数的输出重定向到文件，以创建有用的应用程序，如报告生成器和日志记录系统。你在本实验中学习的技术可以应用于许多现实世界的场景，在这些场景中，你需要保存程序输出以供以后参考或分析。
总结
在本实验中，你已经学习了如何将 Python print() 函数的输出重定向到文件，而不是控制台。以下是涵盖的关键概念：
print()函数的基础知识，包括其参数和格式化选项- 如何使用
file参数将print()输出重定向到文件 - 使用文件时，写入模式（“w”）和追加模式（“a”）之间的区别
- 使用
with语句进行更安全的文件处理 - 文件输出重定向的实际应用，包括：
- 创建日志文件
- 生成格式化报告
- 实现日志轮换系统
这些技术对于许多现实世界的场景都很有价值，例如：
- 记录应用程序事件和错误
- 创建数据报告
- 保存程序输出以供以后分析
- 生成格式化的文本文件
通过掌握将 print() 函数输出重定向到文件，你已经获得了一个用于 Python 编程的强大工具，这将帮助你创建更多通用且实用的应用程序。
