projects/
├── src/
│   ├── main.c
│   └── utils/
│       ├── string.c
│       └── file.c
├── include/
│   ├── utils.h
│   └── config.h
└── Makefile

/**
 * 递归打印目录树结构
 * @param path 当前目录路径（如"/home/user/projects"）
 * @param depth 递归深度（用于计算缩进层级，根目录depth=1）
 * @param is_last 标记数组，is_last[i]=1表示第i层为最后一个分支
 */
void print_dir(const char *path, int depth, int is_last[]) {
    // 打开目录流，获取目录操作句柄
    DIR *dirp = opendir(path);
    ERROR_CHECK(dirp, NULL, "opendir");  // 检查目录打开是否失败
    
    // 读取目录下所有条目，alphasort参数实现字母顺序排序
    struct dirent **entries;
    int n = scandir(path, &entries, NULL, alphasort);
    ERROR_CHECK(n, -1, "scandir");      // 检查目录读取是否失败
    
    // 统计有效条目数（排除.和..这两个特殊目录）
    int entry_count = 0;
    for (int i = 0; i < n; i++) {
        if (strcmp(entries[i]->d_name, ".") != 0 && strcmp(entries[i]->d_name, "..") != 0) {
            entry_count++;
        }
    }
    
    int current_entry = 0;  // 当前处理的条目索引
    // 遍历所有目录项
    for (int i = 0; i < n; i++) {
        // 跳过当前目录和上级目录
        if (strcmp(entries[i]->d_name, ".") == 0 || strcmp(entries[i]->d_name, "..") == 0) {
            free(entries[i]);  // 释放无效条目内存
            continue;
        }
        
        // 判断是否为当前层最后一个条目（用于选择分支符号）
        int is_current_last = (current_entry == entry_count - 1);
        
        // 打印缩进：根据深度和is_last数组生成层级视觉效果
        for (int j = 0; j < depth - 1; j++) {
            printf(is_last[j] ? "   " : "│  ");  // 最后一个分支用空格，否则用竖线
        }
        
        // 打印分支符号：最后一个条目用└──，否则用├──
        printf(is_current_last ? "└──" : "├──");
        printf("%s\n", entries[i]->d_name);  // 打印文件名/目录名
        
        // 递归处理子目录（仅当条目类型为目录时）
        if (entries[i]->d_type == DT_DIR) {
            char new_path[1024];  // 存储子目录完整路径
            // 安全拼接路径，避免缓冲区溢出（指定目标长度sizeof(new_path)）
            snprintf(new_path, sizeof(new_path), "%s/%s", path, entries[i]->d_name);
            
            // 更新is_last数组：当前层是否为最后一个分支
            is_last[depth] = is_current_last;
            
            // 递归调用，深度+1（进入下一层目录）
            print_dir(new_path, depth + 1, is_last);
        }
        
        free(entries[i]);  // 释放当前条目内存
        current_entry++;   // 移动到下一个条目
    }
    
    free(entries);     // 释放entries数组内存
    closedir(dirp);    // 关闭目录流，释放系统资源
}

int main(int argc, char *argv[]) {
    // 检查命令行参数数量（必须传入一个目录路径）
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <directory>\n", argv[0]);  // 输出使用帮助
        return EXIT_FAILURE;  // 返回错误状态码
    }
    
    // 验证输入路径是否为有效目录
    struct stat st;
    if (stat(argv[1], &st) != 0 || !S_ISDIR(st.st_mode)) {
        fprintf(stderr, "Error: %s is not a valid directory\n", argv[1]);  // 错误提示
        return EXIT_FAILURE;
    }
    
    // 打印根目录名称（如"projects/"）
    printf("%s\n", argv[1]);
    
    // 初始化is_last数组：标记每一层是否为最后一个分支（默认全为0）
    int is_last[1024] = {0};
    
    // 从根目录开始递归打印目录树（深度初始为1）
    print_dir(argv[1], 1, is_last);
    
    return 0;  // 程序正常结束
}

snprintf(new_path, sizeof(new_path), "%s/%s", path, entries[i]->d_name);

gcc -o dir_tree dir_tree.c -std=c99

test_dir/
├── file1.txt
├── subdir1/
│   ├── file2.txt
│   └── subsubdir/
│       └── file3.txt
└── subdir2/
    └── file4.txt

./dir_tree test_dir

test_dir/
├── file1.txt
├── subdir1/
│   ├── file2.txt
│   └── subsubdir/
│       └── file3.txt
└── subdir2/
    └── file4.txt