硬链接数表示文件inode被目录项引用的次数，普通文件至少为1，硬链接文件≥2，目录值不可靠；调用时需路径存在可访问且不跟随符号链接，否则抛异常。
硬链接数在 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 <filesystem></filesystem> - 命名空间需启用：C++17 起，部分编译器需显式开启
-std=c++17或更高标准 - Windows 上注意：NTFS 支持硬链接，但需管理员权限创建；
hard_link_count在 Windows 上对常规文件有效，对目录仍返回未定义值
#include <iostream>
#include <filesystem>
<p>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";
}
}</p>常见错误和陷阱
以下情况会直接导致异常或返回无意义结果：
- 路径不存在 → 抛出
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++免费学习笔记（深入）”；
#include <filesystem>
<p>bool 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; }
}</p>这个组合判断比单看 hard_link_count 更可靠，尤其在跨平台或面对 NFS/overlayfs 等复杂文件系统时。
