Python3.11+VS Code中Jupyter Notebook安装psutil时编译错误求助

错误原因解释 #

Could not build wheels for psutil... 这个错误的核心是：psutil是一个需要编译底层系统代码的Python库，你的环境缺少编译它所需的工具或依赖，导致无法生成对应的wheel二进制安装包，进而卡住了Jupyter相关依赖的安装流程。

具体解决步骤 #

• 先升级pip、wheel和setuptools，确保工具是最新版本，避免兼容性问题：

  python -m pip install --upgrade pip wheel setuptools
  

• 安装系统级编译依赖：
  • Windows：安装Microsoft Visual C++ Build Tools，安装时一定要勾选「Desktop development with C++」组件，安装完成后重启终端和VS Code再尝试安装。
  • macOS：在终端执行以下命令安装Xcode命令行工具：

    xcode-select --install
    

    按提示完成安装后重试。
  • Linux（Ubuntu/Debian）：通过包管理器安装编译工具和Python开发依赖：

    sudo apt-get install gcc python3.11-dev
    

    若是RHEL/CentOS系列，改用：

    sudo dnf install gcc python3-devel
    

• 手动安装psutil，再重试Jupyter安装：
  先单独执行psutil的安装命令，确认它能成功安装：

  pip install psutil
  

  成功后回到VS Code，重新触发Jupyter的安装流程，或者直接手动安装Jupyter：

  pip install jupyter
  

• 备选方案（如果编译仍失败）：
  可以直接下载对应你系统和Python3.11版本的psutil预编译wheel包，然后用pip安装该文件，比如：

  pip install psutil-5.9.5-cp311-cp311-win_amd64.whl
  

  （注意替换成对应你系统的whl文件名）

内容的提问来源于stack exchange，提问作者Syed Abdul Hannan