为什么Python的site-packages目录下会出现.dist-info文件夹？

dist-info仅证明元数据注册成功，不表示模块文件已安装；常见原因包括C++编译失败、Python环境路径错配或setup.py配置缺陷，需通过pip show与python -c "import pyreadr; print(pyreadr.__file__)"定位后重装。

dist-info 是包安装成功的元数据凭证，不是模块本身

.dist-info 目录是 Python 包安装过程的“收据”，它证明 pip 已成功解析、下载并注册了该包——但不保证模块代码真的被复制进来了。你看到 pyreadr-0.0.1.dist-info 而没有 pyreadr/ 文件夹，说明安装流程卡在了“写入模块文件”这一步，元数据写入成功，源码或编译产物却没落盘。

为什么只有 dist-info？常见断点就这三类

真正导致模块缺失的环节，集中在安装链后半段：

• 编译失败：pyreadr 含 C++ 扩展，Windows 缺 Visual Studio Build Tools，Linux 缺 build-essential 和 python3-dev，macOS 缺 xcode-select --install，都会让构建中止，只留下 .dist-info
• 路径错配：用 pip 安装，但实际运行 Python 的是另一个环境（比如 conda 环境、系统 Python、或 VS Code 自动选错解释器），pip show pyreadr 显示的 Location 跟 python -c "import sys; print(sys.path)" 里第一个 site-packages 不一致
• setup.py 配置缺陷：如果是本地 pip install .，setup.py 里漏写 packages=find_packages() 或没声明 py_modules=['bacon']，setuptools 就不会打包对应模块，wheel 里压根没它们

验证和修复必须分两步走：先定位，再重装

别急着删 .dist-info，它能帮你确认是否真装错了地方：

Python 3.14.3

微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。

• 执行 pip show pyreadr，记下 Location: 路径；再运行 python -c "import pyreadr; print(pyreadr.__file__)" —— 如果报 ModuleNotFoundError，而前者有输出，就坐实了“装错环境”
• 强制清理重装：用 pip uninstall pyreadr && pip install --no-cache-dir --force-reinstall pyreadr，加 --no-cache-dir 防止 pip 复用上次失败构建的残缺 wheel
• 仍失败？直接看日志：加 -v 参数，pip install -v pyreadr 2>&1 | grep -E "(error|adding|copying)"，重点找 adding pyreadr/ 是否出现，没出现就是构建阶段已退出

dist-info 本身不能删，但它的存在不等于能 import

.dist-info 里的 RECORD 文件记录了“本该安装哪些文件”，如果里面列了 pyreadr/__init__.py 却实际不存在，说明安装中途被中断或权限拒绝。这种情况下，手动删掉整个 pyreadr-*.dist-info 目录毫无意义——下次安装还会生成一个，问题根源不在元数据，而在构建或复制环节。真正要盯住的，是 pip install 最后几行有没有 Successfully installed，以及 import 时 Python 解释器到底在搜哪个 site-packages。