必须确认虚拟环境已激活：提示符前应显示环境名（如(myenv)），并用which python或where python验证路径指向环境内python；否则pip install pandas将安装到错误环境。
确认虚拟环境是否真正激活
很多“安装失败”其实压根没发生在目标环境中。执行 pip install pandas 前，必须看到命令行提示符开头有括号标注的环境名（如 (myenv) 或 (.venv)），否则你装的是系统全局或另一个环境的包。
- Windows 下激活后应显示类似：
myenv\Scripts\activate.bat运行后提示符变更为(myenv) C:\... - macOS/Linux 下运行
source myenv/bin/activate后，提示符前应出现(myenv) $ - 验证方式：运行
which python（macOS/Linux）或where python（Windows），输出路径必须指向myenv目录内的python可执行文件
pip 和构建工具版本过低导致 subprocess-exited-with-error
pandas ≥2.0 强制使用 PEP 517 构建协议，旧版 pip 或 <code>setuptools 无法解析 <code>pyproject.toml 中的构建配置，直接在 “Preparing metadata” 阶段崩溃——这不是网络问题，也不是权限问题，是协议不兼容。
- 先升级关键工具：
python -m pip install --upgrade pip setuptools wheel - 如果仍报
subprocess-exited-with-error × Preparing metadata，说明升级未生效，检查是否在正确环境中执行（见上一条） - 极少数情况需强制重装 pip：
python -m pip install -U --force-reinstall pip
安装时卡住、超时或下载失败
默认 PyPI 源在国外，国内用户常遇到缓存命中但实际下载中断、轮询失败等问题，表现为长时间无响应或 ReadTimeoutError。
- 临时换源安装：
pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn - 永久配置镜像（推荐）：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - 若仍失败，加
--default-timeout=100延长连接等待时间
依赖缺失或系统级编译工具未就绪
虽然 pandas 二进制 wheel 通常免编译，但某些平台（如树莓派 ARM、老旧 Linux 发行版）或指定源码安装时，会触发本地构建，此时缺 gcc、gfortran、libatlas 等将直接失败。
- Ubuntu/Debian 系统补依赖：
sudo apt-get install build-essential libatlas-base-dev gfortran - macOS 补 Xcode 命令行工具：
xcode-select --install - Windows 用户确保已安装 Microsoft C++ Build Tools（非仅 Visual Studio）
- 实在不行，优先用预编译 wheel：
pip install --only-binary=numpy,pandas pandas
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
