硬链接仅限同一文件系统且不能指向目录,软链接路径按字面量存储需注意相对性;二者均不自动创建父目录,判断软链接须用os.Lstat,跨平台使用需校验设备一致性与路径存在性。

硬链接只能在同一文件系统内创建
Go 的 os.Link 本质调用的是系统 link(2) 系统调用,它不支持跨分区或跨挂载点。如果你尝试对位于不同磁盘、不同 mount point 的两个路径调用 os.Link,会直接返回 invalid cross-device link 错误。
实操建议:
- 创建前先用
os.Stat检查源文件和目标路径所在设备的Stat.Sys().(*syscall.Stat_t).Dev是否一致(需 importsyscall) - 若只是想“复制文件内容”,别硬扛硬链接,改用
io.Copy+os.Create - 硬链接无法指向目录(Linux 内核禁止),
os.Link对目录永远返回operation not permitted
软链接路径是相对还是绝对,取决于你传进去的字符串
os.Symlink 第一个参数是 link 指向的目标路径,第二个是 symlink 自身的路径。它不做任何路径解析 —— 你传什么,就写进 inode 的 link 字段里什么。
常见错误现象:
立即学习“go语言免费学习笔记(深入)”;
- 在 /tmp 下执行
os.Symlink("a.txt", "b.ln"),生成的软链接内容就是字面量a.txt;如果之后把b.ln移到别的目录,它就失效了 - 想让软链接稳定,通常应传入绝对路径:比如
os.Symlink("/home/user/data.log", "/tmp/log.ln") - Windows 上
os.Symlink需要管理员权限,且仅对 NTFS 有效;普通用户默认会遇到operation not supported
os.Link 和 os.Symlink 都不自动创建父目录
这两个函数只负责创建链接本身,不会帮你 mkdir -p 目标路径的上级目录。一旦目标路径的父目录不存在,就会报 no such file or directory。
使用场景中容易忽略这点:
- 你想在
/var/log/app/2024/06/下建软链接,但2024或06目录还不存在 - 硬链接目标路径含多级目录,而你只确保了源文件存在
- 解决办法统一:调用前先用
os.MkdirAll(filepath.Dir(destPath), 0755)
检查链接类型得靠 os.Lstat 而不是 os.Stat
os.Stat 会自动跟随软链接,返回目标文件的信息;想判断一个路径本身是不是软链接,必须用 os.Lstat,再检查 fi.Mode()&os.ModeSymlink != 0。
硬链接没这种“类型标识”——所有硬链接和原文件共享同一个 inode,os.Lstat 返回的 Mode() 完全一样,无法区分谁是“原始”谁是“链接”。唯一能间接确认的方式是看 fi.Sys().(*syscall.Stat_t).Nlink 是否大于 1。
性能与兼容性提醒:
- 频繁调用
os.Lstat判断软链接,在高并发小文件场景下可能成为瓶颈 - 某些容器环境(如 rootless Podman)或只读文件系统上,
os.Lstat可能返回权限错误,而非预期的os.ModeSymlink标志










