‘python.exe -m pip install’对比‘pip install’的优势与差异

问题场景 #

执行pip install --upgrade pip时出现报错：

C:\Users\hp>pip install --upgrade pip
Requirement already satisfied: pip in c:\users\hp\appdata\local\programs\python\python311\lib\site-packages (23.1.2)
Collecting pip
 Downloading pip-23.2.1-py3-none-any.whl (2.1 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.1/2.1 MB 10.2 MB/s eta 0:00:00
ERROR: To modify pip, please run the following command:
C:\Users\hp\AppData\Local\Programs\Python\Python311\python.exe -m pip install -- upgrade pip

[notice] A new release of pip is available: 23.1.2 -> 23.2.1
[notice] To update, run: python.exe -m pip install --upgrade pip

但执行python.exe -m pip install --upgrade pip时，pip成功完成升级。

两条命令的核心区别 #

• pip install --upgrade pip：直接调用系统PATH中注册的pip可执行脚本，这个脚本在运行时会被系统锁定，升级pip需要替换该脚本文件，因此触发文件占用报错，无法完成升级。
• python.exe -m pip install --upgrade pip：通过指定的Python解释器加载pip模块执行命令，此时运行的是site-packages里的pip代码，升级时替换的是模块文件而非正在运行的脚本，不会出现文件占用问题，因此能顺利完成升级。

python -m pip install 的核心优势 #

• 精准匹配Python环境：当系统存在多个Python版本时，直接用pip可能调用到其他版本的pip，而python -m pip明确绑定当前调用的Python解释器对应的pip，完全避免环境混淆。
• 解决文件占用问题：升级pip本身这类需要替换自身文件的操作，只有通过模块方式运行才能绕开脚本文件锁定的限制，完成更新。
• 适配更多环境：部分环境未将pip路径加入系统PATH，直接输入pip会提示命令不存在，但只要Python能正常调用，python -m pip就能正常运行pip功能。
• 保证版本一致性：确保pip和当前使用的Python解释器版本完全对应，不会出现pip安装的包跑到其他Python环境的情况。

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