Go不限制文件名长度，实际限制由操作系统决定：Linux ext4单文件名≤255字节，Windows NTFS默认≤255字符（需手动加\?前缀突破），macOS APFS/HFS+≤255 UTF-16码元；超长时os.Create返回“file name too long”错误而非静默截断。
Go 本身不拦截或限制文件名长度，创建失败与否完全取决于底层操作系统和文件系统——但你必须主动处理 os.Create 或 os.OpenFile 返回的错误，否则会静默失败或 panic。
超长文件名在不同系统上的实际限制是什么
Go 的 os 包直接调用系统 API（如 Linux 的 open(2)、Windows 的 CreateFileW），因此文件名长度上限由运行时环境决定：
- Linux ext4：单个路径组件（即文件名，不含路径）最多 255 字节（UTF-8 编码下可能是少于 255 个中文字符）
- Windows NTFS：通常支持最长 255 个 Unicode 字符（注意是字符数，不是字节数），但启用长路径支持（
\?前缀）后可突破，而 Go 标准库**不自动添加该前缀** - macOS APFS/HFS+：单个文件名最多 255 UTF-16 码元（约等于 255 个常见 Unicode 字符）
关键点：os.Create("非常非常长的文件名…….txt") 在超出限制时会返回类似 "file name too long" 或 "filename too long" 的 error，而不是截断或自动修正。
为什么 os.Create 不报错但文件没生成
常见误判场景：你传入了合法路径但含非法字符（如 Windows 下的 , :, ", /, , |, ?, *），或路径中某级目录不存在却未提前创建。此时 os.Create 会返回非-nil error，但若忽略它（比如只写 file, _ := os.Create(...)），程序看似“执行成功”，实则 file == nil，后续 file.Write 会 panic。
立即学习“go语言免费学习笔记（深入）”；
- 永远检查
err != nil，不要用空白标识符丢弃err - 创建前用
filepath.Base(name)提取纯文件名，并用正则或白名单校验是否含非法字符（尤其跨平台分发时） - 确保父目录存在：
os.MkdirAll(filepath.Dir(name), 0755)必须在os.Create之前调用
如何安全生成带哈希的短文件名替代超长名
当业务必须基于原始长名做唯一标识（如日志归档、用户上传），又需规避系统限制，推荐用内容哈希 + 截断命名，而非单纯截断原名（易冲突）：
import (
"crypto/md5"
"fmt"
"io"
"os"
"path/filepath"
)
func safeCreateWithHash(baseDir, originalName string, content []byte) (*os.File, error) {
// 1. 计算原始名的 MD5，取前8字节转十六进制作前缀
h := md5.Sum([]byte(originalName))
shortPrefix := fmt.Sprintf("%x", h[:4]) // 8 hex chars
// 2. 截断原名（保留扩展名），限制总长 ≤ 255 字节
ext := filepath.Ext(originalName)
stem := filepath.Base(originalName[:len(originalName)-len(ext)])
if len(stem) > 200 {
stem = stem[:200]
}
safeName := fmt.Sprintf("%s_%s%s", shortPrefix, stem, ext)
fullPath := filepath.Join(baseDir, safeName)
return os.Create(fullPath)
}
这样既保留可追溯性（前缀哈希可反查），又避开系统硬限制；注意：MD5 不用于安全场景，仅作快速去重，如需更强唯一性可用 sha256。
Windows 长路径支持需要手动适配
Go 标准库默认不启用 Windows 的长路径（>260 字符）支持。即使你的路径总长超限，os.Create 仍会直接失败，不会自动转为 \? 形式。
- 你无法让 Go 自动加
\?前缀——它不属于 Go 运行时职责 - 若确定只跑 Windows 且需支持长路径，可手动拼接：
os.Create(`\?` + absPath)，但absPath必须是绝对路径、无相对符（..）、无尾部斜杠 - 更稳妥的做法是：路径总长控制在 240 字符内（预留空间给
\?和驱动器号），避免依赖此机制
真正容易被忽略的是：错误信息里几乎从不提示“是因为长度超限”，而是笼统说 "The system cannot find the path specified." 或 "Invalid argument"——你得结合 filepath.Base 长度、目标系统文档、以及是否为绝对路径，才能准确定位。
