Python包与对应PyPi项目能否使用不同名称？及实操方法咨询

为什么PyPI上的scikit-learn对应Python模块sklearn #

PyPI包名和Python模块名是相互独立的，这种差异主要源于以下几点：

• 命名规则限制：Python模块名不允许包含连字符，而PyPI包名常用连字符分隔单词，更符合可读性要求。scikit-learn作为项目名清晰传达了所属生态（scikit系列）和功能，而sklearn作为模块名规避了语法限制，同时更简洁易写。
• 打包配置支持：通过setup.py或pyproject.toml等打包配置文件，可以将PyPI包名与实际Python模块名绑定。PyPI仅识别配置中指定的name字段作为包名，而Python解释器根据模块目录/文件的名称加载代码。

本地包packageA被占用，能否以packageB上传？ #

完全可以，只要packageB在PyPI上未被占用，这是PyPI支持的常规操作。具体步骤如下：

1. 修改打包配置文件 #

• 使用pyproject.toml（推荐）：在配置文件的[project]区块中，将name字段改为packageB，同时保留实际模块的引用：

  [project]
  name = "packageB"
  packages = ["packageA"]
  # 其他配置（版本、作者等）按需修改
  

• 使用setup.py：修改setup()函数中的name参数，确保packages指向你的实际模块目录：

  from setuptools import setup, find_packages
  
  setup(
      name="packageB",
      packages=find_packages(include=["packageA"]),
      # 其他配置
  )
  

2. 确认项目结构 #

确保你的项目结构如下（以pyproject.toml为例），实际代码仍在packageA目录中：

你的项目根目录/
├── pyproject.toml
└── packageA/
    ├── __init__.py
    └── 你的模块文件.py

3. 构建包文件 #

先安装构建工具：

pip install build

然后在项目根目录运行构建命令，生成可上传的包文件：

python -m build

执行完成后，dist目录下会生成packageB-<版本号>.tar.gz和packageB-<版本号>-py3-none-any.whl两个文件。

4. 上传至PyPI #

先安装上传工具：

pip install twine

然后运行上传命令，按照提示输入PyPI账号密码或API Token：

twine upload dist/*

5. 测试安装与导入 #

上传成功后，用户可通过以下命令安装并使用你的包：

pip install packageB

在Python代码中仍按原模块名导入：

import packageA

注意事项 #

• 上传前务必在PyPI官网搜索packageB，确认该名称未被占用。
• 若之前上传过packageA的测试版本，无需删除，只要packageB是全新可用名称即可。
• 建议在配置文件中补充项目描述、作者、文档链接等信息，提升包的可发现性。

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