使用 pip (最推荐)
pip 是 Python 的官方包安装器，从 Python 3.4+ 开始，pip 通常会与 setuptools 一起预装，使用 pip 来安装或升级 setuptools 是最简单、最标准的方法。
升级到最新版本
即使您已经安装了 setuptools，也建议经常升级到最新版本,因为它包含错误修复和新功能。
在命令行（终端）中运行以下命令：
# 对于 Python 3 python -m pip install --upgrade setuptools # 对于 Python 2 (如果您的系统同时安装了两个版本) python2 -m pip install --upgrade setuptools
命令解释:
python -m pip: 这种方式可以确保您使用的是当前 Python 环境关联的pip,避免因系统环境复杂而导致的版本冲突问题。--upgrade: 这个标志告诉pip将setuptools升级到可用的最新版本。
安装特定版本
如果您需要安装一个特定版本的 setuptools（为了兼容某个旧项目）,可以指定版本号：
# 安装 58.2.0 版本 python -m pip install setuptools==58.2.0
使用 ensurepip (适用于创建新的 Python 环境)
如果您创建了一个全新的 Python 虚拟环境，但发现里面没有 pip 或 setuptools，可以使用 ensurepip 模块来安装它们。
在命令行中运行：
# 确保当前 Python 环境拥有 pip 和 setuptools python -m ensurepip --upgrade
这个命令会检查并安装 pip，而 pip 在安装时会自动将其依赖的 setuptools 也一并安装或升级。
使用 get-pip.py 脚本 (适用于修复严重损坏的环境)
如果您的 pip 或 setuptools 安装已经严重损坏，导致上述命令都无法执行，那么最可靠的“终极修复”方法是使用官方的 get-pip.py 安装脚本，这个脚本会安装最新版本的 pip，并连带安装 setuptools 和 wheel。
-
下载
get-pip.py脚本 打开浏览器，访问以下地址并保存文件： https://bootstrap.pypa.io/get-pip.py -
运行脚本安装 打开命令行，使用
cd命令切换到您保存get-pip.py文件的目录,然后运行：# 使用您想修复的 Python 解释器来运行这个脚本 python get-pip.py
如果您有多个 Python 版本,请使用对应的可执行文件，
python3 get-pip.py # 或 python2.7 get-pip.py
这个过程会下载并安装
pip，pip会自动处理setuptools的安装。
常见问题与解决方案 (FAQ)
问题1：pip 命令找不到
错误信息:
'pip' is not recognized as an internal or external command, operable program or batch file. (Windows)
zsh: command not found: pip (macOS/Linux)
原因与解决:
这通常意味着 pip 所在的目录没有被添加到系统的 PATH 环境变量中。
- Windows: 在开始菜单搜索 "编辑系统环境变量"，点击 "环境变量..."，在 "系统变量" 中找到
Path变量，然后点击 "编辑..."，将 Python 的Scripts文件夹路径（C:\Python39\Scripts）添加进去。 - macOS/Linux: 您可以将 Python 的
bin目录（/usr/local/bin）添加到~/.bashrc或~/.zshrc文件中，然后运行source ~/.bashrc或source ~/.zshrc使其生效。
最简单的解决方法： 直接使用 python -m pip 代替 pip 命令，如上所示，这通常能绕过 PATH 问题。
问题2：权限问题
错误信息:
PermissionError: [Errno 13] Permission denied: '/usr/local/lib/python3.9/site-packages/setuptools'
原因与解决:
这表示您没有权限在系统的 Python 目录（通常是 /usr/local/ 或 C:\PythonXX\）下写入文件。最佳实践是避免使用管理员权限来安装全局包。
推荐做法：使用虚拟环境 虚拟环境可以为每个项目创建一个隔离的 Python 环境,避免包之间的冲突和权限问题。
-
创建虚拟环境 (在项目文件夹下)
# 对于 Python 3 python -m venv myenv
-
激活虚拟环境
- Windows:
myenv\Scripts\activate
- macOS/Linux:
source myenv/bin/activate
激活后，您的命令行提示符前会出现
(myenv)。
- Windows:
-
在虚拟环境中安装
setuptools现在您可以在虚拟环境中自由安装包，而不会影响系统 Python。python -m pip install --upgrade setuptools
-
退出虚拟环境 完成工作后,只需运行：
deactivate
| 场景 | 推荐命令 | 备注 |
|---|---|---|
| 日常升级/安装 | python -m pip install --upgrade setuptools |
最常用、最安全的方法。 |
| 修复全新环境 | python -m ensurepip --upgrade |
适用于刚创建的、缺少工具的 Python 环境。 |
| 终极修复 | python get-pip.py |
当 pip 和 setuptools 完全损坏时使用。 |
| 避免权限问题 | python -m venv myenv source myenv/bin/activate python -m pip install ... |
强烈推荐的最佳实践，为每个项目使用独立环境。 |
对于绝大多数用户，使用 python -m pip install --upgrade setuptools 是最直接有效的解决方案，如果遇到权限问题，请务必使用虚拟环境。
