Go os.SameFile 为什么要求使用 os.Stat 的结果

如果代码需要判断两个路径是不是同一个文件，不能直接比较路径字符串，也不能把任意来源的 FileInfo 都交给 os.SameFile。Go 官方文档明确说明：os.SameFile 只适用于 os.Stat 返回的结果；在 Unix 上通常依据设备号和 inode 判断，其他系统可能依据路径等平台信息判断。

官方资料：https://pkg.go.dev/os#SameFile

结论：要比较两个路径对应的目标文件，先分别调用 os.Stat，确认两个调用都成功，再把得到的两个 FileInfo 传给 os.SameFile。如果你想比较符号链接本身，就不能把 os.Lstat 的结果直接当作 SameFile 的输入，而要先明确自己的身份模型。

SameFile 比较的是文件身份，不是路径写法

"./data/config.json" 和 "data/../data/config.json" 是两种字符串写法，但它们可能指向同一个文件。反过来，两个字符串看起来很接近，也可能因为符号链接、挂载点或大小写规则而指向不同对象。

os.SameFile 的输入类型是两个 os.FileInfo。它比较的是这些信息所描述的文件身份：在 Unix 系统上，可以理解为设备号与 inode 的组合；具体实现仍由平台决定。因此，比较逻辑应该放在“取得文件信息”之后，而不是先对路径做字符串猜测。

标准写法：两个 Stat 成功后再比较

最小实现应先分别调用 os.Stat，任何一次失败都直接返回错误。不要在错误信息被忽略的情况下把可能为 nil 的结果继续传入比较函数，也不要用 os.FileInfo.Name() 代替身份比较。

package main

import (
	"fmt"
	"os"
)

// sameTargetFile 比较两个路径解析到的目标文件身份。
func sameTargetFile(leftPath, rightPath string) (bool, error) {
	// Stat 会跟随符号链接，得到目标文件的 FileInfo。
	leftInfo, err := os.Stat(leftPath)
	if err != nil {
		return false, fmt.Errorf("stat 左路径 %q: %w", leftPath, err)
	}

	// 分开处理第二个路径，保留它自己的错误上下文。
	rightInfo, err := os.Stat(rightPath)
	if err != nil {
		return false, fmt.Errorf("stat 右路径 %q: %w", rightPath, err)
	}

	// 两个结果都来自 Stat 后，才交给 SameFile 判断文件身份。
	return os.SameFile(leftInfo, rightInfo), nil
}

func main() {
	same, err := sameTargetFile("data/current.json", "data/active.json")
	if err != nil {
		fmt.Println("无法比较文件：", err)
		return
	}
	fmt.Println("是否同一目标文件：", same)
}

这个函数把三个判断分开：路径能否取得信息、信息是否来自合适的 API、两个信息是否描述同一个目标。这样的边界比先清理字符串再比较更可靠，也能把“文件不存在”和“文件存在但不是同一个”区分开。

Stat 和 Lstat 的差别决定你比较谁

符号链接是最容易误判的场景。os.Stat 会跟随链接并返回目标文件的信息；os.Lstat 则返回链接自身的信息。两者解决的是不同问题：前者回答“这些路径最终打开的是不是同一个目标”，后者回答“这个目录项是不是一个符号链接，以及链接自身的元数据是什么”。

func describePath(path string, followLink bool) (os.FileInfo, error) {
	if followLink {
		// 需要比较最终目标时，使用 Stat 跟随符号链接。
		return os.Stat(path)
	}

	// 只研究链接目录项时，使用 Lstat 保留链接自身。
	return os.Lstat(path)
}

如果业务目标是判断两个别名是否最终落到同一份配置文件，两个路径都用 Stat；如果目标是发现某个目录项是否被替换成符号链接，就应该使用 Lstat 并根据 ModeSymlink 等信息自行做目录项判断。不要把“想比较链接自身”写成调用 SameFile，这会让代码意图和官方契约不一致。

错误处理和代码审查清单

实际项目中，文件身份比较通常发生在缓存去重、配置别名、备份清单或目录扫描中。建议按下面的顺序审查：

• 两个路径是否都经过了 os.Stat，并且每个错误都被处理？
• 需求比较的是最终目标，还是符号链接自身？如果是后者，是否应改用 Lstat 加类型判断？
• 是否误用了 Name()、清理后的路径字符串或绝对路径字符串来代替文件身份？
• 是否把来自虚拟文件系统、测试桩或其他实现的 FileInfo 当成 SameFile 的输入？官方文档对输入来源有限制。
• 路径不存在、权限不足、跨文件系统和符号链接断裂时，调用方是否能区分错误与“不是同一文件”？

速记：比较目标文件用“两个 Stat + SameFile”；观察链接目录项用“Lstat + 类型判断”；比较路径写法才使用字符串。把这三层语义分开，文件去重和别名判断就不会因为路径表面相似而误报。

相关问题

为什么不能直接比较两个 FileInfo 的 Name？Name 只是目录项名称，不包含设备号、inode 或平台对应的身份信息。

os.Stat 找不到路径时能否当作不是同一个文件？如果业务只需要布尔结果可以转换，但更推荐保留并上抛原始错误，因为“不存在”和“没有权限”是不同故障。

两个硬链接能否被 SameFile 识别为同一文件？在支持设备号和 inode 的平台上，两个硬链接通常会得到相同的文件身份；具体行为仍应以目标平台的 FileInfo 实现为准。