安装promise模块遇ModuleNotFoundError及元数据生成失败问题求助

问题根源 #

系统级site-packages目录无写入权限，pip默认走用户目录安装，但安装过程中出现元数据生成失败的循环依赖——生成元数据时需要promise模块，可此时还未完成安装，导致ModuleNotFoundError。

可行解决办法 #

• 强制用户目录安装并跳过构建隔离
  执行这条命令直接绕过元数据生成的问题：

  pip install promise --user --no-build-isolation
  

  --user指定安装到用户专属包目录（避开系统权限限制），--no-build-isolation关闭构建隔离，解决元数据依赖缺失的问题。

• 确认用户包目录在Python路径中
  打开Python终端执行以下代码：

  import sys
  print([p for p in sys.path if 'site-packages' in p and 'user' in p])
  

  若输出为空，需手动将用户包目录加入PYTHONPATH环境变量：

  • Linux/macOS路径：~/.local/lib/python3.9/site-packages
  • Windows路径：%APPDATA%\Python\Python39\site-packages

• 用虚拟环境隔离依赖（彻底解决权限问题）
  创建独立虚拟环境，完全避开系统目录限制：

  # 创建虚拟环境
  python -m venv myenv
  # Linux/macOS激活环境
  source myenv/bin/activate
  # Windows激活环境
  myenv\Scripts\activate
  # 安装promise
  pip install promise
  

验证安装结果 #

执行以下命令确认是否安装成功：

python -c "import promise; print(promise.__version__)"

能正常输出版本号即为安装成功。

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