执行poetry add报No module named 'cleo'，重装poetry仍无法解决怎么办

• 问题根因
  该错误通常由三种情况导致：旧版poetry卸载残留引发依赖冲突、poetry默认安装路径更新后旧的环境变量配置不生效、当前项目的虚拟环境依赖损坏。
• 第一步：彻底清理旧版poetry残留
  依次执行以下命令清除所有旧版本安装文件：

  # 删除旧版poetry安装目录
  rm -rf ~/.poetry
  # 卸载全局pip安装的poetry相关组件
  pip uninstall -y poetry poetry-core
  pip3 uninstall -y poetry poetry-core
  # 若使用brew等包管理器安装过poetry，执行对应卸载命令（以brew为例）
  brew uninstall poetry
  

• 第二步：安装最新稳定版poetry
  你之前使用的get-poetry.py脚本已被官方废弃，使用官方最新安装脚本执行安装：

  curl -sSL https://install.python-poetry.org | python3 -
  

• 第三步：更新环境变量配置
  新版poetry默认安装到~/.local/bin目录，之前配置的~/.poetry/bin路径已失效，执行以下命令更新环境变量：

  export PATH="$HOME/.local/bin:$PATH"
  

  执行完成后运行poetry --version验证安装，正常输出版本号即说明全局安装正常。
• 第四步：修复项目级虚拟环境问题
  如果全局验证正常，但进入项目执行poetry add仍报错，说明项目虚拟环境依赖损坏，执行以下命令重建虚拟环境即可：

  # 删除当前项目的虚拟环境
  poetry env remove python3
  # 重新安装项目依赖
  poetry install
  

• 注意事项
  不要使用pip install poetry全局安装poetry，该方式会将poetry的依赖直接安装到系统Python环境，极易出现版本冲突问题。

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