在Go语言的实际开发中，判断指定路径的文件是否存在是基础且高频的需求，比如读取配置文件前先校验文件是否存在、写入文件前检查目标路径是否已有同名文件等场景都会用到。Go的标准库os包提供了对应的方法，不需要引入第三方依赖就能实现这个功能。
核心判断方法：os.Stat配合os.IsNotExist
Go中判断文件是否存在的标准做法是调用os.Stat函数获取文件信息，再通过os.IsNotExist函数判断返回的错误是否为文件不存在的错误类型。
os.Stat函数的作用是获取指定路径的文件或目录的元信息，函数签名如下：
func Stat(name string) (FileInfo, error)
当传入的路径对应的文件或目录存在时，函数会返回对应的FileInfo对象和nil错误；如果文件或目录不存在，会返回一个错误，这个错误可以通过os.IsNotExist函数判断是否为不存在类型的错误。
os.IsNotExist的函数签名如下：
func IsNotExist(err error) bool
如果传入的错误是文件或目录不存在的错误，返回true，否则返回false。
基础判断示例
下面是一个判断文件是否存在的完整示例代码：
package main
import (
"fmt"
"os"
)
// 判断文件是否存在的函数
func IsFileExist(filePath string) bool {
// 调用os.Stat获取文件信息
_, err := os.Stat(filePath)
if err == nil {
// 没有错误，说明文件存在
return true
}
// 判断错误是否为文件不存在的错误
if os.IsNotExist(err) {
return false
}
// 其他错误，比如权限不足，这里可以根据需求处理，默认返回false
return false
}
func main() {
filePath := "./test.txt"
if IsFileExist(filePath) {
fmt.Printf("文件 %s 存在n", filePath)
} else {
fmt.Printf("文件 %s 不存在n", filePath)
}
}
区分文件和目录的存在性
上面的方法会同时判断文件和目录是否存在，如果需要明确判断的是文件还是目录，可以结合FileInfo的IsDir方法做进一步校验。
package main
import (
"fmt"
"os"
)
// 判断是否为存在的普通文件
func IsRegularFileExist(filePath string) bool {
info, err := os.Stat(filePath)
if err != nil {
// 文件不存在或者获取信息出错
return false
}
// 判断是否为普通文件，排除目录的情况
return !info.IsDir()
}
// 判断是否为存在的目录
func IsDirExist(dirPath string) bool {
info, err := os.Stat(dirPath)
if err != nil {
return false
}
// 判断是否为目录
return info.IsDir()
}
func main() {
filePath := "./test.txt"
dirPath := "./test_dir"
if IsRegularFileExist(filePath) {
fmt.Printf("%s 是存在的普通文件n", filePath)
}
if IsDirExist(dirPath) {
fmt.Printf("%s 是存在的目录n", dirPath)
}
}
常见错误写法及避坑
很多开发者刚接触Go时会写出下面这种错误判断逻辑：
// 错误示例：直接判断err不为nil就认为文件不存在
func WrongIsExist(filePath string) bool {
_, err := os.Stat(filePath)
// 错误：err不为nil可能是权限不足、路径非法等其他错误，不一定是文件不存在
return err == nil
}
这种写法的核心问题是，os.Stat返回的错误不一定是文件不存在的错误，比如当前进程没有权限访问该路径时，也会返回错误，这时候直接认为文件不存在是不准确的。因此必须配合os.IsNotExist做错误类型判断，才能准确识别文件不存在的场景。
不同场景的使用建议
- 如果只需要判断路径是否存在，不区分是文件还是目录，直接用
os.Stat配合os.IsNotExist即可。 - 如果需要明确判断是普通文件存在，需要额外校验
FileInfo的IsDir返回值。 - 如果判断文件不存在后需要创建文件，可以直接调用
os.OpenFile并指定对应的标志位，不需要先判断再创建，避免竞态条件。
比如下面的代码是判断文件不存在时创建文件的正确写法，避免了先判断再创建过程中其他进程提前创建文件的竞态问题：
package main
import (
"fmt"
"os"
)
func main() {
filePath := "./new_file.txt"
// 以只写、创建、追加模式打开文件，文件不存在时自动创建
f, err := os.OpenFile(filePath, os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644)
if err != nil {
fmt.Printf("打开文件失败：%vn", err)
return
}
defer f.Close()
fmt.Println("文件打开或创建成功")
}
Go文件存在性判断os_Statos_IsNotExist文件操作修改时间：2026-07-16 16:51:31