生成Unicode目录结构文本的步骤详解

珍惜时间，勤奋学习！今天给大家带来《使用 os.walk() 生成 Unicode 路径目录结构文本文件的步骤如下：1. 导入 os 模块首先，导入 Python 内置的 os 模块，它提供了与操作系统交互的功能。import os2. 定义根目录路径确定你要遍历的根目录路径。你可以使用绝对路径或相对路径。root_dir = '你的目标目录路径' # 示例：'C:\\Users\\User\\Documents'3. 打开输出文件使用 with open() 打开一个文本文件，用于保存目录结构信息。注意要使用 encoding='utf-8' 来确保支持 Unicode 字符。with open('directory_structure.txt', 'w', encoding='utf-8') as f: for root, dirs, files in os.walk(root_dir): # 输出当前目录路径 f.write(f'目录: {root}\n') # 输出子目录 for dir in dirs: f.write(f' 子目录: {dir}\n') # 输出文件 for file in files: f.write(f' 文件: {file}\n') # 添加空行分隔不同层级 f.write('\n')4. 运行脚本将》，正文内容主要涉及到等等，如果你正在学习文章，或者是对文章有疑问，欢迎大家关注我！后面我会持续更新相关内容的，希望都能帮到正在学习的大家！

本文详解如何用 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 语义下，彻底规避编码失配陷阱。

终于介绍完啦！小伙伴们，这篇关于《生成Unicode目录结构文本的步骤详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！