python - 从(或接近)具有相同名称的脚本导入库会引发 "AttributeError: module has no attribute"或 ImportError 或 NameError

Question

我有一个名为requests.py 的脚本，需要使用第三方requests 包。该脚本无法导入包，或者无法访问其功能。

为什么这不起作用，我该如何解决？

尝试简单导入然后使用该功能会导致 AttributeError:

import requests

res = requests.get('http://www.google.ca')
print(res)

Traceback (most recent call last):
  File "/Users/me/dev/rough/requests.py", line 1, in <module>
    import requests
  File "/Users/me/dev/rough/requests.py", line 3, in <module>
    requests.get('http://www.google.ca')
AttributeError: module 'requests' has no attribute 'get'

在较新版本的 Python 中，错误消息显示为 AttributeError: partially initialized module 'requests' has no attribute 'get' (most likely due to a circular import)。

使用特定名称的自导入会导致 ImportError:

from requests import get

res = get('http://www.google.ca')
print(res)

Traceback (most recent call last):
  File "requests.py", line 1, in <module>
    from requests import get
  File "/Users/me/dev/rough/requests.py", line 1, in <module>
    from requests import get
ImportError: cannot import name 'get'

在较新的 Python 版本中，错误消息改为 ImportError: cannot import name 'get' from partially initialized module 'requests' (most likely due to a circular import) (/Users/me/dev/rough/requests.py).

对包内的模块使用 from-import 会导致不同的 ImportError:

from requests.auth import AuthBase

Traceback (most recent call last):
  File "requests.py", line 1, in <module>
    from requests.auth import AuthBase
  File "/Users/me/dev/rough/requests.py", line 1, in <module>
    from requests.auth import AuthBase
ImportError: No module named 'requests.auth'; 'requests' is not a package

使用 star-import 然后使用该功能会引发 NameError:

from requests import *

res = get('http://www.google.ca')
print(res)

Traceback (most recent call last):
  File "requests.py", line 1, in <module>
    from requests import *
  File "/Users/me/dev/rough/requests.py", line 3, in <module>
    res = get('http://www.google.ca')
NameError: name 'get' is not defined

---

^{如果您故意 将您的模块命名为与现有模块相同的名称并希望处理这种情况，请参阅 How can I import from the standard library, when my project has a module with the same name? (How can I control where Python looks for modules?)}

Answer 1

发生这种情况是因为您的本地模块名为 requests.py隐藏已安装的 requests您尝试使用的模块。当前目录附加到 sys.path , 因此本地名称优先于安装名称。

出现这种情况时的额外调试提示是仔细查看回溯，并意识到您的相关脚本的名称与您尝试导入的模块相匹配:

注意您在脚本中使用的名称:

File "/Users/me/dev/rough/requests.py", line 1, in <module>

您尝试导入的模块:requests

将您的模块重命名为其他名称以避免名称冲突。

Python 可能会生成一个 requests.pyc requests.py 旁边的文件文件(在 Python 3 中的 __pycache__ 目录中)。重命名后也将其删除，因为解释器仍将引用该文件，从而重新产生错误。然而，pyc文件在 __pycache__ 应该如果 py 不会影响您的代码文件已被删除。

在示例中，将文件重命名为 my_requests.py , 删除 requests.pyc , 并再次运行成功打印 <Response [200]> .

---

注意: 这不仅发生在将您的文件命名为您尝试导入的模块时。如果您将文件命名为与您直接导入的模块导入的模块相同的名称，也会发生这种情况。例如，有一个名为 copy.py 的文件 并尝试 import pandas从那里，将给予

ImportError: cannot import name 'copy' from 'copy'

那是因为pandas进口copy .这里没有神奇的解决方案，因为您无法知道世界上所有模块的名称，但经验法则是尝试使模块名称尽可能唯一，并在出现此类错误时尝试更改名称。