PyCharm中Poetry项目莫名提示找不到setuptools的解决问询

问题原因 #

PyCharm后台执行的packaging_tool.py工具依赖setuptools读取虚拟环境的包列表，而Poetry默认创建的虚拟环境不会自动安装setuptools，因此触发该错误。

解决方案 #

方案1：安装setuptools为开发依赖（推荐） #

通过Poetry将setuptools添加到开发依赖，既满足PyCharm工具需求，又不影响生产环境依赖：

poetry add --dev setuptools

方案2：禁用PyCharm的自动包管理检查 #

若不想安装setuptools，可关闭PyCharm对当前虚拟环境的自动包管理功能：

• 打开PyCharm的Preferences（Windows/Linux为Settings）
• 进入Project: [你的项目名称] > Python Interpreter
• 点击右上角齿轮图标，选择Show All
• 选中当前Poetry虚拟环境，点击右侧Edit按钮
• 在编辑窗口中取消勾选Enable package management选项
• 保存设置后重启PyCharm

方案3：手动在虚拟环境中安装setuptools #

先激活Poetry虚拟环境，再用pip安装setuptools：

poetry shell
pip install setuptools

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