c++中如何使用std::filesystem::hard_link_count_c++获取硬链接数【实例】

硬链接数在 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 code std::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()：

千问APP

阿里最强大模型官方AI助手

下载

立即学习“C++免费学习笔记（深入）”；

#include 
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; }
}

这个组合判断比单看 hard_link_count 更可靠，尤其在跨平台或面对 NFS/overlayfs 等复杂文件系统时。