如何使用 os.walk() 生成包含目录结构的 UTF-8 编码文本文件_网络技术

如何使用 os.walk() 生成包含目录结构的 UTF-8 编码文本文件

发布时间 - 2026-01-09 00:00:00 点击率：次

本文详解如何用 python 的 `os.walk()` 安全遍历含非 ascii 字符（如西里尔文、希腊字母）的路径，并生成正确编码的目录结构文本文件，核心在于显式指定文件写入时的 utf-8 编码。

在使用 os.walk() 生成目录结构树时，若目标路径中存在 Unicode 文件名（例如俄语、希腊语、中文等），原始代码常会抛出 UnicodeEncodeError，典型错误信息如下：

UnicodeEncodeError: 'charmap' codec can't encode characters in position 4-11: character maps to

该异常并非源于 os.walk() 本身——Python 3 中 os.walk() 默认返回 str 类型的 Unicode 路径和文件名（内部以 UTF-8 表示），完全支持多语言字符。真正的问题出在文件写入环节：open(file_name, "w") 在未指定 encoding 参数时，会采用系统默认编码（Windows 上常为 cp1252，Linux/macOS 通常为 utf-8），而 cp1252 等传统编码无法表示绝大多数非拉丁字符，导致写入失败。

✅ 正确解法是：显式声明文件编码为 'utf-8'。修改后的健壮版本如下：

import os

def record_directory_structure(directory_path: str, file_name: str):
    # ✅ 关键修复：强制使用 UTF-8 编码写入文件
    with open(file_name, "w", encoding='utf-8') as file:
        for root, dirs, files in os.walk(directory_path):
            # 计算当前目录层级（相对于起始路径）
            level = root.replace(directory_path, '').count(os.sep)
            indent = ' ' * 4 * level
            # 写入目录名（结尾加 '/'）
            file.write(f'{indent}{os.path.basename(root)}/\n')

            # 子项缩进（比目录多一级）
            subindent = ' ' * 4 * (level + 1)
            # 按字典序排序文件，提升可读性（可选）
            for f in sorted(files):
                file.write(f'{subindent}{f}\n')

? 使用示例：

record_directory_structure(r"C:\my_project", "structure.txt")
# 或处理含西里尔文路径：
record_directory_structure(r"D:\Проекты\Анализ", "структура.txt")

⚠️ 注意事项：

不要尝试对文件名做 encode('utf-8').decode('utf-8') 等无意义的编解码操作——这既不解决写入问题，还可能引入冗余或错误；
若需兼容旧版 Python（
生成的 .txt 文件可用 VS Code、Notepad++ 或现代系统记事本（启用 UTF-8 检测）正确查看，避免用老旧记事本直接打开（它可能误判编码）；
如需增强可读性，可对 dirs 和 files 分别排序（例如 sorted(dirs)），使输出结构更稳定。

总结：处理国际化路径的核心原则是——读取靠 os.walk() 自动 Unicode 化，写入靠 open(..., encoding='utf-8') 显式保真。一句代码修正，即可彻底规避编码陷阱。

# linux # python # windows # 编码 # mac # macos # win # 多语言 # vs code # cos

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：在Java中什么是反射机制_Java运行时动态访问解析

下一篇：javascript中的闭包是什么概念_它如何影响变量的作用

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：在Java中什么是反射机制_Java运行时动态访问解析

下一篇：javascript中的闭包是什么概念_它如何影响变量的作用