Python 模块安装全攻略：从基础到进阶
在 Python 的开发世界里，丰富的模块是其强大功能的重要支撑。无论是进行数据分析、Web 开发，还是人工智能项目，安装和管理模块都是必不可少的技能。本教程将带你从 Python 模块安装的基础知识起步，逐步深入到进阶技巧，让你轻松掌握模块安装的各种方法。
目录
一、基础概念
（一）pip
（二）virtual environment（虚拟环境）
（三）venv
（四）virtualenv
（五）Python Package Index
（六）Python Packaging Authority
（七）distutils
基础概念关系图：
二、基本使用方法
（一）安装模块
（二）升级模块
（三）创建和使用虚拟环境
三、常见安装任务解答
（一）在 Python 3.4 之前的版本安装 pip
（二）只为当前用户安装软件包
（三）安装科学计算类 Python 软件包
（四）使用并行安装的多个 Python 版本
四、常见安装问题及解决
（一）在 Linux 系统 Python 版本上安装
（二）未安装 pip
（三）安装二进制编译扩展
五、进阶技巧
（一）pip 高级用法
（二）虚拟环境管理
总结
TAG： Python 模块安装、pip、虚拟环境、venv、Python Package Index
一、基础概念
（一）pip
pip 是 Python 的首选安装程序，从 Python 3.4 开始，它就默认被包含在 Python 二进制安装程序中。简单来说，pip 就像是一个智能的 “快递员”，能帮你从 Python Package Index 这个 “大仓库” 里快速准确地获取并安装你需要的模块及其依赖项。例如，当你想要安装一个用于处理数据的pandas模块时，只需在命令行中输入python -m pip install pandas，pip 就会自动去 “仓库” 里找到pandas模块及其所依赖的其他模块，并将它们安装到你的系统中。
（二）virtual environment（虚拟环境）
虚拟环境是一种半隔离的 Python 环境。想象一下，你同时在进行两个不同的项目，项目 A 需要使用numpy的 1.19 版本，而项目 B 则需要numpy的 1.21 版本。如果没有虚拟环境，这两个版本的numpy就会在系统中产生冲突。但有了虚拟环境，就好比为每个项目都打造了一个独立的 “小房间”，每个 “小房间” 里可以安装不同版本的模块，相互之间不会干扰。这样，项目 A 可以在自己的 “房间” 里安心使用numpy 1.19 版本，项目 B 则可以使用 1.21 版本。
（三）venv
venv 是创建虚拟环境的标准工具，从 Python 3.3 开始成为 Python 的组成部分。从 Python 3.4 起，它还会默认把 pip 安装到所创建的全部虚拟环境中。当你使用python -m venv myenv（这里的myenv是你给虚拟环境取的名字）命令创建虚拟环境时，venv 不仅会帮你搭建好这个独立的环境，还会把 pip 也安装进去，方便你在这个环境里安装其他模块。
（四）virtualenv
virtualenv 是 venv 的第三方替代工具，也是 venv 的前身。在 Python 3.4 之前的版本中，如果系统没有提供 venv，或者不会自动安装 pip 到虚拟环境，这时就可以使用 virtualenv。比如，在 Python 2.7 的环境中，想要创建虚拟环境，virtualenv 就是一个很好的选择。它可以让你在旧版本的 Python 中也能享受到虚拟环境带来的便利。
（五）Python Package Index
Python Package Index 是一个开源许可的软件包公共存储库，所有 Python 用户都能在这里获取各种各样的模块。它就像是一个巨大的 “软件超市”，里面摆满了各种开发者贡献的模块 “商品”，你可以根据自己的需求随意挑选和安装。无论是处理数据的、进行网络请求的，还是开发图形界面的模块，都能在这里找到。
（六）Python Packaging Authority
Python Packaging Authority 是一个由开发人员和文档作者组成的团队，他们负责维护和改进标准打包工具，以及相关的元数据和文件格式标准。他们基于 GitHub 来管理各种工具、文档和问题追踪系统，就像是 “软件超市” 的管理员，确保 “超市” 里的 “商品”（模块）都符合一定的标准，并且能正常使用。
（七）distutils
distutils 是最初的构建和分发系统，早在 1998 年就加入了 Python 标准库。虽然现在直接使用它的方式已经逐渐被淘汰，但它仍然是当前打包和分发架构的基础。就好比是一座高楼的地基，虽然平时看不到它，但整座楼的稳定都离不开它。它的名字还以其他方式存在，比如用于协调 Python 打包标准开发流程的邮件列表就叫这个名字。
基础概念关系图：
此图展示了 Python 模块安装中关键术语间的关系。Python Package Index 是模块的 “仓库”，pip 从这里获取模块；venv 和 virtualenv 用于创建 virtual environment；Python Packaging Authority 维护相关标准，distutils 是基础构建分发系统。
二、基本使用方法
（一）安装模块
安装最新版本：想要安装某个模块的最新版本及其依赖项，在命令行中输入python -m pip install SomePackage，这里的SomePackage就是你要安装的模块名称。例如，安装用于生成随机数的random模块（假设它在 Python Package Index 上），就可以输入python -m pip install random。安装特定版本：如果需要安装特定版本的模块，可以使用python -m pip install SomePackage==1.0.4这种格式，其中1.0.4就是你指定的版本号。比如，你知道某个项目依赖requests模块的 2.25.1 版本，就可以通过python -m pip install requests==2.25.1来安装。安装最小版本：当你希望安装的模块版本不低于某个特定版本时，使用比较运算符，如python -m pip install "SomePackage>=1.0.4" 。例如，numpy模块从 1.18 版本开始有一些新特性，你希望安装的numpy至少是这个版本，就可以输入python -m pip install "numpy>=1.18" 。
（二）升级模块
如果已经安装了某个模块，想要升级到最新版本，可以运行python -m pip install --upgrade SomePackage 。例如，你之前安装的Flask框架有了新的版本，就可以通过这个命令来升级，让你的项目享受到新功能和修复的漏洞。
（三）创建和使用虚拟环境
创建虚拟环境：使用venv模块创建虚拟环境非常简单，在命令行输入python -m venv myenv，这里的myenv是你自定义的虚拟环境名称，你可以根据项目的名称或用途来命名，比如project1_env , 不过我们通常建议使用 venv 这个名字来命名， 既： python -m venv venv激活虚拟环境：在 Windows 系统下，进入虚拟环境的 Scripts 目录，然后执行activate命令；在 Linux 和 macOS 系统下，执行source myenv/bin/activate 。激活后，你会发现命令行提示符前面多了虚拟环境的名称，这就表示你已经进入了这个独立的 “小环境”。在虚拟环境中安装包：激活虚拟环境后，就可以像在普通环境中一样使用pip命令安装模块了。例如，python -m pip install SomePackage ，安装的包只会存在于这个虚拟环境中，不会影响系统的其他环境。
三、常见安装任务解答
（一）在 Python 3.4 之前的版本安装 pip
在 Python 3.4 之前，pip 并没有默认集成在 Python 中，需要进行 “引导安装”。具体的安装步骤可以参考 Python 软件包用户指南。这是因为早期的 Python 版本在设计上没有把 pip 作为标准配置，所以需要手动安装才能使用这个强大的包管理工具。
（二）只为当前用户安装软件包
如果你不想把软件包安装到系统全局，而只想让当前用户使用，可以在安装命令中添加--user选项，即python -m pip install --user SomePackage 。这种方式适用于你没有系统管理员权限，或者不想影响其他用户的情况。比如在学校的机房，你可以使用这种方式安装自己需要的模块，而不会影响其他同学使用电脑。
（三）安装科学计算类 Python 软件包
许多科学计算类的 Python 软件包，像numpy、pandas等，往往有复杂的二进制编译文件依赖。直接使用pip安装可能会遇到各种问题，比如编译失败等。在这种情况下，通过其他方式安装可能会更容易，比如使用 Anaconda。Anaconda 是一个专门用于科学计算的 Python 发行版，它集成了很多常用的科学计算库，并且安装和管理都很方便。你可以在 Anaconda 官网下载安装包，然后通过 Anaconda Navigator 或命令行来管理和安装科学计算类软件包。
（四）使用并行安装的多个 Python 版本
在 Linux、macOS 及其他 POSIX 系统中：可以使用带版本号的 Python 命令配合-m开关选项来运行特定版本的pip 。例如，python2 -m pip install SomePackage（默认使用 Python 2 版本的 pip 进行安装）、python3.4 -m pip install SomePackage（指定使用 Python 3.4 版本的 pip 进行安装）。在 Windows 系统中：使用py Python 启动器命令配合-m开关选项。比如，py -2 -m pip install SomePackage（默认使用 Python 2 版本的 pip）、py -3.4 -m pip install SomePackage（指定使用 Python 3.4 版本的 pip）。
四、常见安装问题及解决
（一）在 Linux 系统 Python 版本上安装
Linux 系统通常会自带一个 Python 版本。如果直接使用这个系统自带的 Python 版本来安装软件包，可能会遇到一些问题。因为安装软件包需要系统 root 权限，而随意使用 root 权限安装可能会干扰到系统包管理器和其他系统组件的正常运作。比如，不小心升级了系统组件依赖的某个模块，可能会导致系统组件无法正常工作。所以，在 Linux 系统上，建议使用虚拟环境或分用户安装的方式来安装软件包，这样可以避免对系统造成不必要的影响。
（二）未安装 pip
如果系统默认没有安装 pip，可以运行python -m ensurepip --default-pip来安装。此外，还有其他一些资源可以帮助你安装 pip，你可以在网上搜索相关教程，根据自己的系统环境选择合适的方法。
（三）安装二进制编译扩展
Python 在安装一些模块时，常常依赖基于源代码的发布方式，这就需要最终用户在安装过程中使用源码来编译生成扩展模块。不过，随着二进制码wheel格式的出现，情况有所改善。现在，通过 Python Package Index 至少可以获取 Windows 和 macOS 版的 wheel 文件。这意味着用户可以更频繁地安装预编译扩展，而不用自己去编译，大大降低了安装的难度。对于一些尚未提供预编译 wheel 文件的扩展模块，一些用于安装科学计算类软件包的解决方案也能帮助用户在无需进行本机编译的情况下获取二进制码扩展模块。
五、进阶技巧
（一）pip 高级用法
指定安装源：在国内，由于网络原因，直接从国外的 Python Package Index 下载模块可能会比较慢。这时，我们可以指定国内的镜像源来加速下载。比如，使用清华镜像源，命令为python -m pip install SomePackage -i https://pypi.tuna.tsinghua.edu.cn/simple 。除了清华镜像源，还有阿里云、豆瓣等镜像源可供选择，你可以根据自己的网络情况选择最合适的镜像源。安装包管理：pip freeze 命令可以列出当前环境中已安装的所有包及其版本信息。这在项目部署时非常有用，你可以把这些信息保存到一个requirements.txt文件中，然后在其他环境中使用pip install -r requirements.txt命令，就可以快速安装项目所需的所有包，确保各个环境的一致性。
pip freeze使用示例
（二）虚拟环境管理
创建虚拟环境时指定 Python 版本：使用virtualenv时，如果你想创建一个使用特定 Python 版本的虚拟环境，可以通过--python选项来指定。例如，virtualenv --python=/usr/bin/python3.6 myenv ，这样就创建了一个使用 Python 3.6 版本的虚拟环境myenv 。虚拟环境克隆：当你已经有一个配置好的虚拟环境，想要快速创建一个一模一样的环境时，可以使用虚拟环境克隆。比如，virtualenv -c myenv_clone myenv ，这条命令会把myenv虚拟环境克隆到myenv_clone，myenv_clone中会包含myenv已安装的所有包，方便项目的迁移和复制环境。
总结
本文全面介绍了 Python 模块安装知识，从关键术语、基本使用方法，到常见任务处理和安装问题解决，还对重点知识点进行了扩展。掌握这些内容，读者能更高效地安装和管理 Python 模块，为开发工作奠定坚实基础。安装模块时，要根据实际情况选择合适的方法，遇到问题多参考官方文档和相关资源https://docs.python.org/zh-cn/3.12/installing/index.html。
TAG： Python 模块安装、pip、虚拟环境、venv、Python Package Index
相关知识参考： macos pyenv 安装python tk 、tkinter图形库方法步骤和使用总结_macos tkinter-CSDN博客
macos 使用port查询并安装python2, python3多版本, 设置默认python版本方法_macos 查看python版本-CSDN博客