stat模块不提供直接获取权限的函数,需用os.stat()获取stat_result对象的st_mode属性,再通过stat.s_imode()提取纯权限位或stat.filemode()转为可读字符串,并用stat模块掩码(如stat.s_irusr)判断具体权限。

stat模块本身不提供直接获取权限位的函数,得靠os.stat返回的stat_result对象
Python 的 stat 模块不是用来“调用”的工具集,它本质上是一堆常量和辅助函数的集合。真正拿到文件权限信息的入口是 os.stat()(或 os.lstat()),它返回一个 stat_result 对象,其中第 0 个字段(st_mode)才是原始权限位整数。
常见错误是试图写 stat.get_permissions("file.txt") —— 这个函数根本不存在。别被模块名误导,stat 模块只负责解释 st_mode,不负责获取它。
-
os.stat("path")返回stat_result,权限在.st_mode属性里 -
stat.S_ISDIR()、stat.S_ISREG()等是类型判断函数,不是权限解析器 - 权限位是整数,比如
33188(对应-rw-r--r--),不能直接当字符串用
用stat.S_IMODE()提取纯权限部分,避开文件类型位干扰
st_mode 同时包含文件类型(如普通文件、目录、符号链接)和权限位(读/写/执行)。直接对 st_mode 做位运算容易误判,比如把目录标志 S_IFDIR(值为 16384)当成可执行位。
stat.S_IMODE() 就是干这个的:它把 st_mode 中的类型位清零,只留下低 9 位权限位(即用户/组/其他三组 rwx)。
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成,提供 184 种工具和 200 多条命令,用于安全分析和代码质量...
import os
import stat
<p>mode = os.stat("config.json").st_mode
perm_bits = stat.S_IMODE(mode) # 例如得到 33204 → 十进制,对应八进制 0o100644
print(perm_bits) # 33204
print(oct(perm_bits)) # 0o100644</p>
- 不用
S_IMODE而直接用mode & 0o777也行,但可读性差,且硬编码八进制易出错 -
S_IMODE是标准做法,兼容所有平台,语义明确 - 注意:它不处理 setuid/setgid/sticky 位(那三位在更高位置),如需它们,得额外用
stat.S_ISUID等单独判断
把权限位转成人类可读的字符串(如 "rw-r--r--"),别手写位移
自己用 & 和位移去拼 rwx 字符串既啰嗦又容易漏掉特殊位(如 sticky)。Python 自带 stat.filemode(),一行搞定:
import os
import stat
<p>mode = os.stat("script.sh").st_mode
print(stat.filemode(mode)) # 输出 "-rwxr-xr-x" 或 "drwxr-xr-x"(含类型前缀)</p>
-
filemode()返回字符串含类型首字符(-、d、l等)+ 9 位权限,最常用 - 如果只要纯 9 位(如 "rwxr-xr-x"),得切片:
stat.filemode(mode)[1:] - 它自动处理 setuid(
s)、sticky(t)等,比手动判断mode & stat.S_ISUID更稳
检查某类权限是否存在,用stat模块的掩码常量做位与
判断“当前用户是否有写权限”不是看 st_mode 是否大于某个数,而是用预定义掩码做按位与。这些掩码(如 stat.S_IRUSR)在不同系统上值可能不同,但语义固定。
import os
import stat
<p>mode = os.stat("data.txt").st_mode
if mode & stat.S_IRUSR: # 用户可读?
print("owner can read")
if mode & stat.S_IWGRP: # 组可写?
print("group can write")
if mode & stat.S_IXOTH: # 其他人可执行?
print("others can execute")</p>
- 掩码常量必须来自
stat模块,不要自己写0o400—— 虽然值一样,但可读性和跨平台性差 - 注意区分
S_IRUSR(用户读)和S_IRGRP(组读),别混用 - 对符号链接用
os.lstat(),否则os.stat()会跟随链接,拿到的是目标文件的权限
实际用的时候,os.stat().st_mode 是起点,stat.S_IMODE() 和 stat.filemode() 是两个最常走的分支,而权限判断必须依赖 stat 模块的掩码常量——漏掉任意一环,要么拿不到真实权限,要么逻辑在某些文件类型或系统上出错。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










