chore: clean repository history

kb/python-course-kb-practical-python/wiki/concepts/site-packages.md

@@ -0,0 +1,42 @@
+---
+sources: [summaries/02_Third_party.md]
+brief: site-packages 是 Python 环境中存放第三方包的典型目录，直接影响 import 能否找到已安装包。
+---
+
+# site-packages
+
+## 概念定义
+
+`site-packages` 是 Python 环境中存放第三方包的典型目录。通过 `pip` 安装的包通常会进入当前 Python 环境对应的 `site-packages`，然后由 `import` 机制在搜索路径中找到。
+
+这个主题连接 [[concepts/pip-与-PyPI]]、[[concepts/模块与-import]]、[[concepts/包与虚拟环境]] 和 [[concepts/依赖管理]]。
+
+## 为什么它重要
+
+“已经安装了包”不等于“当前程序能导入包”。更准确的问题是：包是否安装到了当前正在运行的 Python 解释器会搜索的 `site-packages` 中？
+
+```python
+import numpy
+print(numpy)
+```
+
+查看模块对象可以帮助确认实际加载位置。
+
+## 多环境问题
+
+系统 Python、用户安装目录和各个虚拟环境都可能有不同的 `site-packages`。如果 `python`、`pip` 或虚拟环境没有对齐，就会出现安装成功但导入失败的问题。
+
+## 排查顺序
+
+- 确认当前运行的是哪个 `python`；
+- 使用 `python -m pip` 而不是不确定来源的 `pip`；
+- 查看模块对象的 `__file__` 或打印模块对象；
+- 检查虚拟环境是否已激活；
+- 检查 `sys.path` 是否包含预期目录。
+
+## 相关概念
+
+- [[concepts/pip-与-PyPI]]
+- [[concepts/模块与-import]]
+- [[concepts/包与虚拟环境]]
+- [[concepts/依赖管理]]