os.Symlink失败主因是文件系统不支持符号链接（如FAT32/exFAT、Windows非管理员终端、Docker overlay2禁用nosymfollow）；os.Link失败必因跨设备（不同文件系统），硬链接不可跨分区、不可指向目录或不存在文件；判断符号链接须用os.Lstat而非os.Stat。
os.Symlink 创建符号链接失败的常见原因
调用 os.Symlink 报 operation not permitted 或 permission denied，大概率不是权限不够，而是目标路径所在文件系统不支持符号链接（比如某些 FAT32 / exFAT 移动盘、Windows 的非管理员 CMD/PowerShell、Docker 默认 overlay2 挂载为 noexec/nosymfollow）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Linux/macOS 下优先检查挂载选项：
mount | grep $(df . | tail -1 | awk '{print $1}')，确认含symfollow（或无nosymfollow） - Windows 上必须以管理员身份运行终端，且目标卷需为 NTFS；WSL2 内默认支持，但挂载 Windows 盘（如
/mnt/c）时符号链接被禁用 -
os.Symlink(oldname, newname)中oldname是链接“指向的内容”，可以不存在、可以是相对路径——但它是相对于newname所在目录解析的，不是当前工作目录 - 避免用绝对路径拼接：比如
os.Symlink("/tmp/foo", "/usr/local/bin/bar")在大多数系统上能成功，但若/usr/local/bin是 bind mount 或跨文件系统，可能静默失败
os.Link 创建硬链接总返回 “invalid cross-device link”
os.Link 本质是系统调用 link(2)，它要求源文件和目标路径必须在同一个文件系统（即同一 mount point）。跨分区、跨磁盘、容器中挂载的不同 volume，都会触发这个错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
stat -c "%d" file（Linux）或stat -f "%H" file（macOS）比对源和目标父目录的 device ID，不一致就不可能成功 - 硬链接不能指向目录（内核禁止），也不能跨文件系统，更不能指向不存在的路径——
os.Link要求oldname必须是已存在的普通文件 - 不要试图用硬链接“替代”复制：它共享 inode，删源文件不影响链接，但改内容会同步体现——这在多进程写入场景下极易引发竞态，不是安全的共享机制
- 如果目标是“让两个路径访问同一份数据”，且允许跨设备，应改用符号链接或应用层抽象（如统一读取配置中心路径）
区分 symlink 和 hardlink：从 os.Stat 结果看本质差异
仅靠 os.Stat 返回的 os.FileInfo，无法直接判断一个路径是否为符号链接——因为默认会自动跟随。必须显式用 os.Lstat。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
fi, err := os.Lstat(path)才能拿到链接本身的信息；若fi.Mode()&os.ModeSymlink != 0，说明这是个符号链接 - 硬链接没有独立元数据：所有硬链接共享同一
inode和os.FileInfo，os.Lstat和os.Stat对它们返回完全相同的Size()、ModTime()、Mode() - 符号链接的
Size()返回的是路径字符串长度（比如../lib/a.so是 12），不是它指向文件的大小 - 别依赖
os.IsNotExist(err)判断符号链接是否“坏”：os.Stat遇到悬空链接会返回no such file or directory，但os.Lstat总能成功（只要链接文件自身存在）
在容器或 CI 环境中安全使用链接的底线做法
CI 平台（GitHub Actions、GitLab Runner）、容器镜像（Alpine、distroless）常禁用符号链接或限制硬链接能力。盲目调用 os.Symlink/os.Link 容易导致构建失败或行为不一致。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先用
os.Readlink检查目标是否存在可读符号链接，再决定是否创建；创建前先os.RemoveAll(newname)，避免file exists错误 - 硬链接场景下，若
os.Link返回invalid cross-device link，应 fallback 到io.Copy+os.Chmod模拟（注意保持 uid/gid 需额外处理） - Dockerfile 中避免
RUN ln -s，改用构建时COPY --link（BuildKit 支持）或启动时脚本检测生成 - Alpine 容器默认用 musl libc，
os.Link行为与 glibc 一致，但某些精简镜像会移除/proc挂载，导致os.Stat获取设备号失败——这时连判断跨设备都不可靠
