Go语言如何规避macOS下Unicode文件名的重复识别异常？

问题本质 #

macOS的APFS、HFS+文件系统默认会对文件名执行Unicode规范化（采用NFD格式），并且会将部分语义等价的Unicode字符组合判定为同一序列——比如你提到的希腊语连字ᾳ（U+1F73）和分解后的αι（U+03B1+U+03B9），在系统规则下会被识别为相同文件名，导致后创建的文件直接覆盖先创建的。

可行规避方案 #

在Go中，你可以通过以下几种方式强制让文件系统保留文件名的原始字节序列，避免被规范化合并：

1. 直接调用系统级创建接口 #

使用syscall包的Open函数，直接传入文件名的原始字节切片，绕开Go标准库的文件名处理逻辑：

package main

import "syscall"

func main() {
    // 每个文件名的原始字节序列确保唯一
    rawFilenames := [][]byte{
        []byte("καθέδρα.txt"),
        []byte("καθέδρᾳ.txt"),
        []byte("καθέδραι.txt"),
    }

    for _, nameBytes := range rawFilenames {
        // O_EXCL 标志确保文件不存在时才创建，避免覆盖
        fd, err := syscall.Open(string(nameBytes), syscall.O_CREAT|syscall.O_EXCL|syscall.O_WRONLY, 0644)
        if err != nil {
            panic(err)
        }
        _ = syscall.Close(fd)
    }
}

2. 结合标准库与系统标志 #

如果偏好使用os包，可以添加syscall.O_NOFOLLOW标志，该标志在macOS下会抑制系统对文件名的规范化处理：

package main

import (
    "os"
    "syscall"
)

func main() {
    filenames := []string{
        "καθέδρα.txt",
        "καθέδρᾳ.txt",
        "καθέδραι.txt",
    }

    for _, name := range filenames {
        // 转换为字节再转回字符串，确保传入原始字节序列
        rawName := string([]byte(name))
        file, err := os.OpenFile(rawName, os.O_CREATE|os.O_EXCL|os.O_WRONLY|syscall.O_NOFOLLOW, 0644)
        if err != nil {
            panic(err)
        }
        _ = file.Close()
    }
}

3. 文件名唯一化哈希 #

如果不需要严格保留原始文件名形式，可以给每个文件名附加唯一哈希值，从根源上避免冲突：

package main

import (
    "crypto/sha1"
    "fmt"
    "os"
)

func main() {
    filenames := []string{
        "καθέδρα.txt",
        "καθέδρᾳ.txt",
        "καθέδραι.txt",
    }

    for _, name := range filenames {
        // 基于原始文件名生成SHA-1哈希
        hash := sha1.Sum([]byte(name))
        // 拼接哈希值到文件名中，确保全局唯一
        uniqueName := fmt.Sprintf("%s-%x.txt", name[:len(name)-4], hash)
        file, err := os.Create(uniqueName)
        if err != nil {
            panic(err)
        }
        _ = file.Close()
    }
}

验证方式 #

创建文件后，可通过终端命令检查文件是否独立：

# 查看每个文件的inode编号，不同编号代表独立文件
stat -f "%N %i" *.txt

内容的提问来源于stack exchange，提问作者user84118