### 解决方案 为了成功安装 `pyicu` 并解决缺少 `Python.h` 文件的问题，需要确保开发环境已正确配置。以下是详细的解决方案： #### 1. 确认 Python 开发头文件的存在 `Python.h` 是 Python 的 C API 头文件之一，通常位于 Python 的开发包中。如果没有安装对应的开发包，则会遇到此问题。 在 Linux 上，可以通过以下命令安装 Python 开发包： ```bash sudo apt-get update && sudo apt-get install python3-dev # 对于 Debian/Ubuntu 系统 sudo yum groupinstall "Development Tools" # 对于 CentOS/RHEL 系统 ``` 对于 Windows 用户，建议通过官方渠道重新安装 Python，并勾选 **“Install developer tools and modify PATH”** 或手动确认安装路径下的 `include` 和 `libs` 存在必要的 `.h` 文件[^1]。 --- #### 2. 设置 ICU 版本环境变量 根据提供的错误信息，`setup.py` 脚本尝试读取环境变量 `ICU_VERSION`，但未找到该值，因此抛出了 `KeyError` 异常[^3]。需设置正确的 ICU 版本号以匹配目标平台上的 ICU 库版本。 执行以下命令来设置环境变量（假设使用的 ICU 版本为 70.1）： ```bash export ICU_VERSION=70.1 # 在 Unix/Linux/MacOS 中 set ICU_VERSION=70.1 # 在 Windows 命令提示符中 ``` 随后再次运行 `pip install pyicu==2.14` 进行安装。 --- #### 3. 使用预编译的二进制轮子 (Wheel) 如果本地环境中无法正常构建扩展模块，可以选择下载适合操作系统的预编译 wheel 文件并手动安装。具体方法如下： - 访问 [PyICU Wheel 下载页面](https://www.lfd.uci.edu/~gohlke/pythonlibs/#pyicu)[^5]。 - 找到与当前操作系统、架构以及 Python 版本相匹配的 whl 文件。例如，针对 Python 3.10 和 Windows AMD64 架构，应选择类似于 `PyICU‑2.12‑cp310‑cp310‑win_amd64.whl` 的文件。 下载完成后，在终端中切换至保存目录并运行以下命令完成安装： ```bash pip install PyICU‑2.12‑cp310‑cp310‑win_amd64.whl ``` --- #### 4. 替代工具链或虚拟环境管理器 当依赖项复杂时，推荐使用 Conda 创建隔离的虚拟环境并自动处理依赖关系。例如： ```bash conda create -n myenv python=3.10 icu pyicu=2.14 conda activate myenv ``` 这一步骤能够显著减少因缺失系统级组件而导致的失败风险。 --- ### 总结 上述步骤涵盖了从基础环境准备到高级替代策略的内容，适用于不同场景下的开发者需求。若仍存在问题，请进一步核实所用 ICU 库的具体版本及其兼容性。