PyCharm识别setup.py本地包正常，添加pyproject.toml后失效如何解决？

检查pyproject.toml配置正确性 #

• 如果你沿用setuptools构建，必须在pyproject.toml中声明正确的构建后端，否则可编辑安装的逻辑会出问题：

  [build-system]
  requires = ["setuptools>=61.0"]
  build-backend = "setuptools.build_meta"
  

• 确保pyproject.toml（如果有[project]字段）里的name和setup.py中的包名完全一致，必须是my_lib，大小写、下划线都不能错。

重新执行可编辑安装 #

• 先卸载旧的包实例：pip3.12 uninstall -y my_lib
• 重新执行可编辑安装命令：pip3.12 install -e ../my-lib
  注意：如果my_lib目录下的pyproject.toml用了非setuptools的构建后端（比如poetry），得切换到my_lib目录下执行pip install -e .，确保构建逻辑正确。

强制刷新PyCharm索引 #

• 打开File > Settings > Project: [你的项目名] > Python Interpreter，找到列表中的my_lib，点击右侧的刷新按钮（环形箭头），确认包已被正确识别。
• 执行File > Invalidate Caches...，选择Invalidate and Restart，让PyCharm彻底重新索引所有依赖和代码。

手动添加包路径到项目（兜底方案） #

如果上面的步骤都无效，直接把my_lib目录加入项目的源码路径：

• 打开File > Settings > Project: [你的项目名] > Project Structure
• 点击Add Content Root，选择../my-lib目录，然后将该目录标记为Sources
• 重启PyCharm后，导入语句应该就能正常识别了

确认解释器一致性 #

• 检查PyCharm右下角的Python解释器选择器，确保当前项目使用的是你执行pip3.12 install的那个Python 3.12解释器，避免因解释器不匹配导致包找不到。

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