本教程旨在解决 emacs jedi python 自动补全插件在安装服务器时，因 `sexpdata` 依赖构建失败（常见于 `pip` 和 `setuptools` 兼容性问题）而导致的安装异常。文章将提供一套系统性的解决方案，包括虚拟环境管理、利用系统包管理器安装核心依赖以及重新执行 jedi 服务器安装，确保用户能够顺利配置 emacs jedi 环境。
emacs Jedi 是一个强大的 python 自动补全和代码导航工具，它依赖于一个 Python 后端服务器来提供核心功能。然而，在某些 linux 发行版（如 EndeavourOS）上，用户在执行 jedi:install-server 命令时可能会遇到安装失败，具体表现为 pip install 过程中 sexpdata 库的构建错误，通常伴随“Getting requirements to build wheel did not run successfully”和 KeyError: ‘text’ 等信息。这通常不是 pip 本身的问题，而是 setuptools 在处理 sexpdata 的 pyproject.toml 或 setup.py 文件时遇到的兼容性问题，尤其是在构建 wheel 包时。
问题根源分析
当 Emacs Jedi 尝试通过 pip 安装其所需的 Python 服务器组件时，它会拉取 jediepcserver，而 jediepcserver 又依赖于 epc 和 sexpdata。如果在构建 sexpdata 时，pip 调用的 setuptools 无法正确解析其构建元数据（例如 KeyError: ‘text’），就会导致整个安装过程中断。这种错误通常与系统环境中 pip、setuptools 或 Python 版本之间的细微不兼容性有关，尤其是在使用较新版本的 Python 或某些发行版特定的配置时。
解决方案步骤
解决此问题的关键在于绕过 pip 的构建过程，利用系统包管理器来安装问题依赖，并确保 Emacs Jedi 在一个干净的环境中运行。
1. 停用所有活动的 Python 虚拟环境
在尝试 Emacs Jedi 服务器安装之前，务必确保当前 shell 会话中没有激活任何 Python 虚拟环境。Emacs Jedi 通常会在其内部管理一个独立的 Python 环境，外部的虚拟环境可能会干扰这一过程，导致路径冲突或依赖解析错误。
要停用虚拟环境，请执行以下命令：
deactivate
如果没有任何输出，则表示当前没有活动的虚拟环境，可以跳过此步骤。
2. 通过系统包管理器安装 sexpdata
这是解决 pip 构建 sexpdata 失败的核心步骤。通过系统的包管理器安装 sexpdata 及其 Python 3 版本，可以利用预编译的二进制包，从而避免 pip 在构建 wheel 时可能遇到的兼容性问题。
请根据您的 Linux 发行版选择相应的命令：
-
对于基于 debian/ubuntu 的系统 (如 Ubuntu, Mint)：
sudo apt update sudo apt install python3-sexpdata
-
对于基于 Arch Linux 的系统 (如 EndeavourOS, Manjaro)：
sudo pacman -Syu sudo pacman -S python-sexpdata
通过系统包管理器安装后，sexpdata 将在系统 Python 环境中可用，Emacs Jedi 的安装程序将能够找到并使用它。
3. 重新执行 Emacs Jedi 服务器安装
在确认 sexpdata 已通过系统包管理器安装且没有活动的虚拟环境后，您可以尝试重新安装 Emacs Jedi 服务器。
方法一：在 Emacs 中直接执行命令（推荐）
这是最直接和推荐的方法。在 Emacs 中，按下 M-x (通常是 Alt + x)，然后输入 jedi:install-server 并回车。
M-x jedi:install-server
Emacs Jedi 将尝试在其内部管理的 Python 环境中重新安装或验证服务器组件。由于 sexpdata 已经通过系统包管理器提供，这次安装应该能够顺利完成。
方法二：在 shell 中手动执行 pip 命令（可选）
如果您希望更精细地控制安装过程，或者 Emacs 内部安装仍然遇到问题，可以尝试在 shell 中手动执行 pip 命令。请注意，这里的路径需要根据您 Emacs 配置中 jedi-core 包的实际位置进行调整。
首先，您需要找到 jedi-core 包在 Emacs elpa 目录下的路径。通常它位于 ~/.emacs.d/elpa/jedi-core-yyYYMMDD.HHMM/ 这样的结构中。
pip install --upgrade $HOME/.emacs.d/elpa/jedi-core-20210503.1315/
注意： 上述路径 jedi-core-20210503.1315/ 是一个示例，请将其替换为您系统中 jedi-core 实际安装的最新版本目录。此命令会强制 pip 升级或安装指定路径下的 jedi-core 及其依赖。
注意事项与总结
- 环境隔离： Emacs Jedi 通常会尝试在其自己的隔离环境中安装 Python 依赖。本教程的解决方案通过系统包管理器提供了一个关键依赖，这在某些情况下是必要的。
- 发行版差异： 请务必根据您使用的 Linux 发行版选择正确的包管理器命令（apt, pacman, dnf 等）。
- Python 版本： 确保您的系统 Python 3 版本与 Emacs Jedi 期望的 Python 版本兼容。通常，使用系统默认的 Python 3 即可。
- 持续问题： 如果上述步骤仍未能解决问题，请检查 Emacs 的 *Messages* 缓冲区和 *Jedi-Server* 缓冲区以获取更详细的错误日志。同时，可以尝试更新 pip 和 setuptools 到最新版本：
pip install --upgrade pip setuptools wheel
然后再次尝试 Emacs Jedi 服务器安装。
通过遵循这些步骤，您应该能够成功解决 Emacs Jedi 服务器安装中 sexpdata 依赖构建失败的问题，从而在 Emacs 中享受流畅的 Python 开发体验。