MacOS 15.5（M2）+Python3.13.3环境下安装spaCy失败求助

问题场景 #

在全新venv环境中，严格按照spaCy官方指引执行以下命令安装spacy[apple]：

pip install -U pip setuptools wheel
pip install -U 'spacy[apple]'

安装失败，核心错误为：

In file included from ../numpy/_core/src/umath/string_ufuncs.cpp:20:
            ../numpy/_core/src/umath/string_fastsearch.h:132:5: error: no type named 'ptrdiff_t' in namespace 'std'; did you mean simply 'ptrdiff_t'?

已更新Xcode环境，排查推测是numpy 2.2.6版本兼容性问题，但未在spaCy文档找到对应方案，旧StackOverflow相关方案合理性不足。

解决方案 #

通过指定兼容的numpy版本规避编译问题，步骤如下：

1. 卸载当前可能存在的高版本numpy：

pip uninstall -y numpy

2. 安装与Apple Silicon环境兼容的numpy版本（推荐<=2.1.4）：

pip install numpy<=2.1.4

3. 再次执行spacy[apple]安装命令：

pip install -U 'spacy[apple]'

或者直接合并为一行命令，一次性指定版本限制：

pip install -U 'spacy[apple]' numpy<=2.1.4

说明 #

numpy 2.2.x系列在Apple Silicon平台的编译链中存在头文件定义兼容问题，目前spaCy官方文档尚未同步更新版本限制，通过锁定低版本numpy可直接解决该编译报错。

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