📅 发布时间：2026/6/17 20:47:01

前言

最近我在使用pip install命令安装包时，偶然发现在包名中使用下划线和使用连字符都可以成功安装，而且安装的确实是同一个包。这就激发了我的好奇心，难道pip install 命令中下划线和连字符是等效的？于是我就去网上搜索了一下，并整理了相关资料写成这篇博文。

PyPI包名规则

PyPA编写的Python软件打包用户指南中说明，包名允许包含大小写字符、数字、句点、连字符、下划线这几种符号。但同时制定了一个规则，叫包名规范化。包名规范化主要包含三个规则：

因此，实际上以下几种包名是等价的：

最终都会转换为规范形式的包名：friendly-bard

在使用pip install <包名>命令安装包时，pip会首先将包名转换为规范包名，之后再去Pypi库查找并安装。因此，假设你要安装scikit-learn这个包，你甚至可以执行pip install sCIKit.-_LEarN，也是可以安装成功的。

同样的，在卸载包时，pip uninstall <包名>命令也一样，大写字符会自动转成小写，其他的连接符会自动转换为连字符。

不过我发现pip install和pip uninstall在命令执行成功后的打印日志上细节还是有些不同。以用户输入的包名为sCIKit.-_LEarN为例，pip install sCIKit.-_LEarN执行成功后，输出的是：

Successfully installed joblib-1.5.2 sCIKit.-_LEarN-1.6.1 threadpoolctl-3.6.0

可以看到其中输出的包名和用户输入的一致。

但pip uninstall sCIKit.-_LEarN执行成功后，输出的是：

Successfully uninstalled scikit-learn-1.6.1

可以看到其中输出的包名是规范包名。

目前并不清楚pip在安装和卸载时显示的包名有两种行为模式的原因，可能是有意为之。

需要注意的是，pip install的包名和在python代码中使用import导入的相关模块名称并不一定完全一致。

比如常用的机器学习包sklearn，在代码中导入的用法为:from sklearn import *，但安装的命令却是pip install scikit-learn，而不是~~pip install sklearn~~。这也是很多新手会踩的一个坑。