当前位置：首页 > news >正文

Python 3.6.1 报错 “module ‘enum‘ has no attribute ‘IntFlag‘” 的真正原因与解决办法

news 2025/11/11 13:14:00

网罗开发 （小红书、快手、视频号同名）

大家好，我是展菲，目前在上市企业从事人工智能项目研发管理工作，平时热衷于分享各种编程领域的软硬技能知识以及前沿技术，包括iOS、前端、Harmony OS、Java、Python等方向。在移动端开发、鸿蒙开发、物联网、嵌入式、云原生、开源等领域有深厚造诣。

图书作者：《ESP32-C3 物联网工程开发实战》
图书作者：《SwiftUI 入门，进阶与实战》
超级个体：COC上海社区主理人
特约讲师：大学讲师，谷歌亚马逊分享嘉宾
科技博主：华为HDE/HDG

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告，同时也会提供产品优缺点分析、横向对比，并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。

展菲：您的前沿技术领航员
👋 大家好，我是展菲！
📱 全网搜索“展菲”，即可纵览我在各大平台的知识足迹。
📣 公众号“Swift社区”，每周定时推送干货满满的技术长文，从新兴框架的剖析到运维实战的复盘，助您技术进阶之路畅通无阻。
💬 微信端添加好友“fzhanfei”，与我直接交流，不管是项目瓶颈的求助，还是行业趋势的探讨，随时畅所欲言。
📅 最新动态：2025 年 3 月 17 日
快来加入技术社区，一起挖掘技术的无限潜能，携手迈向数字化新征程！

文章目录

- 摘要
- 背景与问题重现
- 问题原因分析
- 实战验证：如何复现这个错误
- 正确的解决方案
- - 方案一：删除或重命名本地的 `enum.py`
  - 方案二：检查 `__pycache__` 目录
  - 方案三：检查 sys.path 顺序
- 可运行 Demo：验证修复前后效果
- - 修复前：
  - 修复后（删除 enum.py）：
- 延伸思考：这个坑不只发生在 enum
- 总结
- 小贴士

摘要

有一天你刚刚装好 Python 3.6.1，信心满满地敲下命令：

python3

结果刚刚打开控制台，终端就给了你一个当头一棒：

AttributeError: module 'enum' has no attribute 'IntFlag'

看起来好像是 Python 内部的 bug，对吧？
其实并不是。这个问题的根本原因非常“隐蔽”——是你项目（或系统路径）中存在一个名为 enum.py 的文件，覆盖了标准库的 enum 模块。

下面我们一起来还原这个坑的全过程。

背景与问题重现

首先，这个问题常出现在以下环境中：

macOS 系统；
Python 版本 3.6.1（但也可能在 3.7 甚至 3.8 出现）；
安装路径类似 /Library/Frameworks/Python.framework/...；
启动解释器或运行任何 Python 文件时，报如下错误：

AttributeError: module 'enum' has no attribute 'IntFlag'

你可能第一反应是：

“明明 Python 3.6 已经支持 IntFlag 啊，这不应该报错啊？”

是的，Python 3.6.1 的 enum 模块确实定义了 IntFlag 类：

# Python 3.6 源码 enum.py 中的一部分
class IntFlag(Flag):pass

那为什么解释器还会报 “enum 没有 IntFlag” 呢？
别急，下面揭开谜底。

问题原因分析

Python 的导入机制其实非常简单——它会按照 sys.path 的顺序依次搜索模块。
一旦它在某个路径下找到了名为 enum.py 的文件，它就会优先导入那个文件，而不是标准库自带的。

比如，你的项目结构是这样的：

/Users/yourname/project/
├── enum.py
├── main.py

你在 main.py 里执行了：

import enum

Python 实际上导入的是你项目目录下的 enum.py，而不是标准库的 enum 模块。
于是，这个自定义的 enum.py 文件里没有 IntFlag 类，解释器自然就抛出了：

AttributeError: module 'enum' has no attribute 'IntFlag'

本质上是：你“遮蔽”了标准库模块。

实战验证：如何复现这个错误

我们自己来做个小实验，看它是怎么被“遮蔽”的：

# enum.py (放在当前目录)
print("自定义 enum 模块被导入")def dummy():pass

然后运行一个测试文件：

# main.py
import enumprint(enum)
print(dir(enum))

执行结果：

自定义 enum 模块被导入
<module 'enum' from '/Users/yourname/project/enum.py'>
['__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', 'dummy']

可以看到，Python 确实导入了我们自己定义的 enum.py。
所以，系统的 enum.IntFlag 根本没有机会被加载。

正确的解决方案

这个问题的修复其实非常简单，通常有三种做法：

方案一：删除或重命名本地的 `enum.py`

最直接有效的方法就是：

找到你项目或用户目录下的 enum.py；
删除它；
或者改个名，比如 my_enum.py。

然后重新运行程序，就一切正常了。

方案二：检查 `pycache` 目录

即使你已经删除了 enum.py，有时候 Python 还会加载缓存文件。

所以建议同时清理掉：

__pycache__/enum.cpython-36.pyc

否则缓存模块仍可能被误导入。

方案三：检查 sys.path 顺序

如果你在多项目环境下开发，可以打印当前解释器的模块搜索路径：

import sys
for p in sys.path:print(p)

一般情况下，当前工作目录会排在最前面：

/Users/yourname/project
/usr/local/lib/python3.6
...

你也可以临时调整 sys.path 的顺序（不推荐长期使用）：

import sys
sys.path.remove('/Users/yourname/project')

可运行 Demo：验证修复前后效果

我们来做个对比实验，验证修复后的正确行为。

修复前：

$ python3
>>> import enum
>>> enum.IntFlag
Traceback (most recent call last):...
AttributeError: module 'enum' has no attribute 'IntFlag'

修复后（删除 enum.py）：

$ python3
>>> import enum
>>> enum.IntFlag
<enum 'IntFlag'>

问题成功解决

延伸思考：这个坑不只发生在 enum

这种“本地文件覆盖标准库”的问题非常常见。
开发者最常踩的几个坑还有：

模块名	常见误伤	结果
`enum.py`	覆盖标准库 enum	AttributeError: no attribute
`random.py`	覆盖 random 模块	AttributeError: module ‘random’ has no attribute ‘randint’
`json.py`	覆盖 json 模块	TypeError: ‘str’ object is not callable
`asyncio.py`	覆盖 asyncio 框架	ImportError: cannot import name ‘Future’
`logging.py`	覆盖 logging 模块	AttributeError: module ‘logging’ has no attribute ‘getLogger’