filepath.join是唯一安全的路径拼接方式，它自动适配系统分隔符、清理冗余斜杠、处理绝对路径截断，并配合abs/clean/白名单三步校验用户输入路径，防止路径穿越和跨平台解析失败。
filepath.Join 是唯一能用的拼接方式
硬拼字符串（比如 dir + "/" + file 或 fmt.Sprintf("%s\%s", dir, file)）在 GoLand 里跑 Linux/macOS 测试时可能正常，一到 Windows CI 或用户机器就报 no such file or directory——不是路径不存在，而是系统根本没解析对。这是因为 Go 的 os.Open 虽然能容忍部分混合分隔符，但 exec.Command、http.ServeFile、日志写入路径、甚至某些 GoLand 自带的文件监视器都会直接失败。
正确做法只有一种：filepath.Join("logs", "app", "error.log")。它自动选 os.PathSeparator，跳过空字符串和 "."，合并冗余分隔符（"a//b" → "a/b"），且在 Windows 下输出 logspperror.log，Linux 下是 logs/app/error.log。
-
filepath.Join("config/", "db.yaml")→config/db.yaml（末尾斜杠被清理） -
filepath.Join("C:", "foo.txt")→C:foo.txt（这是相对路径！要绝对路径得写filepath.Join("C:/", "foo.txt")） -
filepath.Join("data", "/etc/passwd")→/etc/passwd（遇到绝对路径参数，前面全丢）
用户输入路径必须走 Abs → Clean → 白名单三步
从命令行 flag、配置文件、HTTP query（如 ?path=../etc/passwd）拿到的路径，不能直接喂给 filepath.Join 或 os.Open。filepath.Clean("../etc/passwd") 返回的还是 ../etc/passwd，os.Open 真会去读它。
安全闭环只有这一种写法：
abs, err := filepath.Abs(userInput)
if err != nil {
return err
}
cleaned := filepath.Clean(abs)
if !strings.HasPrefix(cleaned, allowRoot+string(filepath.Separator)) {
return errors.New("path outside allowed root")
}
-
allowRoot必须带结尾分隔符，比如"/opt/myapp"要写成"/opt/myapp" + string(filepath.Separator)，否则"/opt/myapp-hacked"会被误判通过 - 别用
os.Getwd()当基准目录——GoLand 启动方式、终端 cd 到哪、CI 工作目录都不同，filepath.Abs结果完全不可控 - 可靠根目录应取自二进制位置：
exe, _ := os.Executable(); root := filepath.Dir(exe)
filepath.Dir 和 filepath.Base 的坑比想象中多
这两个函数不判断真实文件系统结构，只按分隔符切字符串。直接拿 filepath.Base("log/") 拼新名字，结果是 "" + ".bak" → ".bak"，文件名直接消失。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
正确用法永远前置 cleaned := filepath.Clean(input)，再判断是否为目录：
-
filepath.Base("log/")→""（不是"log"），filepath.Base("/")→"/" -
filepath.Dir("singlefile")→"."（不是空字符串），后续filepath.Join(dir, "backup")变成./backup，可能越界 - 判断目录要用
strings.HasSuffix(cleaned, string(filepath.Separator))，而不是靠filepath.Base返回值
Windows 盘符路径必须显式带根分隔符
filepath.Join("C:", "foo.txt") 在 Windows 上返回 C:foo.txt，这是相对于 C: 当前工作目录的相对路径，不是 C: oo.txt。GoLand 调试时如果工作目录是 D:project，这个路径实际指向 D:projectC:foo.txt，根本不是你想要的位置。
要得到盘根绝对路径，必须显式提供分隔符：
-
filepath.Join("C:/", "foo.txt")→C: oo.txt -
filepath.Join("C:"+string(filepath.Separator), "bar.log")更通用 - 不要用
filepath.FromSlash("C:/foo.txt")替代——它只转分隔符，不处理语义，FromSlash("C:/../etc/passwd")还是危险路径
跨平台路径最麻烦的从来不是拼接本身，而是把“用户给的字符串”变成“操作系统能安全执行的路径”。每一步漏掉，都可能在 Windows 上静默失败，或者在生产环境触发路径穿越。
