Go os.OpenFile 文件权限参数为什么和实际权限不同怎样构造最小复现

os.OpenFile 里的 perm 并不是“每次打开都把文件设置成这个权限”。它只在带有 os.O_CREATE 且目标文件原本不存在时参与创建；在 Unix 类系统上，创建结果还会受到进程 umask 的影响。文件已经存在时，重新传入 0o600 或 0o666 都不会自动改掉原来的权限。

官方文档：https://pkg.go.dev/os#OpenFile

我排查这类问题时，先把“创建时的权限”和“已有文件的当前权限”分开记录，再用 os.Stat 查看结果。这样能很快判断是 umask 扣除了权限位，还是代码其实一直在打开一个已经存在的文件。

先把 perm 的生效时机说清楚

OpenFile(name, flag, perm) 的第三个参数是创建权限的候选值，不是永久设置值。只有 flag 包含 O_CREATE、并且路径不存在时，它才会传给底层创建操作。官方文档把这个语义明确描述为“以 perm 创建，且在 umask 之前”。

例如传入 0o666 并不保证最后看到 0666。如果当前 umask 是 0022，通常会得到 0644；这不是 Go 把八进制参数改写了，而是操作系统在创建阶段屏蔽了不允许的位。0o 前缀也很重要，它让数字明确使用 Go 的八进制写法。

最小复现：创建一次再用另一个 perm 打开

下面的程序故意先用 0o666 创建文件，再用写模式和 0o600 重新打开同一路径。临时目录会在结束时删除，避免把实验文件留在工作区。示例输出会随系统 umask 改变，但第二次打开前后通常保持同一个权限值。

package main

import (
	"fmt"
	"os"
	"path/filepath"
)

func main() {
	// 使用临时目录隔离实验文件，函数结束后统一清理。
	dir, err := os.MkdirTemp("", "openfile-mode-")
	if err != nil {
		panic(err)
	}
	defer os.RemoveAll(dir)

	path := filepath.Join(dir, "sample.txt")
	// O_CREATE 只在文件不存在时使用 perm 参与创建。
	f, err := os.OpenFile(path, os.O_WRONLY|os.O_CREATE|os.O_TRUNC, 0o666)
	if err != nil {
		panic(err)
	}
	if err := f.Close(); err != nil {
		panic(err)
	}

	info, err := os.Stat(path)
	if err != nil {
		panic(err)
	}
	fmt.Printf("created mode: %04o\n", info.Mode().Perm())

	// 文件已存在；这里的 0o600 不会覆盖已有权限。
	f, err = os.OpenFile(path, os.O_WRONLY|os.O_TRUNC, 0o600)
	if err != nil {
		panic(err)
	}
	if err := f.Close(); err != nil {
		panic(err)
	}

	info, err = os.Stat(path)
	if err != nil {
		panic(err)
	}
	fmt.Printf("existing mode after reopen: %04o\n", info.Mode().Perm())
}

在常见的 umask 0022 环境中，典型结果类似下面这样；这是输出形态示意，不代表所有机器都相同：

created mode: 0644
existing mode after reopen: 0644

关键观察点是第二行没有变成 0600。如果把第一次创建留下的文件删除后重新运行，第一行才会重新参与权限计算；如果只重复打开同一个文件，第三个参数只是调用接口要求的一部分，不是修改权限的入口。

看到权限不同，按这三个点定位

1. 确认是否真的创建。检查是否有 os.O_CREATE，以及目标路径在调用前是否已经存在。测试程序如果没有清理旧文件，很容易误判第三个参数失效。
2. 记录创建进程的 umask。在 Unix 类系统中，umask 会在新建阶段屏蔽一部分权限位。不要只看代码里的 0o666，还要把运行用户、服务启动方式和工作目录纳入排查。
3. 区分查看和修改。os.Stat(path).Mode().Perm() 用来观察当前权限；如果业务明确要求改变已有文件权限，应在成功打开或创建后显式调用 os.Chmod，并处理它返回的错误。

info, err := os.Stat(path)
if err != nil {
	// 先保留 Stat 的原始错误，避免把不存在和无权限混成同一种情况。
	return err
}
if err := os.Chmod(path, 0o600); err != nil {
	// Chmod 才是修改已有文件权限的明确动作，失败必须交给调用方处理。
	return err
}
fmt.Printf("before chmod: %04o\n", info.Mode().Perm())

这段写法只表达权限修改的意图，不应被理解成跨平台完全一致的权限模型。Windows 对 Unix 权限位的支持方式不同；如果程序需要跨平台运行，应把权限要求限定在目标系统可表达的范围内，并用实际平台的错误结果做判断。

常见疑问与结论

为什么我传了 0644，文件却是 0600？

先检查文件是否原本存在，再检查创建进程的 umask。若是已有文件，perm 不会覆盖旧模式；若是新建文件，umask 可能进一步减少权限。

想让已有文件变成 0644，继续调用 OpenFile 可以吗？

不可以把它当成可靠的修改方式。使用 os.Chmod 明确表达变更，并检查错误；同时考虑文件属主、目录权限和目标平台。

因此，最小判断公式可以记成：O_CREATE + 文件不存在 才让 perm 参与创建，Unix 类系统还要经过 umask；文件已存在时，查看当前模式用 Stat，修改模式用 Chmod。