st_nlink字段表示文件所有硬链接总数，Linux/macOS通过stat()获取，Windows不支持；st_nlink==0表示文件已unlink但仍有进程打开。
硬链接计数在 stat 结构体里叫 st_nlink
Linux/macOS 下，文件的硬链接数量直接存于 struct stat 的 st_nlink 字段中，它表示指向该 inode 的目录项（即硬链接）总数。注意：这不是“当前路径是否为硬链接”，而是该文件所有硬链接的总个数——哪怕你只通过一个路径访问，只要该 inode 被多个目录项引用，st_nlink 就 ≥ 2。
常见错误是误以为 st_nlink == 1 表示“没有硬链接”，其实它只说明目前没有其他硬链接；而 st_nlink == 0 通常意味着文件已被 unlink 但仍有进程打开（即“已删除但未释放”状态）。
使用时需注意：
-
stat()和lstat()行为不同：stat()在遇到符号链接时会穿透到目标文件，lstat()则返回符号链接自身的元数据（此时st_nlink恒为 1） - 必须检查
stat()返回值，失败时st_nlink无意义 - Windows 不支持硬链接计数（NTFS 虽支持硬链接，但 Win32 API 不暴露链接数；MinGW 或 WSL 下才可能通过
stat获取）
用 stat() 获取 st_nlink 的最小可行代码
以下 C++ 片段可直接编译运行（POSIX 系统）：
立即学习“C++免费学习笔记（深入）”；
#include <sys/stat.h>
#include <iostream>
#include <string>
<p>int main(int argc, char* argv[]) {
if (argc != 2) return 1;
struct stat sb;
if (stat(argv[1], &sb) == 0) {
std::cout << "hard link count: " << sb.st_nlink << "\n";
} else {
std::perror("stat failed");
}
}关键点：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 不要用
fstat()除非你已有int fd—— 它不接受路径字符串 -
st_nlink是nlink_t类型（通常是unsigned long），直接输出即可，无需类型转换 - 若路径是符号链接且你调用
stat()，得到的是目标文件的st_nlink；想查链接自身，改用lstat()
st_nlink 为 0 意味着什么
当 stat() 成功返回且 sb.st_nlink == 0，说明该文件已被所有目录项移除（即所有硬链接都已被 unlink()），但仍有至少一个进程保持打开句柄。此时文件内容仍在磁盘上，直到最后一个 fd 关闭。
这种状态常见于：
- 日志轮转工具（如 logrotate）先
mv再kill -USR1，旧文件被重命名后 unlink，但服务进程仍往原 fd 写入 - 程序自己调用
unlink()后继续读写已打开的 fd
此时 st_nlink == 0 是合法且可观察的状态，不是错误，也不代表文件损坏。
跨平台兼容性要点
纯标准 C++ 没有获取硬链接计数的接口。真正可用的方式只有：
- Linux / macOS / BSD：用
<sys/stat.h>+stat()→ 读st_nlink - WSL 或 Cygwin：同上，因底层是 POSIX 兼容层
- 原生 Windows（MSVC/MinGW）：
_stat64()可能返回st_nlink，但 Microsoft 文档明确标注该字段“始终为 1”，实际不可靠；应避免依赖
如果你在写跨平台库，建议将硬链接计数设为“仅 Linux/macOS 支持特性”，并在 Windows 上返回 -1 或抛出 std::runtime_error 明确提示不可用。
硬链接本身是文件系统语义，不是语言特性；C++ 只提供对 OS 接口的绑定。别试图绕过 stat 自己解析目录结构——那既不可靠，也破坏抽象层级。
