本文详解如何用 python 的 `os.walk()` 安全生成带缩进的目录结构文本文件，并解决因非 ascii 字符（如西里尔文、希腊字母）导致的 `unicodeencodeerror`，核心在于显式指定文件写入编码为 utf-8。
在使用 os.walk() 遍历目录并写入结构化文本时，一个常见却易被忽视的问题是：程序在遇到含中文、俄文（Cyrillic）、希腊文等 Unicode 字符的文件名时突然崩溃，抛出类似 UnicodeEncodeError: 'charmap' codec can't encode characters... 的异常。这并非 os.walk() 本身不支持 Unicode——事实上，Python 3 默认以 UTF-8 处理字符串，os.walk() 返回的路径和文件名均为原生 Unicode 字符串；真正的问题出在文件写入环节。
默认情况下，open(file_name, "w") 不显式指定 encoding 参数时，Python 会采用系统级默认编码（例如 Windows 上常为 cp1252，而非 UTF-8）。该编码无法表示大部分非拉丁字符，导致写入失败。
✅ 正确解法非常简洁：强制指定 encoding='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')? 注意事项与最佳实践：
- ✅ 始终为 open(..., "w") 显式传入 encoding='utf-8'，尤其在处理跨平台或国际化路径时；
- ✅ 若需兼容旧版 Python（<3.7），建议同时添加 errors='replace' 或 'ignore'（如 encoding='utf-8', errors='replace'）以避免极端情况下的静默截断；
- ⚠️ 不要尝试对字符串手动 encode().decode()（如问题中所示）——这既无必要，也无法绕过文件写入层的编码限制；
- ? 可通过 import locale; print(locale.getpreferredencoding()) 快速确认当前环境默认编码，辅助调试；
- ? 如需生成更标准的树状结构（如类 Unix tree 命令效果），可进一步封装缩进逻辑或使用第三方库 pathlib + 递归生成器提升可读性。
该方案轻量、可靠且符合 Python 3 的 Unicode 理念：让输入（os.walk）与输出（open）统一在 UTF-8 语义下，彻底规避编码失配陷阱。
