默认不跟随符号链接且无递归深度限制，需显式启用follow_symlinks()并手动防循环；path.extension()仅返回最后一段后缀，多点名易误判，建议用has_extension()过滤后小写比对；读文件应优先二进制模式配合string_view搜索ASCII关键字。
用 std::filesystem 遍历目录时，递归深度和符号链接怎么处理
默认 std::filesystem::recursive_directory_iterator 会进入子目录，但遇到符号链接（比如 macOS/Linux 的软链接或 Windows 的 junction）会直接跳过——除非显式启用 follow_symlinks()。不加这个，某些项目里常见的 node_modules 或 venv 软链目录就完全搜不到。
更关键的是：它不会限制递归深度，遇到循环软链（A → B → A）会崩溃。C++20 没内置防环机制，得自己记已访问的 std::filesystem::path::native() 或 inode（Linux/macOS 下可用 stat() 提取 st_ino + st_dev 组合判重）。
实操建议：
- 始终用
std::filesystem::recursive_directory_iterator(path, std::filesystem::directory_options::follow_symlinks) - 对每个路径调用
is_regular_file()前先检查is_symlink()，避免重复进入同一物理位置 - 若需限深（比如只搜 3 层），用
iterator.depth()判断，超过立即pop()
匹配后缀名时，path.extension() 返回值容易误判
path.extension() 返回的是最后一个点之后的部分，但像 "archive.tar.gz" 会返回 ".gz"，不是 ".tar.gz"；而 "Makefile" 没点，返回空字符串。直接比对 == ".cpp" 会漏掉 "header.hpp" 这类多点名，也会错杀无扩展名但实际是文本的文件（如 Unix shell 脚本）。
立即学习“C++免费学习笔记（深入）”；
实操建议：
- 用
path.has_extension()先过滤，再取path.extension().string()小写转换后比对（Windows 不区分大小写） - 需要支持多后缀（如
.cc/.cxx/.cpp）就用std::vector<:string>{".cpp", ".cc", ".cxx"}</:string>查找 - 对无扩展名文件，可额外用
std::filesystem::is_regular_file()+ 文件头检测（如读前 128 字节查"#!"或 UTF-8 BOM）决定是否尝试搜索
读取文件内容搜关键字，std::ifstream 默认不支持二进制安全和编码自动识别
直接用 std::ifstream 读文本，遇到 或非 UTF-8 编码（如 GBK、Shift-JIS）会截断或乱码；用 std::ios::binary 又没法直接用 std::string 匹配 Unicode 关键字。C++ 标准库没内置编码转换，硬解 GBK 得调平台 API（Windows MultiByteToWideChar）或引入 ICU/Boost.Locale。
实操建议：
- 优先按二进制读取（
std::ios::binary），然后用std::string_view对原始字节做子串搜索——适合搜 ASCII 关键字（如函数名、宏定义） - 若必须支持中文等宽字符，限定输入为 UTF-8，并用
std::string_view+std::search（Boyer-Moore）避免 O(n×m) 暴力扫 - 跳过二进制文件：检查前 16 字节是否有
0x0D && ），有则直接跳过
多线程搜索时，std::filesystem::directory_iterator 不是线程安全的
std::filesystem 的迭代器对象本身不能被多个线程共享使用，但不同线程各自构造独立的 recursive_directory_iterator 是安全的。真正瓶颈在 I/O：大量线程同时读磁盘会导致寻道抖动，SSD 上反而可能比单线程慢。
实操建议：
- 用单个主线程遍历出所有目标文件路径，存入
std::vector<:filesystem::path></:filesystem::path>，再分块给线程池处理 - 线程数别超
std::thread::hardware_concurrency()，一般设为 CPU 核心数即可 - 每个线程打开文件后立即
close()，避免进程级文件描述符耗尽（尤其搜上万小文件时） - 结果汇总用
std::vector+std::mutex，别用std::cout直接输出——锁粒度太粗，改用局部缓存再批量打印
最麻烦的其实是路径编码和跨平台换行符：Windows 用
，Linux/macOS 用
，搜 "
int main" 在 Windows 文件里会找不到。要么统一转 LF 再搜，要么正则用 "\r?\n" ——但 C++17 的 std::regex 在 GCC 低版本里性能极差，不如手写简单状态机。
