本文介绍如何通过系统调用获取文件的 inode 和硬链接计数（st_nlink），从而准确判断某路径是否指向一个存在多个硬链接的文件——即该文件“是硬链接”的实质含义。核心在于使用 os.Lstat 结合 syscall.Stat_t 解析底层 stat 信息。
本文介绍如何通过系统调用获取文件的 inode 和硬链接计数（`st_nlink`），从而准确判断某路径是否指向一个存在多个硬链接的文件——即该文件“是硬链接”的实质含义。核心在于使用 `os.lstat` 结合 `syscall.stat_t` 解析底层 stat 信息。
在 Go 中，os.FileMode 仅提供 os.ModeSymlink 用于识别符号链接，但不提供任何直接标志来标识硬链接。这是因为硬链接在文件系统层面并非一种独立的“文件类型”，而是多个目录项（dirent）指向同一 inode 的现象。因此，“一个文件是否是硬链接”这一问题的准确理解应为：该文件所关联的 inode 是否被多个目录项引用（即 st_nlink > 1）。
要实现该判断，必须访问底层系统调用返回的 stat 结构体，从中提取 st_ino（inode 编号）和 st_nlink（硬链接计数）。Go 标准库中 os.FileInfo.Sys() 方法可返回平台相关的原始 stat 结构体，Unix 系统下通常为 *syscall.Stat_t（或 *unix.Stat_t，推荐使用 golang.org/x/sys/unix 以获得更好跨平台支持和维护性）。
以下是一个完整、健壮的判断示例：
package main
import (
"errors"
"fmt"
"log"
"os"
"syscall"
"golang.org/x/sys/unix" // 更现代、更安全的替代方案
)
func isHardLink(filename string) (bool, error) {
fi, err := os.Lstat(filename)
if err != nil {
return false, err
}
// 获取底层 stat 结构体（Unix 平台）
stat, ok := fi.Sys().(*unix.Stat_t)
if !ok {
return false, errors.New("failed to cast FileInfo.Sys() to *unix.Stat_t")
}
// 检查是否为符号链接（硬链接判断前必须排除 symlink）
if fi.Mode()&os.ModeSymlink != 0 {
return false, nil // 符号链接不是硬链接
}
// 关键判断：硬链接计数大于 1 表示该 inode 至少有两个硬链接
return stat.Nlink > 1, nil
}
func main() {
if len(os.Args) < 2 {
log.Fatal("usage: program <filepath>")
}
filename := os.Args[1]
isHL, err := isHardLink(filename)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%q is a hard link: %t\n", filename, isHL)
}✅ 关键点说明：
- 必须使用 os.Lstat()（而非 os.Stat()），否则对符号链接会返回其目标文件的 stat 信息，导致误判。
- fi.Mode()&os.ModeSymlink != 0 用于提前过滤符号链接，避免混淆。
- stat.Nlink > 1 是唯一可靠的硬链接存在性指标：值为 1 表示该路径是该 inode 的唯一引用；大于 1 则表明至少还存在一个其他路径（即另一个硬链接）指向同一 inode。
- 推荐使用 golang.org/x/sys/unix 替代 syscall，因其 API 更稳定、文档更完善，且持续适配新版内核与系统调用。
在实际工程场景中（如构建 tar 归档），此判断可直接用于设置 tar.Header.Typeflag：
if isHL, _ := isHardLink(path); isHL {
hdr.Typeflag = tar.TypeLink
hdr.Linkname = resolveTargetPath(path) // 需额外实现：获取该硬链接指向的“主路径”或任意其他硬链接路径
} else if fi.Mode().IsRegular() {
hdr.Typeflag = tar.TypeReg
}⚠️ 注意事项：
- 硬链接仅在同一文件系统内有效，跨设备（如不同挂载点）无法创建硬链接，因此该方法天然不适用于跨设备路径比较。
- Nlink 值由内核维护，对普通用户只读；修改它需 root 权限且极其危险，不应尝试。
- Windows 不支持 POSIX 硬链接（仅支持 NTFS junctions/symbolic links），此方法在 Windows 上不可用；若需跨平台，应结合 runtime.GOOS 做条件编译或降级处理（例如统一视为非硬链接）。
综上，判断硬链接的本质是检查 inode 的链接计数，而非识别某种“文件模式”。通过 os.Lstat() + unix.Stat_t 组合，即可在 Go 中精准、高效地完成这一任务，为归档、同步、去重等系统编程场景提供坚实基础。
