pip 不会识别手动复制到 site-packages 的文件，因为其安装过程包含写入 RECORD、生成 .dist-info、解析依赖、注册 entry_points 等完整元数据操作；手动复制跳过这些步骤，导致 pip list/show/uninstall 均失效，且强行补全元数据极易失败。
pip 不会扫描或识别你手动复制到 site-packages 的文件，这是设计使然，不是 bug。
为什么 pip install 之后才“生效”？
pip 安装包不只是把文件丢进 site-packages，它还会：
- 写入
RECORD文件（记录每个安装的文件路径和哈希值） - 生成或更新
.dist-info或.egg-info元数据目录 - 解析并写入依赖信息到
INSTALLER、WHEEL等元数据文件 - 触发
entry_points注册（如命令行工具）
手动复制跳过了全部这些步骤，所以 pip list 看不到，pip show 查不到，pip uninstall 也无从下手。
手动复制后想让 pip “认领”这个包？别试了
强行补全元数据极其脆弱，且不同 pip 版本、Python 版本、打包格式（wheel/egg/sdist）处理方式不同。常见失败点包括：
立即学习“Python免费学习笔记（深入）”；
-
pip list仍不显示——因为缺少合法的.dist-info目录名（必须含版本号，如requests-2.31.0.dist-info） -
import能用但pip check报依赖冲突——因为requires.txt没写或写错格式 -
pip install --force-reinstall可能删掉你的手动文件——pip 认为那是“损坏安装”，优先清理
这不是配置问题，是机制层面的隔离。想绕过 pip 的安装生命周期，就等于放弃 pip 的所有管理能力。
正确做法：用 pip 安装，而不是复制
如果你已有源码或 wheel 文件，直接交给 pip 处理：
- 安装本地 wheel：
pip install ./some_package-1.2.3-py3-none-any.whl - 安装本地源码目录（含
setup.py或pyproject.toml）：pip install -e ./path/to/package（开发模式）或pip install ./path/to/package - 安装压缩包：
pip install ./package.tar.gz
如果只有 .py 文件没打包，最简方案是建个最小 pyproject.toml：
[build-system] requires = ["setuptools>=45", "wheel"] build-backend = "setuptools.build_meta" [project] name = "myutils" version = "0.1.0"
然后 pip install -e . 即可被 pip 完整识别和管理。
真正麻烦的从来不是“怎么塞进去”，而是“塞进去之后 pip 还能不能管”。手动复制等于主动放弃管理权——这点在 CI/CD、多环境部署或协作时会立刻暴露出来。
