C语言文件大小获取：fseek/ftell与stat方法详解与实践

在实际 C 语言项目中，处理文件时经常需要知道文件的大小，比如读取整个文件到内存、校验文件完整性或者限制上传文件体积。但 C 语言标准库并没有直接提供一个类似get_file_size()的函数，这让很多初学者在第一次需要获取文件大小时感到困惑。

本文将围绕 C 语言中几种获取文件大小的常用方法，从基础概念到实际代码实现，逐步讲解其原理、适用场景和注意事项。无论你是刚接触文件操作的初学者，还是需要在嵌入式或系统编程中处理文件的开发者，都能通过本文掌握可靠的文件大小获取方案。

1. 理解文件大小与 C 语言文件操作基础

1.1 文件大小在操作系统中的表示方式

在大多数操作系统中，文件大小通常以字节为单位存储为无符号整数。这个信息保存在文件的元数据（metadata）中，而不是文件内容本身。当我们谈论“获取文件大小”时，实际上是在读取文件系统的元数据信息。

不同系统对文件大小的表示有所差异：

• 在 Linux/Unix 系统中，使用stat结构体存储文件信息
• 在 Windows 系统中，可以使用_stat或文件句柄操作
• 32 位系统通常最大支持 2GB 文件，64 位系统支持更大的文件

1.2 C 语言文件操作的核心函数

C 语言通过标准库<stdio.h>提供文件操作函数，常用的包括：

• fopen()- 打开文件
• fclose()- 关闭文件
• fseek()- 移动文件指针
• ftell()- 获取当前文件位置

理解这些函数是掌握文件大小获取方法的基础。特别是fseek()和ftell()的组合使用，是获取文件大小的经典方法。

1.3 文件大小获取方法的分类

根据实现原理，C 语言中获取文件大小主要有三种方法：

1. 使用fseek()和ftell()组合- 最常用的可移植方法
2. 使用stat()系统调用- 效率最高，但系统依赖性较强
3. 逐字节读取计数- 教学用途，实际项目中不推荐

每种方法都有其适用场景和限制，接下来我们会详细分析每种方法的实现。

2. 使用 fseek 和 ftell 组合获取文件大小

2.1 方法原理与实现步骤

这种方法的核心思想是：将文件指针移动到文件末尾，然后获取当前位置的偏移量，这个偏移量就是文件的大小。

基本步骤如下：

1. 使用fopen()以二进制模式打开文件
2. 使用fseek()将文件指针移动到文件末尾
3. 使用ftell()获取当前文件位置（即文件大小）
4. 使用fseek()将文件指针移回文件开头（可选，便于后续读取）
5. 关闭文件

#include <stdio.h> long get_file_size(const char* filename) { FILE* file = fopen(filename, "rb"); // 以二进制只读模式打开 if (file == NULL) { return -1; // 文件打开失败 } // 移动文件指针到末尾 if (fseek(file, 0, SEEK_END) != 0) { fclose(file); return -1; } // 获取当前位置（文件大小） long size = ftell(file); fclose(file); return size; }

2.2 关键参数说明与错误处理

文件打开模式的重要性：

• 必须使用二进制模式（"rb"），文本模式在某些系统下会影响文件位置计算
• 如果计划修改文件，可以使用 "r+b" 模式

错误处理的必要性：

• 检查fopen()返回值，文件不存在或权限不足时会返回 NULL
• 检查fseek()返回值，移动失败时返回非零值
• 确保在任何错误路径上都正确关闭文件

改进的错误处理版本：

#include <stdio.h> #include <errno.h> #include <string.h> long get_file_size_robust(const char* filename) { FILE* file = fopen(filename, "rb"); if (file == NULL) { fprintf(stderr, "无法打开文件 %s: %s\n", filename, strerror(errno)); return -1; } if (fseek(file, 0, SEEK_END) != 0) { fprintf(stderr, "文件定位失败: %s\n", strerror(errno)); fclose(file); return -1; } long size = ftell(file); if (size == -1) { fprintf(stderr, "获取文件位置失败: %s\n", strerror(errno)); fclose(file); return -1; } fclose(file); return size; }

