Go os.Stat跟随符号链接导致文件类型判断偏差的处理方案

如果路径可能是符号链接，os.Stat 和 os.Lstat 不能随意替换。os.Stat 会跟随链接，返回目标文件或目录的 FileInfo；os.Lstat 观察的是链接自身。文件扫描把链接误判成普通文件，通常就是这里的对象边界选错了。

Stat 和 Lstat 观察的是两个不同对象

假设 current.json 是指向 releases/v2/config.json 的符号链接。程序要“读取当前配置”时，关心的是目标文件；程序要“清理失效链接”时，关心的却是链接入口。两种需求都传入同一个路径，但判断对象并不相同。

最小写法如下，代码里的中文注释只说明关键分支，避免把两个 API 混成一个“文件类型检测函数”。

package main

import (
	"fmt"
	"os"
)

func main() {
	path := "current.json"

	// Stat 追踪符号链接，适合判断最终要读取的目标类型。
	statInfo, err := os.Stat(path)
	if err != nil {
		fmt.Println("stat failed:", err)
		return
	}

	// Lstat 不追踪链接，适合审计或清理路径本身。
	lstatInfo, err := os.Lstat(path)
	if err != nil {
		fmt.Println("lstat failed:", err)
		return
	}

	fmt.Println("target is directory:", statInfo.IsDir())
	fmt.Println("path is symlink:", lstatInfo.Mode()&os.ModeSymlink != 0)
}

按任务选择 API，再解释 FileMode

FileInfo.IsDir() 只适合回答“当前返回对象是不是目录”。如果返回值来自 os.Stat，它回答的是目标对象；如果来自 os.Lstat，它回答的是链接自身。判断链接时应明确使用 ModeSymlink，不要从文件名后缀推断。

断链是最容易漏掉的边界：os.Lstat 仍可能成功，因为链接入口存在；随后 os.Stat 可能返回错误，因为目标不存在。这个差异正好能用于清理工具的判断。

把判断规则放进目录扫描

目录扫描不要先用一个通用的“是不是目录”函数包住所有场景。先声明本次扫描要观察入口还是目标，再把错误和类型判断放在同一处，后面的业务分支才不会误用结果。

func classify(path string, followTarget bool) (string, error) {
	var (
		info os.FileInfo
		err  error
	)
	if followTarget {
		// 读取业务对象时跟随链接，但断链必须返回错误。
		info, err = os.Stat(path)
	} else {
		// 清理或审计入口时保留链接本身的类型。
		info, err = os.Lstat(path)
	}
	if err != nil {
		return "unknown", err
	}
	if info.Mode()&os.ModeSymlink != 0 {
		return "symlink", nil
	}
	if info.IsDir() {
		return "directory", nil
	}
	return "regular-or-other", nil
}

常见误判和处理边界

第一，不要用 os.Stat(path) 成功就断言“路径不是链接”，它只能说明跟随后的目标可被观察。第二，不要把 os.Lstat 成功等同于“目标可读”。第三，错误判断优先使用 errors.Is(err, fs.ErrNotExist) 等方式，避免仅比较错误字符串。Windows 的 reparse point 也有平台差异，跨平台工具应把“入口类型”和“目标类型”分成两个字段。

相关问题

只想读取配置内容，应该用 Stat 还是 Lstat？

用 os.Stat，因为读取目标通常关心最终文件；如果还要记录入口是不是链接，再额外调用 os.Lstat。

为什么 Lstat 成功但 Stat 失败？

常见原因是断链：链接路径本身存在，所以 Lstat 成功；它指向的目标不存在或不可达，所以 Stat 失败。

ModeSymlink 能否直接判断所有平台的链接？

它是 Go 的可移植文件模式位，但底层文件系统对 reparse point 的呈现可能不同。跨平台程序应同时记录错误和平台行为，不要只依赖文件名或后缀。