在 Go 中无法通过 os.FileMode 直接识别硬链接，但可通过系统调用获取 inode 及其硬链接计数（st_nlink），当 nlink > 1 且非符号链接时，即可确认该路径是某个文件的硬链接之一。
在 go 中无法通过 `os.filemode` 直接识别硬链接，但可通过系统调用获取 inode 及其硬链接计数（`st_nlink`），当 `nlink > 1` 且非符号链接时，即可确认该路径是某个文件的硬链接之一。
硬链接（hard link）是 Unix/Linux 文件系统中指向同一 inode 的多个目录项。与符号链接（symlink）不同，硬链接没有独立的文件元数据，因此 Go 标准库的 os.FileMode 不提供专属标志位——它仅通过 os.ModeSymlink 区分符号链接，而硬链接在模式上与普通文件完全一致（-rw-r--r-- 等）。要准确判断某路径是否为硬链接，关键在于：检查其关联 inode 的硬链接总数（st_nlink）是否大于 1，同时排除符号链接干扰。
实现这一判断需借助底层系统调用结构体。Go 的 os.FileInfo.Sys() 方法返回平台相关接口，Unix 系统下通常为 *syscall.Stat_t（或更推荐的 *unix.Stat_t），其中包含 Ino（inode 编号）和 Nlink（硬链接计数）字段：
package main
import (
"errors"
"fmt"
"log"
"os"
"syscall"
)
func isHardLink(name string) (bool, error) {
fi, err := os.Lstat(name) // 必须用 Lstat，避免跟随 symlink
if err != nil {
return false, err
}
// 检查是否为符号链接（硬链接判断前必须排除）
if fi.Mode()&os.ModeSymlink != 0 {
return false, nil // 符号链接不是硬链接
}
// 提取 syscall.Stat_t 结构体
stat, ok := fi.Sys().(*syscall.Stat_t)
if !ok {
return false, errors.New("failed to assert FileInfo.Sys() to *syscall.Stat_t")
}
// nlink > 1 表示该 inode 被多个目录项引用 → 当前路径是硬链接之一
return stat.Nlink > 1, nil
}
func main() {
if len(os.Args) < 2 {
log.Fatal("usage: program <file-path>")
}
name := os.Args[1]
hardlink, err := isHardLink(name)
if err != nil {
log.Fatal(err)
}
fi, _ := os.Lstat(name)
stat, _ := fi.Sys().(*syscall.Stat_t)
inode := stat.Ino
if hardlink {
fmt.Printf("%q is a hard link (inode %d, %d total links)\n", name, inode, stat.Nlink)
} else {
fmt.Printf("%q is not a hard link (inode %d, %d total links)\n", name, inode, stat.Nlink)
}
}✅ 关键要点说明：
- 必须使用 os.Lstat()：防止符号链接被自动解析，确保获取的是路径自身的元数据。
- 先排除符号链接：fi.Mode() & os.ModeSymlink != 0 是必要前置检查，否则 os.Readlink() 可能误触发，且符号链接的 Nlink 无意义。
- Nlink > 1 是硬链接存在的充要条件：每个硬链接都会使 inode 的链接计数加 1；若为 1，说明该路径是该文件唯一的目录项引用（即“原始”文件，但从技术上讲，所有硬链接地位平等）。
- 跨文件系统限制：硬链接只能在同一文件系统内创建，因此该方法天然不适用于跨设备路径（os.Stat 会失败或返回不同设备 ID，可额外校验 stat.Dev 一致性）。
该逻辑在构建归档工具（如 tar）时尤为关键。例如使用 archive/tar 包时，需为硬链接设置 Header.Typeflag = tar.TypeLink 并填充 Header.Linkname 字段（指向第一个被归档的同 inode 文件路径），而非当作普通文件（tar.TypeReg）重复写入内容——这正是问题中提到的 filepath.Walk() 场景的核心需求。正确识别硬链接不仅能节省存储空间，还能保证解压后语义一致性。
注意：此方案依赖于 Unix 系统调用，在 Windows 上不可用（NTFS 硬链接需通过 syscall.CreateHardLink 创建，且 Go 标准库未暴露等效的 nlink 查询机制）。生产环境建议封装为 build tags 条件编译，或使用跨平台库如 golang.org/x/sys/unix 替代 syscall（后者已弃用）。