2.3 方法优缺点与适用场景

优点：

• 可移植性好，在所有符合 C 标准的平台上都能工作
• 实现简单，代码直观易懂
• 不需要额外的系统特定头文件

缺点：

• 需要实际打开文件，有一定性能开销
• 对于超大文件（超过 LONG_MAX），ftell()可能返回值不准确
• 不适用于无法用fopen()打开的特殊文件

适用场景：

• 需要跨平台兼容的应用程序
• 处理中小型文件（通常小于 2GB）
• 开发通用库函数

3. 使用 stat 系统调用获取文件大小

3.1 stat 函数族介绍

stat()系列函数是直接查询文件系统元数据的系统调用，可以获取文件的详细信息，包括大小、权限、修改时间等。

不同系统的 stat 函数：

• Linux/Unix:stat(),fstat(),lstat()
• Windows:_stat(),_fstat(),_stat64()等

相关结构体定义：

#include <sys/stat.h> struct stat { dev_t st_dev; // 设备 ID ino_t st_ino; // inode 编号 mode_t st_mode; // 文件类型和权限 nlink_t st_nlink; // 硬链接数 uid_t st_uid; // 所有者用户 ID gid_t st_gid; // 所有者组 ID dev_t st_rdev; // 设备类型（如果是设备文件） off_t st_size; // 文件大小（字节） // ... 其他时间字段等 };

3.2 跨平台实现方案

由于不同系统的stat实现有差异，需要编写条件编译代码来保证可移植性：

#include <sys/stat.h> #ifdef _WIN32 #include <windows.h> #endif long get_file_size_stat(const char* filename) { struct stat file_stat; // 调用 stat 函数获取文件信息 if (stat(filename, &file_stat) == -1) { perror("stat 调用失败"); return -1; } // 检查是否为普通文件 if (!S_ISREG(file_stat.st_mode)) { fprintf(stderr, "%s 不是普通文件\n", filename); return -1; } return (long)file_stat.st_size; }

Windows 系统特殊处理：

#ifdef _WIN32 long get_file_size_windows(const char* filename) { struct _stat file_stat; if (_stat(filename, &file_stat) != 0) { return -1; } return (long)file_stat.st_size; } #endif

3.3 处理大文件的支持

对于超过 2GB 的大文件，需要使用 64 位文件大小支持：

#include <sys/stat.h> #ifdef _WIN32 #include <windows.h> #endif // 返回 64 位文件大小 long long get_large_file_size(const char* filename) { #ifdef _WIN32 struct _stat64 file_stat; if (_stat64(filename, &file_stat) != 0) { return -1; } #else struct stat file_stat; if (stat(filename, &file_stat) == -1) { return -1; } #endif return file_stat.st_size; }

3.4 性能对比与选择建议

性能特点对比：

选择建议：

• 追求性能：优先选择stat()方法
• 需要处理超大文件：使用 64 位版本的stat
• 简单跨平台：使用fseek()/ftell()组合
• 特殊文件（如管道）：可能需要其他方法

4. 实际应用与完整示例

4.1 完整的文件大小获取工具

下面是一个完整的示例程序，演示了多种获取文件大小的方法：

