1. 概览与核心概念
1.1 文件系统 API 的选择
在进行 C++ 的目录遍历时，选择合适的 文件系统 API 是关键第一步。针对“C++ 如何获取文件夹下的所有文件名？文件系统操作与目录遍历技巧全解”的场景，跨平台的 std::filesystem 提供了一致的接口，显著简化了实现复杂度。
核心要点包括 目录遍历、路径处理、错误处理 与 性能考量，这些都直接决定了能否高效、鲁棒地获取文件名列表。
为实现高可维护性与可移植性，优先考虑在支持 C++17 及以上标准的编译器上使用 std::filesystem，并结合 directory_iterator 与 recursive_directory_iterator 的不同场景进行组合。
2. 标准库实现：使用 std::filesystem
2.1 基本用法
std::filesystem 提供了两种遍历方式：directory_iterator（仅遍历顶层）和 recursive_directory_iterator（递归遍历子目录）。
通过 path 指定目标目录，随后可以在循环中获得 entry.path() 并通过 entry.path().filename() 获取文件名部分。
处理过程中应注意 异常处理，避免因为权限不足、目录不存在等情况导致程序崩溃。
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;int main() {fs::path dir = "/path/to/dir";try {for (const auto &entry : fs::directory_iterator(dir)) {std::cout << entry.path().filename().string() << std::endl;}} catch (const fs::filesystem_error &e) {std::cerr << "Error: " << e.what() << std::endl;}return 0;
}
以上示例展示了如何获取指定目录下的所有直接子项的 文件名，并且不包含子目录中的内容。
2.2 递归遍历获取全部文件名
若需要获取目录树中所有文件的名称，则应采用 recursive_directory_iterator，并结合 entry.is_regular_file() 进行筛选。
遍历时可以逐层筛选出 文件类型，从而只保留 普通文件、符号链接 或根据需要的其他类型。
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;int main() {fs::path dir = "/path/to/dir";try {for (const auto &entry : fs::recursive_directory_iterator(dir)) {if (entry.is_regular_file()) {std::cout << entry.path().string() << std::endl;}}} catch (const fs::filesystem_error &e) {std::cerr << "Error: " << e.what() << std::endl;}return 0;
}
通过上述代码，递归遍历能够完整输出目录树中所有普通文件的路径，便于后续筛选、排序或批处理。
3. 跨平台遍历技巧与兼容性
3.1 Windows 与 POSIX 的差异
使用 std::filesystem 可以实现跨平台的目录遍历，但在旧版本编译器上仍可能遇到兼容性问题。GCC 的早期实现需要链接组件 stdc++fs，而 MSVC 则通常已内置支持。
在 POSIX 系统中，尽管 opendir/readdir 等底层接口可直接实现遍历，统一的 std::filesystem 接口仍具备更好的可维护性和错误处理统一性。
要点是确保编译器开通了对 C++17（或更高）标准的支持，并在构建系统中正确链接标准库组件，以避免运行时的缺失符号或行为不一致。
3.2 处理错误与异常
在实际应用中，遍历目录时常会遇到不可访问的目录、权限限制、损坏的文件系统等情况。使用 try-catch 捕获 fs::filesystem_error 能显著提升鲁棒性。
错误码 与 错误信息 可以帮助快速定位问题来源，如权限不足、路径不存在、无效路径等。
4. 目录遍历的进阶技巧
4.1 过滤、排序与性能
在获得文件名列表时，往往需要对结果进行过滤与排序，以满足应用场景。可通过以下思路实现：提前过滤，减少不必要的对象创建；按需排序，避免无谓的全量排序；以及对 内存分配 进行最小化。
常见过滤条件包括扩展名、隐藏文件排除、符号链接处理等。示例：仅列出指定扩展名的文件、排除以点开头的隐藏文件、或只统计顶层目录的文件等。
若要提高性能，可在遍历中积累 文件路径集合，并在遍历结束后执行一次排序。避免在遍历循环中频繁进行 内存分配，可以先用 reserve() 预分配容量。
#include <iostream>
#include <filesystem>
#include <vector>
#include <algorithm>
namespace fs = std::filesystem;int main() {fs::path dir = "/path/to/dir";std::vector names;try {for (const auto &entry : fs::directory_iterator(dir)) {auto p = entry.path();if (p.extension() == ".txt" && entry.is_regular_file()) {names.push_back(p.filename().string());}}std::sort(names.begin(), names.end());for (const auto &n : names) {std::cout << n << std::endl;}} catch (const fs::filesystem_error &e) {std::cerr << "Error: " << e.what() << std::endl;}return 0;
}
以上示例展示了如何在遍历过程中进行初步过滤、收集文件名并最终排序输出，达到对特定类型文件的快速定位需求。
5. 示例项目：获取文件名列表的完整实现
5.1 最小可运行示例（非递归版本）
下面的代码给出一个简洁的最小实现，用于获取指定目录下的所有文件名（仅顶级，不进入子目录）。可直接编译运行以验证行为。
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;int main() {fs::path dir = "/path/to/dir";try {for (const auto &entry : fs::directory_iterator(dir)) {if (entry.is_regular_file()) {std::cout << entry.path().filename().string() << std::endl;}}} catch (const fs::filesystem_error &e) {std::cerr << "Error: " << e.what() << std::endl;}return 0;
}
5.2 递归遍历的完整示例（带错误处理）
下面的示例结合了错误处理、递归遍历和文件名输出，适合在实际项目中直接作为工具使用。
#include <iostream>
#include <filesystem>
namespace fs = std::filesystem;int main() {fs::path dir = "/path/to/dir";try {for (const auto &entry : fs::recursive_directory_iterator(dir)) {if (entry.is_regular_file()) {std::cout << entry.path().string() << std::endl;}}} catch (const fs::filesystem_error &e) {std::cerr << "Error: " << e.what() << std::endl;}return 0;
}
通过以上完整实现，可以在不同场景下灵活使用：仅列出顶层文件名，或全面遍历整个目录树并收集需要的文件信息。
本篇内容聚焦于 C++ 如何获取文件夹下的所有文件名，以及在文件系统操作与目录遍历方面的技巧全解。因此，读者在实现过程中应结合具体需求，选择最合适的遍历方式、错误处理策略和性能优化点，确保代码既简洁又健壮。
