本文详解如何用 python 的 `os.walk()` 安全遍历含非 ascii 字符（如西里尔文、希腊字母）的路径，并生成正确编码的目录结构文本文件，核心在于显式指定文件写入时的 utf-8 编码。
在使用 os.walk() 生成目录结构树时，若目标路径中存在 Unicode 文件名（例如俄语、希腊语、中文等），原始代码常会抛出 UnicodeEncodeError，典型错误信息如下：
UnicodeEncodeError: 'charmap' codec can't encode characters in position 4-11: character maps to <undefined>
该异常并非源于 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') 显式保真。一句代码修正，即可彻底规避编码陷阱。