#include <stdio.h> #include <stdlib.h> #include <string.h> #include <errno.h> #include <sys/stat.h> // 方法1: 使用 fseek/ftell long get_size_method1(const char* filename) { FILE* file = fopen(filename, "rb"); if (!file) return -1; fseek(file, 0, SEEK_END); long size = ftell(file); fclose(file); return size; } // 方法2: 使用 stat long get_size_method2(const char* filename) { struct stat file_stat; if (stat(filename, &file_stat) == -1) { return -1; } return (long)file_stat.st_size; } // 统一的文件大小获取函数 long get_file_size(const char* filename, int method) { switch (method) { case 1: return get_size_method1(filename); case 2: return get_size_method2(filename); default: return -1; } } int main(int argc, char* argv[]) { if (argc != 2) { printf("用法: %s <文件名>\n", argv[0]); return 1; } const char* filename = argv[1]; printf("检查文件: %s\n", filename); // 尝试两种方法 long size1 = get_file_size(filename, 1); long size2 = get_file_size(filename, 2); if (size1 == -1) { printf("方法1失败: 无法获取文件大小\n"); } else { printf("方法1 (fseek/ftell): %ld 字节 (%.2f KB, %.2f MB)\n", size1, size1/1024.0, size1/(1024.0*1024.0)); } if (size2 == -1) { printf("方法2失败: 无法获取文件大小\n"); } else { printf("方法2 (stat): %ld 字节 (%.2f KB, %.2f MB)\n", size2, size2/1024.0, size2/(1024.0*1024.0)); } // 验证结果一致性 if (size1 != -1 && size2 != -1 && size1 != size2) { printf("警告: 两种方法结果不一致！\n"); } return 0; }

4.2 编译与测试

编译命令：

# Linux/Mac gcc -o filesize filesize.c # Windows (MinGW) gcc -o filesize.exe filesize.c

测试用例：

# 创建测试文件 echo "这是一个测试文件" > test.txt # 运行程序 ./filesize test.txt ./filesize /etc/passwd # 系统文件 ./filesize /nonexistent # 不存在的文件

4.3 实际应用场景示例

场景1：读取整个文件到内存

#include <stdio.h> #include <stdlib.h> #include <string.h> char* read_entire_file(const char* filename) { FILE* file = fopen(filename, "rb"); if (!file) return NULL; fseek(file, 0, SEEK_END); long size = ftell(file); fseek(file, 0, SEEK_SET); if (size <= 0) { fclose(file); return NULL; } char* buffer = malloc(size + 1); if (!buffer) { fclose(file); return NULL; } size_t read_size = fread(buffer, 1, size, file); buffer[read_size] = '\0'; // 添加字符串结束符 fclose(file); if (read_size != (size_t)size) { free(buffer); return NULL; } return buffer; }

场景2：文件大小限制检查

#include <stdbool.h> bool is_file_size_valid(const char* filename, long max_size) { long size = get_file_size(filename, 2); // 使用 stat 方法 if (size == -1) { return false; // 文件不存在或无法访问 } return size <= max_size; }

5. 常见问题与解决方案

5.1 文件大小获取失败的原因分析

5.2 大文件处理注意事项

32 位系统的限制：

• long类型通常为 4 字节，最大表示 2GB
• 使用long long或off_t处理大文件
• 考虑使用 64 位版本的函数

大文件安全代码示例：

#include <stdint.h> int64_t get_file_size64(const char* filename) { #ifdef _WIN32 struct _stat64 file_stat; if (_stat64(filename, &file_stat) != 0) { return -1; } return file_stat.st_size; #else struct stat file_stat; if (stat(filename, &file_stat) == -1) { return -1; } return (int64_t)file_stat.st_size; #endif }

5.3 跨平台兼容性处理

条件编译的最佳实践：

#if defined(_WIN32) || defined(_WIN64) #define PLATFORM_WINDOWS 1 #elif defined(__linux__) #define PLATFORM_LINUX 1 #elif defined(__APPLE__) #define PLATFORM_MAC 1 #else #define PLATFORM_UNKNOWN 1 #endif #if PLATFORM_WINDOWS #include <windows.h> #define STAT_FUNC _stat64 #define STAT_STRUCT _stat64 #else #include <sys/stat.h> #define STAT_FUNC stat #define STAT_STRUCT stat #endif

5.4 性能优化建议

避免重复获取文件大小：

• 如果程序需要多次使用同一文件大小，缓存结果
• 对于频繁访问的文件，考虑使用内存映射

