Python无法导入本地Store类，为何优先读取Anaconda路径？

目录结构 #

/Users/dd/python/folder/
   main.py
   store.py
   __init__.py

代码内容 #

store.py #

# store.py
class Store:
    def __init__(self,location):
        self.location = location

main.py #

# main.py
from store import Store 
store = Store('Kansas')
print(store.location)

运行报错信息 #

ImportError: cannot import name 'Store' from 'store' (/Users/dd/opt/anaconda3/lib/python3.9/store.py)

当前sys.path包含的路径 #

• /Users/dd/opt/anaconda3/lib/python3.9
• /Users/dd/opt/anaconda3/lib/python3.9/site-packages
• ...
• /Users/dd/python/folder

问题解答 #

1. 为何Python优先读取Anaconda路径而非本地文件夹？ #

Python查找模块时会严格按照sys.path里的顺序依次搜索，你的列表里Anaconda的系统库路径排在本地项目路径前面，所以Python先匹配到了Anaconda目录下的store.py，而非你本地项目里的同名文件。

2. 这是Anaconda的问题吗？ #

不是。这是Python模块搜索机制的正常行为，和Anaconda本身无关——只要sys.path里有优先级更高的同名模块，就会优先加载该模块。

3. 报错信息中括号内的路径来源是什么？ #

括号里的路径就是Python在sys.path中最先找到的store.py文件的实际位置，也就是它尝试导入的那个文件路径。

4. 如何配置让Python优先使用当前项目文件夹？ #

临时解决：手动调整sys.path顺序

在main.py开头加入以下代码，把当前项目目录插入到sys.path最前端：

import sys
import os
current_dir = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, current_dir)

from store import Store 
store = Store('Kansas')
print(store.location)

规范解决：使用包结构的相对导入

因为你的目录已经包含__init__.py，可以将其当作Python包处理，修改main.py的导入语句：

from .store import Store 
store = Store('Kansas')
print(store.location)

然后回到项目上级目录，用模块方式运行脚本：

cd /Users/dd/python
python -m folder.main

永久配置：调整PYTHONPATH环境变量

将项目目录添加到PYTHONPATH并设置为最高优先级：

• macOS/Linux：在~/.bashrc或~/.zshrc中添加：

  export PYTHONPATH="/Users/dd/python/folder:$PYTHONPATH"
  

  执行source ~/.bashrc（或对应shell配置文件）生效。
• Windows：在系统环境变量中新增PYTHONPATH，值设为你的项目路径，并确保它排在系统Python路径之前。

另外，若虚拟环境未解决问题，检查是否全局安装过同名的store模块，如有先卸载：

pip uninstall store

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