5.4 KiB
doc_type, full_text
| doc_type | full_text |
|---|---|
| short | sources/02_Third_party.md |
02_Third_party 总结
本文介绍 Python 第三方模块的基本使用背景：Python 自带大量标准库模块，但更丰富的生态来自第三方模块，通常可通过 PyPI 或搜索引擎查找。文章重点解释模块导入路径、标准库与第三方包的位置、pip 安装方式、常见权限与依赖问题，以及使用虚拟环境隔离项目依赖的基础流程。
核心内容
Python 模块来源
Python 模块大致可分为两类：
- 标准库模块：随 Python 安装一起提供，体现了 Python “batteries included”的理念。
- 第三方模块：由社区或组织发布，通常可在 Python Package Index（PyPI）中查找。
第三方依赖管理在 Python 中一直是持续演进的话题，本文只覆盖理解其基本机制所需的入门知识。相关主题可延伸为 Python 包管理、PyPI。
模块搜索路径：sys.path
Python 的 import 语句会按照 sys.path 中列出的目录顺序查找模块。
import sys
sys.path
如果要导入的模块不在这些目录中，就会触发 ImportError。
这一点对排查导入问题非常重要：当模块无法导入、导入了错误版本，或行为与预期不一致时，首先应检查 Python 正在搜索哪些目录。相关概念可关联到 Python 导入机制。
查看模块实际加载位置
在 REPL 中直接查看一个已导入模块，可以显示该模块来自哪个文件路径，是调试 import 问题的实用技巧。
例如标准库模块：
import re
re
可能显示：
<module 're' from '/usr/local/lib/python3.x/re.py'>
第三方模块通常位于 site-packages 目录中，例如：
import numpy
numpy
可能显示：
<module 'numpy' from '/usr/local/lib/python3.x/site-packages/numpy/__init__.py'>
这说明：
- 标准库模块通常来自 Python 安装目录下的库目录。
- 第三方模块通常安装在
site-packages中。 - 直接查看模块对象有助于确认实际导入的文件位置。
- 示例中的
python3.x代表本机实际 Python 版本。
使用 pip 安装第三方模块
最常见的第三方包安装方式是使用 pip：
python3 -m pip install packagename
该命令会下载指定包，并安装到当前 Python 环境对应的 site-packages 目录中。
使用 python -m pip 的形式可以减少“pip 对应的不是当前 Python 解释器”的混淆。相关主题可扩展为 pip 与 site packages。
常见问题
安装第三方包时可能遇到的问题包括：
- 当前 Python 安装不由自己控制，例如公司批准的统一安装版本。
- 使用的是操作系统自带的 Python。
- 没有权限向全局 Python 环境安装包。
- 包之间或包与系统之间存在其他依赖问题。
这些问题说明，全局安装第三方包并不总是可靠或可行，因此需要隔离环境。
虚拟环境
解决包安装和环境污染问题的常见方法是创建 Python 虚拟环境。
使用标准 Python 安装时，可以通过 venv 创建一个独立环境：
python -m venv mypython
该命令会创建一个名为 mypython 的目录，其中包含一个独立的 Python 环境。在 Unix 系统中可通过以下方式激活：
source mypython/bin/activate
激活后，shell 提示符通常会变为类似：
(mypython) bash %
此时运行的 python 命令将指向虚拟环境中的解释器。可以在该环境中安装包，例如：
python -m pip install pandas
虚拟环境适合实验、试用不同包，以及避免污染系统 Python。对于实际应用程序的依赖管理，还需要更系统地记录和复现依赖环境。
应用程序中的第三方依赖
如果开发的是一个应用程序，并且它依赖特定第三方包，问题不仅是“如何安装”，还包括：
- 如何创建包含应用代码与依赖的环境。
- 如何保存依赖版本。
- 如何让他人或部署系统复现同样的环境。
- 如何应对 Python 包管理生态工具不断变化的问题。
文章没有给出固定方案，而是建议参考 Python Packaging User Guide，因为 Python 打包与依赖管理实践一直在变化。该部分可与 Python 应用分发、concepts/依赖管理 关联。
练习
Exercise 9.4：创建虚拟环境
练习要求复现以下流程：
- 创建虚拟环境。
- 激活虚拟环境。
- 在虚拟环境中安装
pandas。
这能帮助理解第三方包并不是“安装到 Python 语言本身”，而是安装到某个具体 Python 环境中。
关键要点
sys.path决定import语句搜索模块的位置。- 直接在 REPL 中查看模块对象，可以确认模块实际加载路径。
- 标准库模块通常位于 Python 安装目录；第三方模块通常位于
site-packages。 pip是安装第三方模块的常用工具。- 权限、系统 Python、公司环境和依赖冲突都会导致安装问题。
- 虚拟环境为每个实验或项目提供独立 Python 环境。
- 应用程序级依赖管理比简单安装包更复杂，应参考官方 Python Packaging User Guide。