Ubuntu22.04下Poetry/Pip安装typed-ast(1.5.4)失败的解决方法

针对Ubuntu 22.04 + Python 3.11环境下安装typed-ast(1.5.4)找不到Python.h的问题，直接执行以下操作：

1. 安装Python 3.11的开发依赖包
   Python.h属于Python开发套件的一部分，Ubuntu下需要安装对应版本的dev包：

   sudo apt update
   sudo apt install python3.11-dev
   

2. 确保基础编译工具齐全
   如果之前没装过编译依赖，先安装build-essential：

   sudo apt install build-essential
   

3. 重新执行安装命令
   用Poetry安装：

   poetry install
   

   或者用Pip：

   pip wheel --use-pep517 "typed-ast==1.5.4"
   

遇到编译阶段缺失系统文件的Python包安装问题，按以下步骤排查：

• 定位缺失文件的所属包：
  用apt-file工具查找文件对应的系统包（先安装apt-file：sudo apt install apt-file && apt-file update），比如查找Python.h：

  apt-file search Python.h
  

  结果里会明确显示对应版本的Python开发包，安装即可。

• 补齐基础编译环境：
  编译C扩展包需要gcc、make等工具，Ubuntu下直接安装build-essential就能覆盖大部分基础需求。

• 确认环境一致性：
  确保你使用的pip/poetry和目标Python版本匹配，比如用python3.11 -m pip代替pip，避免调用到其他版本的Python工具链。

• 优先尝试预编译包：
  对于有预编译wheel的包，强制使用二进制安装跳过编译：

  pip install --only-binary :all: typed-ast==1.5.4
  

• 检查版本兼容性：
  确认包版本和当前Python版本是否兼容，比如部分旧版本包可能不支持最新Python版本，此时要么升级包到兼容版本，要么降级Python到包支持的版本。

内容的提问来源于stack exchange，提问作者yevt