选择合适的方法：

• 单次查询：使用stat()方法
• 已打开文件：使用fstat()避免重复打开
• 需要文件句柄：使用fseek()/ftell()组合

6. 最佳实践与扩展应用

6.1 生产环境中的文件大小获取

在生产环境中，除了基本的功能实现，还需要考虑：

错误处理与日志记录：

#include <time.h> long get_file_size_production(const char* filename) { struct stat file_stat; time_t start_time = time(NULL); if (stat(filename, &file_stat) == -1) { // 记录详细的错误信息 fprintf(stderr, "[ERROR] %s: 无法获取文件 %s 的大小: %s\n", ctime(&start_time), filename, strerror(errno)); return -1; } if (!S_ISREG(file_stat.st_mode)) { fprintf(stderr, "[WARNING] %s: %s 不是普通文件\n", ctime(&start_time), filename); return -1; } printf("[INFO] %s: 成功获取文件 %s 大小: %ld 字节\n", ctime(&start_time), filename, (long)file_stat.st_size); return (long)file_stat.st_size; }

6.2 文件大小获取的性能基准测试

对于性能敏感的应用，可以编写简单的基准测试：

#include <time.h> void benchmark_file_size_methods(const char* filename, int iterations) { clock_t start, end; double time_used; // 测试方法1: fseek/ftell start = clock(); for (int i = 0; i < iterations; i++) { get_size_method1(filename); } end = clock(); time_used = ((double)(end - start)) / CLOCKS_PER_SEC; printf("方法1 (fseek/ftell): %d 次耗时 %.4f 秒\n", iterations, time_used); // 测试方法2: stat start = clock(); for (int i = 0; i < iterations; i++) { get_size_method2(filename); } end = clock(); time_used = ((double)(end - start)) / CLOCKS_PER_SEC; printf("方法2 (stat): %d 次耗时 %.4f 秒\n", iterations, time_used); }

6.3 扩展应用：目录大小计算

基于文件大小获取，可以进一步实现目录大小计算：

#include <dirent.h> #ifdef _WIN32 #include <windows.h> #endif long long calculate_directory_size(const char* dirpath) { long long total_size = 0; DIR* dir = opendir(dirpath); if (!dir) { return -1; } struct dirent* entry; while ((entry = readdir(dir)) != NULL) { // 跳过 . 和 .. 目录 if (strcmp(entry->d_name, ".") == 0 || strcmp(entry->d_name, "..") == 0) { continue; } // 构建完整路径 char fullpath[1024]; snprintf(fullpath, sizeof(fullpath), "%s/%s", dirpath, entry->d_name); struct stat file_stat; if (stat(fullpath, &file_stat) == -1) { continue; } if (S_ISREG(file_stat.st_mode)) { total_size += file_stat.st_size; } else if (S_ISDIR(file_stat.st_mode)) { long long subdir_size = calculate_directory_size(fullpath); if (subdir_size != -1) { total_size += subdir_size; } } } closedir(dir); return total_size; }

6.4 安全注意事项

路径遍历攻击防护：

#include <libgen.h> bool is_safe_path(const char* filename) { // 检查是否包含危险的路径遍历模式 if (strstr(filename, "../") != NULL || strstr(filename, "..\\") != NULL) { return false; } // 检查绝对路径是否在允许的目录内 char* resolved_path = realpath(filename, NULL); if (!resolved_path) { return false; } // 验证路径是否在安全目录内 bool is_safe = (strncmp(resolved_path, "/safe/directory/", 16) == 0); free(resolved_path); return is_safe; }

掌握 C 语言中获取文件大小的方法只是文件处理的基础，在实际项目中还需要结合具体的应用场景选择最合适的方案。对于性能要求高的场景优先使用 stat 方法，对于需要最大可移植性的情况使用 fseek/ftell 组合，处理超大文件时注意使用 64 位版本。正确的错误处理和边界条件检查是保证程序健壮性的关键。