macOS 使用 conda，同时本地安装了python，遇到 ModuleNotFoundError: No module named ‘xxx‘` 解决

前言

我在激活的 Conda 环境(python3.12) 中执行 pip install ezdxf，安装成功。

但在执行 python 代码时报错：ModuleNotFoundError: No module named 'ezdxf'。

明明环境激活了，包也装好了，为什么就是找不到？我的 conda 已经加入到本地环境变量中了。

通过使用命令：which python、pip --version、alias | grep python

发现在 ~/.zprofile 文件中，有这样一行：

bash 复制代码

alias python="/Library/Frameworks/Python.framework/Versions/3.12/bin/python3"

这行 alias 把 python 命令强制指向了本地下载安装的独立 Python 3.12 解释器。

真正的原因是：alias 的优先级高于 PATH，所以即使 Conda 环境激活后把自己的 python 路径加到了 PATH 最前面，shell 也会无视它，直接使用 alias 指向的那个"裸" Python。

而本地安装的 Python 没有安装 ezdxf，所以就报错 ModuleNotFoundError 。

这是因为，很多人在安装 python.org 版的 Python 时，安装程序会自动在 ~/.zprofile 中添加类似的 alias，导致后来用 Conda/Miniconda 时经常踩这个坑。

复制代码

/opt/anaconda3/envs/python3.12/bin/python a.py

这样能够正常 import ezdxf。

bash 复制代码

# 搜索包含 python alias 的配置文件
grep -i python ~/.zprofile ~/.profile ~/.bash_profile ~/.bashrc ~/.*rc 2>/dev/null | grep alias

找到后(通常在 ~/.zprofile)，打开文件编辑：

bash 复制代码

vim ~/.zprofile

将那一行注释掉：

bash 复制代码

# alias python="/Library/Frameworks/Python.framework/Versions/3.12/bin/python3"

保存退出。

bash 复制代码

# 取消当前终端残留的旧 alias
unalias python

# 重新加载配置文件
source ~/.zprofile

# 重新激活 Conda 环境
conda deactivate
conda activate python3.12

验证是否成功

bash 复制代码

which python
# 正确输出应为：
# /opt/anaconda3/envs/python3.12/bin/python

alias | grep python
# 应该没有任何输出(alias 已消失)

python a.py
# 现在可以正常 import ezdxf 了！

如果仍然不对，建议运行一次：

bash 复制代码

conda init zsh

然后完全关闭终端，重新打开一个新窗口，再激活环境测试。

不想改配置文件时，可以在当前终端临时取消 alias：

bash 复制代码

unalias python

或者直接用反斜杠绕过 alias：

bash 复制代码

\python a.py

macOS + Conda 用户，如果同时安装了 python.org 官方版 Python，极容易踩 alias 坑。
建议优先使用 Conda/Miniconda 管理所有 Python 环境，避免多版本冲突。
养成习惯：遇到 ModuleNotFoundError 时，先用 which python 和 alias | grep python 检查一下实际执行的是哪个解释器。