Pyenv管理Python环境下，Poetry操作现有项目触发No module named 'numpy'错误
2026-6-13
问题描述
- 通过官方Shell脚本安装Poetry（版本2.1.1），多次重装后，
which poetry返回路径为/home/myuser/.local/bin/poetry - Python版本由Pyenv管理
- 创建空项目时Poetry可正常使用，但进入任何从GitHub拉取的现有项目后，执行任何Poetry命令（包括
poetry --version）都会触发No module named 'numpy'错误，且Poetry尚未开始安装包就报错
解决步骤
1. 清理项目本地残留文件与虚拟环境
现有项目可能存在影响Poetry运行的缓存或配置文件，执行以下操作：
- 删除项目根目录下的
poetry.lock文件和.venv文件夹 - 删除项目内所有
__pycache__文件夹 - 执行
poetry env remove --all清除该项目关联的所有虚拟环境
2. 检查Pyenv指定的Python环境
Poetry会优先使用项目目录下Pyenv指定的Python版本，验证该环境的依赖状态：
- 进入项目目录，执行
pyenv version确认当前使用的Python版本 - 直接用该版本运行
python -c "import numpy"，如果同样报错，说明该Python环境本身缺失numpy，先手动安装：pip install numpy - 若手动安装后问题依旧，重新安装该版本Python：
pyenv uninstall <你的Python版本号> && pyenv install <你的Python版本号>
3. 强制Poetry绑定指定Python环境
明确指定Poetry使用Pyenv当前的Python版本创建独立虚拟环境：
- 在项目目录执行
poetry env use $(pyenv which python) - 执行
poetry install重新安装项目依赖
4. 重装并清理Poetry自身
若上述步骤无效，尝试彻底重装Poetry并清理缓存：
- 卸载Poetry：
curl -sSL https://install.python-poetry.org | python3 - --uninstall - 清理Poetry缓存：
rm -rf ~/.cache/pypoetry - 重新安装Poetry：
curl -sSL https://install.python-poetry.org | python3 -
内容的提问来源于stack exchange，提问作者Darina
相关产品推荐
相关产品推荐
