chore: clean repository history

kb/python-course-kb-practical-python/wiki/summaries/02_Third_party.md

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