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 时经常踩这个坑。

问题解决

第一种:使用全路径运行 python 脚本

复制代码
/opt/anaconda3/envs/python3.12/bin/python a.py

这样能够正常 import ezdxf。

第二种:找到并禁用 alias

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 检查一下实际执行的是哪个解释器。
相关推荐
code2cat24 分钟前
【随笔】Java客户端选了HTTP/3,怎样知道请求实际走了哪个版本
java·开发语言·http
JonaHu29 分钟前
关键词排名突然消失?用 Python、SQLite 和 SERP API 搭一套可解释的 SEO 监控
python·sqlite·seo·serp api
prince_zxill1 小时前
把 17 个散文件装进一个文件夹:拆解 claude-plugins-official 的插件打包术(47,413 Star 实测)
python·github·agent·mcp·claude code
少司府1 小时前
嵌入式外设篇(三)GPIO·三:MCU系统结构、总线与统一编制
linux·python·stm32·单片机·嵌入式硬件·mcu·嵌入式软件
伞伞悦读2 小时前
【第90期】KNN分类回归流水线与K值对照的实验与排查
大数据·人工智能·python·深度学习·机器学习
console.log('npc')3 小时前
Python 学习教程 · 第4课:数据结构
数据结构·python·学习
honker_X3 小时前
Python字符串全攻略:从入门到精通
开发语言·python
半杯咖啡半行码3 小时前
Qt 隐式共享(Implicit Sharing)深度解析:机制、陷阱与 Qt6迁移
开发语言·数据库·qt
贾公子3 小时前
异步检测的轮询与超时——别把「还没好」当成「失败了」
后端·python
吃我一窝jio3 小时前
Docker+Jenkins+K8s全流程部署
java·开发语言·笔记·python