硬链接数在 C++ 中的实际含义
硬链接数（hard_link_count）不是“当前路径有多少个硬链接”，而是该文件的 inode 被多少个目录项（directory entry）引用。对普通文件，它至少为 1；对有硬链接的文件，这个值 ≥2；对目录，Linux 下该值通常等于子目录数 + 2（`.` 和父目录中的 `..` 条目），但 std::filesystem::hard_link_count **不保证返回目录的准确值** —— 标准明确说明：对目录，此函数可能返回 0 或任意未指定值。
如何正确调用 std::filesystem::hard_link_count
必须传入一个指向**存在且可访问的文件路径**（不能是 dangling symlink，也不能是权限不足的路径），否则抛出 std::filesystem::filesystem_error。该函数不跟随符号链接，只作用于目标文件本身的 inode。
- 需包含头文件：
#include - 命名空间需启用：C++17 起，部分编译器需显式开启
-std=c++17或更高标准 - Windows 上注意：NTFS 支持硬链接，但需管理员权限创建；
hard_link_count在 Windows 上对常规文件有效，对目录仍返回未定义值
#include#include int main() { try { auto count = std::filesystem::hard_link_count("test.txt"); std::cout << "Hard link count: " << count << "\n"; } catch (const std::filesystem::filesystem_error& e) { std::cerr << "Error: " << e.what() << "\n"; } }
常见错误和陷阱
以下情况会直接导致异常或返回无意义结果：
- 路径不存在 → 抛出
std::filesystem::filesystem_error（error codestd::errc::no_such_file_or_directory） - 路径是悬空符号链接（dangling symlink）→ 同样报
no_such_file_or_directory，因为底层 stat 失败 - 路径指向目录 → 返回值不可靠；GCC libstdc++ 返回
0，MSVC STL 返回1，Clang libc++ 行为未定义 —— 切勿依赖 - 权限不足（如只读挂载、ACL 限制）→ 可能触发
std::errc::permission_denied - 传入相对路径但工作目录已变更 → 结果取决于运行时环境，建议用
std::filesystem::absolute()预处理
验证硬链接是否真实存在
hard_link_count 值大于 1 是硬链接存在的必要条件，但不是充分条件（某些文件系统或特殊设备可能伪造该字段）。真正确认两个路径是否指向同一 inode，应比较 std::filesystem::status(p).dev() + std::filesystem::status(p).ino()：
立即学习“C++免费学习笔记（深入）”；
#includebool is_same_inode(const std::filesystem::path& a, const std::filesystem::path& b) { try { auto sa = std::filesystem::status(a); auto sb = std::filesystem::status(b); return sa.type() == sb.type() && sa.permissions() == sb.permissions() && sa.dev() == sb.dev() && sa.ino() == sb.ino(); } catch (...) { return false; } }
这个组合判断比单看 hard_link_count 更可靠，尤其在跨平台或面对 NFS/overlayfs 等复杂文件系统时。
