pip安装PyPI自研包时出现DistutilsOptionError，无setup.cfg该如何解决？

以下是几个针对性的解决方法：

• 升级pip和setuptools到最新版本
  旧版本的setuptools对pyproject.toml中[tool.setuptools.packages.find]的配置解析存在兼容性问题，执行以下命令升级：

  pip install --upgrade pip setuptools
  

• 检查并清理项目中的残留配置文件
  确认你的项目根目录确实没有setup.cfg文件，重新打包前清理临时构建文件：

  rm -rf build dist *.egg-info
  

  本地先测试安装打包后的文件：

  pip install dist/your-package-name.tar.gz
  

  确认无问题后再重新上传到PyPI。

• 清理pip本地缓存
  若本地缓存了带错误配置的旧包版本，执行以下命令清空缓存后重新安装：

  pip cache purge
  

• 补充pyproject.toml的显式配置
  在pyproject.toml中添加package_dir的显式配置，帮助setuptools明确源码目录结构：

  [tool.setuptools]
  package_dir = {"" = "src"}
  
  [tool.setuptools.packages.find]
  where = ["src"]
  

  这个配置会明确告诉setuptools：根包的源代码位于src目录下，避免解析时误将src当作字典格式的值。

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