Python案例如何创建本地文件？

wen python案例 2026-06-11 13

Python案例如何创建本地文件？——实战指南与代码精讲

文章目录导读

为什么需要掌握Python创建文件的技能？
Python创建本地文件的3种核心方法
- 1 基础篇：使用open()函数
- 2 高效篇：使用with语句自动关闭
- 3 进阶篇：使用pathlib模块（Python 3.4+）
创建文件的6个经典实战案例
- 案例1：写入文本文件（含换行处理）
- 案例2：写入CSV文件（数据导出）
- 案例3：创建JSON配置文件
- 案例4：二进制文件（如图片/压缩包）
- 案例5：多行日志文件（追加模式）
- 案例6：自动创建目录并写入文件
常见错误与异常处理（必读）
问答环节：读者最关心的5个问题
总结与最佳实践

为什么需要掌握Python创建文件的技能？

在日常数据处理、日志记录、爬虫抓取、自动化脚本等场景中，创建本地文件是基础中的基础。

Python案例如何创建本地文件？

爬虫需要将网页内容保存为HTML文件
数据分析师须将结果导出为Excel或CSV
服务器程序需要记录运行日志

根据Stack Overflow 2023年调查，89%的Python开发者每周至少使用一次文件操作，掌握这一技能，能帮你将程序输出持久化，避免数据丢失。

Python创建本地文件的3种核心方法

1 基础篇：使用`open()`函数

file = open('example.txt', 'w')
file.write('Hello, Python!')
file.close()

'w'：写入模式（覆盖已存在文件）
必须手动close()，否则文件可能未被完整写入。

2 高效篇：使用`with`语句自动关闭

with open('example.txt', 'w', encoding='utf-8') as f:
    f.write('文件自动关闭，无需操心')

使用with上下文管理器，即使出现异常也会关闭文件
推荐指定encoding='utf-8'避免中文乱码。

3 进阶篇：使用`pathlib`模块（Python 3.4+）

from pathlib import Path
path = Path('data') / 'newfile.txt'
path.parent.mkdir(exist_ok=True)  # 自动创建父目录
path.write_text('使用pathlib更现代化')

pathlib是面向对象的路径管理方式
write_text()直接写入字符串，无需open。

创建文件的6个经典实战案例

案例1：写入文本文件（含换行处理）

lines = ['第一行', '第二行', '第三行']
with open('output.txt', 'w', encoding='utf-8') as f:
    for line in lines:
        f.write(line + '\n')  # 注意手动添加换行符

关键点：write()不会自动换行，必须用\n拼接。

案例2：写入CSV文件（数据导出）

import csv
data = [['姓名', '年龄'], ['张三', 28], ['李四', 35]]
with open('users.csv', 'w', newline='', encoding='utf-8-sig') as f:
    writer = csv.writer(f)
    writer.writerows(data)

注意：newline=''防止写入空行；utf-8-sig兼容Excel打开中文。

案例3：创建JSON配置文件

import json
config = {'version': '1.0', 'debug': True, 'host': 'localhost'}
with open('config.json', 'w', encoding='utf-8') as f:
    json.dump(config, f, indent=4, ensure_ascii=False)

indent=4格式化输出
ensure_ascii=False保留中文。

案例4：二进制文件（如图片/压缩包）

with open('image_copy.png', 'wb') as f:
    with open('original.png', 'rb') as src:
        f.write(src.read())

'wb'表示写入二进制模式
用于复制图片、PDF等。

案例5：多行日志文件（追加模式）

import datetime
with open('app.log', 'a', encoding='utf-8') as f:
    f.write(f'{datetime.datetime.now()} - 用户登录成功\n')

'a'追加模式，不覆盖已有内容
适合持续记录日志。

案例6：自动创建目录并写入文件

import os
dir_path = 'output/reports'
os.makedirs(dir_path, exist_ok=True)
with open(os.path.join(dir_path, 'report.txt'), 'w') as f:
    f.write('报告内容')

exist_ok=True避免目录已存在时报错
使用os.path.join构造路径，跨系统兼容。

常见错误与异常处理（必读）

错误类型	常见原因	解决方案
`FileNotFoundError`	目录不存在	先创建目录（`os.makedirs`）
`PermissionError`	无写入权限	检查文件/文件夹权限
`UnicodeEncodeError`	编码不匹配	指定`encoding='utf-8'`
`IOError`	磁盘空间满或设备断开	检查磁盘容量

最佳实践：使用try-except捕获异常。

try:
    with open('data.txt', 'w') as f:
        f.write('内容')
except IOError as e:
    print(f'文件写入失败：{e}')

问答环节：读者最关心的5个问题

Q1：如何判断文件是否已存在，并避免覆盖？
A：使用os.path.exists() + 'x'模式（仅新建不覆盖）。

if not os.path.exists('new.txt'):
    with open('new.txt', 'x') as f:
        f.write('仅当文件不存在时创建')

Q2：写入大量数据时，怎么提升性能？
A：使用缓冲写入或writelines()。

with open('big.txt', 'w') as f:
    f.writelines([f'line{i}\n' for i in range(100000)])

Q3：如何创建不同编码格式的文件？
A：在open()中指定encoding参数，如'gbk'、'utf-8'。

Q4：同时写入多个文件的最佳实践？
A：使用多个with语句或contextlib.ExitStack。

from contextlib import ExitStack
with ExitStack() as stack:
    f1 = stack.enter_context(open('a.txt', 'w'))
    f2 = stack.enter_context(open('b.txt', 'w'))
    f1.write('内容1')
    f2.write('内容2')

Q5：为什么文件明明写入了，但内容为空？
A：最常见原因是忘记close()或未使用with语句，使用with可自动刷新缓冲区。