linux readdir怎么处理中文路径

在 Linux 下使用 readdir（通常指 readdir() / readdir_r()，属于 POSIX dirent.h）处理中文路径时，核心原则是：

Linux 下文件名是以字节串（UTF-8 编码）存储的，不要当成 C 的 char* 字符串逻辑去“解释”，直接当字节处理即可。

下面按常见问题和正确做法说明。

一、readdir 本身“天然支持”中文

readdir 返回的结构体：

struct dirent {
    ino_t          d_ino;
    off_t          d_off;
    unsigned short d_revent;
    unsigned char  d_type;
    char           d_name[];   // 文件名（字节序列）
};

✅ 中文路径不需要特殊 API
只要：

• 你的系统使用 UTF-8 locale（如 zh_CN.UTF-8）
• 文件系统中的文件名是 UTF-8 编码

那么 d_name 中就是正常的 UTF-8 字节流。

二、正确读取中文目录示例

#include <stdio.h>
#include <dirent.h>
#include <string.h>

int main() {
    DIR *dir = opendir("/中文目录");
    if (!dir) {
        perror("opendir");
        return 1;
    }

    struct dirent *entry;
    while ((entry = readdir(dir)) != NULL) {
        printf("%s\n", entry->d_name);  // UTF-8 直接输出
    }

    closedir(dir);
    return 0;
}

✅ 编译运行即可正常显示中文（终端需支持 UTF-8）

三、常见错误 & 坑

❌ 1. 用 strlen / strcpy 当“字符数”处理

UTF-8 中文是 多字节：

strlen("中文"); // = 6，不是 2

✅ 正确方式：

• 当作 字节串
• 需要“字符数”时用 mbstowcs

❌ 2. 手动截断文件名

char name[10];
strncpy(name, entry->d_name, 10); // 可能截断 UTF-8 字符

✅ 正确方式：

• 使用足够大的缓冲区
• 或动态分配

❌ 3. locale 没设置

如果终端乱码：

#include <locale.h>
setlocale(LC_ALL, "");

建议程序开始时调用。

四、需要“处理”中文时的建议

1️⃣ 拼接路径（推荐 snprintf）

char path[1024];
snprintf(path, sizeof(path), "%s/%s", dirname, entry->d_name);

2️⃣ 用 open / stat 操作中文文件

直接使用 entry->d_name 即可：

stat(path, &st);

Linux 内核不关心“是不是中文”，只看字节。

3️⃣ 想要“字符级”操作（少见）

使用：

• mbrtowc
• <wchar.h>
• 或第三方库（ICU）

⚠️ 一般没必要

五、总结一句话

Linux 下 readdir 处理中文路径：不要“处理”，直接当 UTF-8 字节串用。

如果你有具体场景（比如：

• 中文排序
• 中文搜索
• 中文路径做网络传输
• C++ / Python / Rust 混合

可以告诉我，我可以给你更针对性的方案。