在 C++ 开发中，我们经常需要确定特定文件的大小，也就是计算文件在磁盘上所占用的字节数。无论我们是在构建一个需要监控日志文件大小的系统，还是在开发一个需要验证上传文件是否符合限制的 Web 服务，亦或是进行简单的文件存在性检查，获取文件大小都是一项基础且关键的操作。
在这篇文章中，我们将深入探讨在 C++ 中获取文件大小的各种方法。我们将重点介绍现代 C++（C++17 及更高版本）中推荐的 std::filesystem 库，同时为了全面性和兼容性，我们也会回顾在旧标准中常用的传统 C 风格方法。通过这篇文章，你将不仅学会如何编写代码，还能理解背后的原理、潜在的错误处理机制以及实际项目中的最佳实践。
问题示例
在我们开始编写代码之前，让我们先明确一下我们要解决的具体问题。假设我们有一个文件路径，我们需要编写程序来读取该文件的大小并以字节为单位显示出来。
场景输入：
FilePath = "sample.txt"
假设 sample.txt 文件中包含字符串 "Hello"。
预期输出：
File Size: 5 Bytes
看起来很简单，对吧？但在实际的工程环境中，我们需要考虑更多因素：文件是否存在？我们是否有权限读取它？文件是否为空？让我们一步步来解决这些问题。
—
方法一：使用 C++17 的 std::filesystem（推荐）
从 C++17 标准开始，C++ 引入了强大的 INLINECODE880dafb6 库。这可以说是处理文件操作的一次革命，它让我们摆脱了繁杂且不跨平台的 POSIX 或 Windows API 调用。我们可以使用 INLINECODEe8b68991 函数来轻松获取文件大小。
#### 核心原理
INLINECODEf0a65069 接受一个文件路径作为参数，并返回一个 INLINECODE7e13127c 类型的值，代表文件的大小（以字节为单位）。这是一个同步调用，意味着操作系统会立即去查询文件的元数据。
#### 代码示例 1：基础用法
让我们来看一个最简单的实现。
// C++17 程序：使用 std::filesystem 获取文件大小
#include
#include
namespace fs = std::filesystem; // 为了简化代码，使用别名
int main() {
// 定义文件路径
// 这里的路径可以是绝对路径，也可以是相对路径
std::string filePath = "sample.txt";
try {
// 检查文件是否存在，这是一个好习惯
if (!fs::exists(filePath)) {
std::cerr << "错误：文件 " << filePath << " 不存在。" << std::endl;
return 1;
}
// 确保它是一个文件，而不是目录
if (!fs::is_regular_file(filePath)) {
std::cerr << "错误：路径 " << filePath << " 不是一个常规文件。" << std::endl;
return 1;
}
// 调用 file_size() 获取大小
uintmax_t size = fs::file_size(filePath);
std::cout << "文件大小: " << size << " 字节" << std::endl;
} catch (const fs::filesystem_error& e) {
// 捕获并处理文件系统可能抛出的异常
std::cerr << "文件系统异常: " << e.what() << std::endl;
}
return 0;
}
代码解析：
在这个例子中，我们首先引入了 INLINECODEeaf9043d 头文件，并为了方便使用了 INLINECODEd3f925bc。我们在 INLINECODEe362884c 函数中使用了 INLINECODE824261a6 块，这是非常重要的。INLINECODE2a1dbe50 函数在遇到权限不足或文件不存在（如果我们没提前检查）时会抛出异常。此外，我们还加入了 INLINECODE8e0c9521 检查，因为如果我们对目录调用 file_size，行为是未定义的或者会抛出异常，这取决于具体的编译器实现。
#### 代码示例 2：结合命令行参数的实用工具
让我们把上面的逻辑封装得更像一个真实的命令行工具。我们可以通过命令行参数传入文件路径。
#include
#include
#include
#include // 用于格式化输出
namespace fs = std::filesystem;
// 辅助函数：将字节大小转换为人类可读的格式
std::string format_size(uintmax_t bytes) {
const char* suffixes[] = { "B", "KB", "MB", "GB", "TB" };
int suffix_index = 0;
double size = static_cast(bytes);
while (size >= 1024 && suffix_index < 5) {
size /= 1024;
suffix_index++;
}
std::stringstream ss;
ss << std::fixed << std::setprecision(2) << size << " " << suffixes[suffix_index];
return ss.str();
}
int main(int argc, char* argv[]) {
// 检查是否提供了文件路径参数
if (argc < 2) {
std::cout << "用法: " << argv[0] << " " << std::endl;
return 1;
}
fs::path filePath(argv[1]);
// 如果路径是相对路径，通常相对于当前工作目录
// 我们可以输出绝对路径以便确认
try {
if (fs::exists(filePath) && fs::is_regular_file(filePath)) {
uintmax_t size = fs::file_size(filePath);
std::cout << "文件: " << filePath.filename() << std::endl;
std::cout << "原始大小: " << size << " Bytes" << std::endl;
std::cout << "格式化大小: " << format_size(size) << std::endl;
} else {
std::cerr << "错误: 无法找到文件或路径指向一个目录。" << std::endl;
}
} catch (const fs::filesystem_error& e) {
std::cerr << "发生错误: " << e.what() << std::endl;
}
return 0;
}
在这个进阶示例中，我添加了一个 INLINECODE303da372 函数。在实际开发中，用户通常更习惯看到 "1.5 MB" 而不是 "1572864 Bytes"。这种小细节能显著提升用户体验。同时，处理 INLINECODE3097ee87 参数让程序更加灵活。
—
方法二：传统 C 风格文件操作（兼容旧标准）
虽然 INLINECODE4528324f 非常棒，但在某些情况下，你可能受限于编译器环境（例如某些嵌入式系统使用的是老旧的 GCC 版本，且无法升级），此时传统的 C 语言文件库（INLINECODEf479f678 或 ）依然是你的救星。
#### 核心原理
我们使用 INLINECODE0043e56e 打开文件，然后使用 INLINECODE93c2c692 将文件指针移动到文件末尾。此时，调用 INLINECODE8a6b4cdb 将返回文件指针相对于文件起始位置的字节偏移量，这正是文件的大小。最后记得使用 INLINECODE14ef1751 关闭文件。
#### 代码示例 3：使用 stdio.h 获取大小
#include
#include // 包含 fopen, fseek, ftell, fclose
// 使用传统的 C 方法获取文件大小
long get_file_size(const char* filename) {
FILE* file = fopen(filename, "rb"); // 以二进制只读模式打开
if (file == nullptr) {
return -1; // 返回 -1 表示打开失败
}
// 1. 将文件指针移动到文件末尾
if (fseek(file, 0, SEEK_END) != 0) {
fclose(file); // 记得在错误返回前关闭文件
return -1;
}
// 2. 获取当前指针位置（即文件大小）
long size = ftell(file);
// 3. 关闭文件
fclose(file);
return size;
}
int main() {
const char* filename = "data.bin";
long size = get_file_size(filename);
if (size != -1) {
std::cout << "文件 " << filename << " 的大小是: " << size << " 字节" << std::endl;
} else {
std::cerr << "无法获取文件大小或文件不存在。" << std::endl;
}
return 0;
}
注意事项：
这里我们使用了二进制模式 (INLINECODE9584a8cf) 来打开文件。在 Windows 系统中，如果不使用二进制模式，文本模式可能会对换行符进行转换（例如 INLINECODE61c266f0 转换为 INLINECODEe91f9299），这会导致 INLINECODE2c3311be 返回的大小与磁盘实际占用不符。因此，为了获取最准确的字节大小，始终使用二进制模式是至关重要的。
另外，INLINECODEe20f7fc8 类型在某些 32 位系统上可能无法存储超过 2GB 的文件。如果文件很大，这种方法可能会返回错误的大小。对于大文件支持，你可能需要使用特定平台的 64 位 API（如 Windows 上的 INLINECODE4e4c5a4f 或 Linux 上的 INLINECODE99a3be0e），但这会破坏代码的可移植性。这正是 C++17 INLINECODEce5da49e 使用 uintmax_t （通常是 64 位无符号整数）的优势所在。
—
方法三：使用 C++ 文件流
如果你不想使用 C 风格的指针，但又不能用 C++17，那么 是另一种选择。不过，这种方法相对繁琐且效率较低，因为它主要关注流的内容处理，而不是文件元数据。
#### 核心原理
打开一个 INLINECODE398025ee，利用 INLINECODE0df80d84 和 tellg 成员函数来执行与 C 风格方法相同的定位操作。
#### 代码示例 4：使用 std::ifstream 获取大小
#include
#include
#include
std::streamsize get_file_size_stream(const std::string& filename) {
std::ifstream file(filename, std::ios::binary | std::ios::ate);
// std::ios::ate 会在打开时直接将指针定位到末尾
if (!file.is_open()) {
return -1;
}
// tellg() 返回当前位置，即文件大小
std::streamsize size = file.tellg();
return size;
}
int main() {
std::string filename = "large_data.dat";
std::streamsize size = get_file_size_stream(filename);
if (size >= 0) {
std::cout << "文件大小: " << size << " 字节" << std::endl;
} else {
std::cout << "打开文件失败。" << std::endl;
}
return 0;
}
代码解析：
这里利用了 INLINECODEec77508c (At End) 标志，这是一个小技巧。它打开文件后自动将指针置于末尾，省去了我们自己调用 INLINECODE58341327 的步骤。虽然代码看起来很 "C++"，但 tellg() 的返回类型在某些平台可能并不直接对应严格的字节大小（尽管在现代实现中通常是一致的）。这种方法通常用于预处理文件读取，例如预分配内存缓冲区。
—
方法四：使用 std::filesystem::directory_iterator（特殊情况）
有时候我们不想获取单个文件的大小，而是想遍历一个目录并计算所有文件的总大小。虽然这超出了 "获取文件大小" 的单一范畴，但在实际应用中非常常见。
#### 代码示例 5：计算目录总大小
#include
#include
#include // for std::accumulate
namespace fs = std::filesystem;
// 递归计算目录的大小
uintmax_t calculate_directory_size(const fs::path& dirPath) {
uintmax_t totalSize = 0;
if (!fs::exists(dirPath) || !fs::is_directory(dirPath)) {
std::cerr << "路径无效或不是目录。" << std::endl;
return 0;
}
// 使用 recursive_directory_iterator 遍历所有子目录
for (const auto& entry : fs::recursive_directory_iterator(dirPath)) {
// 确保是常规文件，不计入符号链接或目录本身的大小
if (entry.is_regular_file()) {
try {
totalSize += entry.file_size();
} catch (...) {
// 忽略无权限访问的文件
std::cerr << "警告: 无法读取 " << entry.path() << " 的大小。" << std::endl;
}
}
}
return totalSize;
}
int main() {
fs::path folder = "."; // 当前目录
uintmax_t size = calculate_directory_size(folder);
std::cout << "目录 " << folder << " 及其子目录的总大小: "
<< format_size(size) << std::endl;
return 0;
}
这段代码展示了 std::filesystem 的强大之处。以前实现这个功能需要几百行复杂的平台特定代码，现在只需要几行清晰的逻辑。
—
常见错误与最佳实践
在我们结束之前，让我们总结一下在这一过程中容易踩的坑以及如何避免它们。
#### 1. 忽视异常处理
在使用 INLINECODE361d82ca 时，最常见的新手错误是直接调用而不加 INLINECODE3ef16a78。如果文件正在被另一个进程独占打开，或者你没有读取权限，程序会直接崩溃。最佳实践：始终将文件系统操作包裹在异常处理逻辑中，或者至少在文档中明确说明函数可能抛出的异常。
#### 2. 路径的跨平台问题
硬编码路径分隔符（如使用 INLINECODE35d4a691）会让你的程序在 Linux 或 Mac 上无法运行。最佳实践：使用 INLINECODE1405bdb5 作为分隔符（现代操作系统通常都能识别），或者更好的是使用 INLINECODE5194b455 的拼接操作符 INLINECODE901ca0f1，它会自动处理当前操作系统的分隔符。
// 跨平台路径拼接
fs::path dir = "current_folder";
fs::path file = "data.txt";
fs::path full_path = dir / file; // 自动转换为 "current_folder/data.txt" 或 "current_folder\\data.txt"
#### 3. 符号链接
INLINECODEe2261c60 默认是跟随符号链接的，也就是说它会返回链接指向的真实文件的大小。如果你希望获取链接文件本身的大小，这通常很小，你需要检查 INLINECODE5462fe1f 并进行特殊处理。
#### 4. 性能考量
获取文件大小通常是一个 O(1) 操作，因为操作系统直接从元数据（inode 或 MFT）中读取这个值，而不需要读取文件内容。然而，如果你频繁地在一个循环中调用 INLINECODE0eaa6b0c（例如遍历百万个文件），系统调用的开销就会累积。在这种情况下，使用 INLINECODE609e19eb 并在迭代时一次性获取元数据通常比反复调用 file_size 字符串路径要快。
总结
我们在本文中探讨了多种在 C++ 中获取文件大小的方法。
- 如果你使用的是 C++17 或更高版本，毫无疑问应首选
std::filesystem::file_size()。它不仅安全、类型安全，而且代码简洁，是现代 C++ 开发的标准。 - 如果你受限于 旧版 C++ 标准，使用 C 风格的 INLINECODEc80c7227 和 INLINECODE3700de8d 是最可靠的替代方案，只需注意二进制模式和类型限制。
- 如果你的目标是 计算目录大小 或处理复杂的文件系统结构，
std::filesystem::directory_iterator是你的最佳选择。
掌握这些技术细节，能帮助你在处理文件 I/O 时更加得心应手。希望这篇指南对你有所帮助！