Eclipse Python自动补全怎么设置？-杰瑞科技汇

核心概念：PyDev 和 Jedi

在 Eclipse 中做 Python 开发，PyDev 是核心插件，它负责语法高亮、调试、代码分析等。

（图片来源网络，侵删）

而代码自动补全的“大脑”通常是 Jedi，Jedi 是一个静态分析库，专门为 Python 的自动补全而设计，非常智能，能理解上下文、导入、函数参数等，PyDev 默认就集成了 Jedi。

我们的优化工作主要围绕 PyDev 插件的设置 和 Jedi 库 展开。

如果你还没有安装 PyDev,请先完成这一步。

安装完成后，PyDev 会自动为你配置基本的 Python 解释器。

（图片来源网络，侵删）

确保 PyDev 使用的是你正确的 Python 环境,这对于智能补全至关重要。

打开窗口: Window -> Preferences (在 macOS 上是 Eclipse -> Preferences)。
导航到 PyDev: 在左侧树状菜单中，找到并展开 PyDev -> Interpreter - Python。
选择解释器:
- 点击右侧的 New... 按钮。
- 在弹出的窗口中，点击 Browse...，然后选择你的 Python 安装路径下的 python.exe (Windows) 或 python (macOS/Linux)。
- 给这个解释器起一个名字，Python 3.9。
- 点击 OK。
应用更改: 回到 Interpreter - Python 主界面，你会看到你刚刚添加的 Python 解释器，点击右下角的 OK 或 Apply。

为什么这一步很重要？ PyDev 需要知道你的 Python 环境中安装了哪些库（如 numpy, pandas, requests 等），配置解释器后，PyDev 会扫描这些库，这样你在代码中输入 np. 时，才能提示出 numpy 的所有函数和属性。

现在我们来调整 PyDev 的代码辅助设置,让它更符合你的使用习惯。

再次进入 Window -> Preferences，导航到 PyDev -> Editor -> Code Completion。

（图片来源网络，侵删）

Auto-Activation: 这是自动触发补全的功能。
- Auto-activation triggers for Python: 这里默认是 .，这意味着你输入一个点.` 后，PyDev 会自动弹出补全列表。
- 你可以在这里添加其他字符， (用于补全函数参数) 或 (用于显示函数签名)。
- Delay in ms: 触发延迟，毫秒数，数值越小，提示越快，但可能会对性能有轻微影响，默认的 200ms 是一个很好的平衡点。

Case sensitivity for completion: 补全时的字母大小写敏感度，建议保持 None (不敏感)，这样输入 req 就能匹配到 requests。
Sort by: 排序方式。
- Relevance (推荐): 按相关性排序，最常用的、最匹配的项会排在前面。
- Name: 按字母顺序排序。
Insert single proposals automatically: 如果你从补全列表中选择了唯一的一项，是否自动插入它，默认开启,很方便。
Show advanced proposals (jedi, ...):
- 务必确保这个选项是勾选的！ 这就是启用 Jedi 高级智能补全的关键。

导航到 PyDev -> Jedi。

启用 Jedi: 确保 Use Jedi as the engine for code completion 是勾选的，这是现代 PyDev 的默认设置。
路径解析: Additional Path for jedi: 通常你不需要修改这里，PyDev 会自动找到它自带的 Jedi 库，如果你安装了系统级的 Jedi，可以在这里指定路径,但一般不推荐。
超时设置:
- Timeout for completion (ms): 如果你的项目非常大，补全可能会慢，可以适当增加这个超时时间，比如从 1000ms 增加到 2000ms。
- Timeout for analysis (ms): 同理,可以适当增加。

如果你发现 PyDev/Jedi 的补全在某些情况下（比如处理非常复杂的库或大型项目）还不够强大，那么可以考虑安装 LSP 插件，LSP 是一个更现代、更通用的语言服务器协议，许多流行的编辑器（如 VS Code）都使用它。

优点:

如何安装:

安装 LSP 插件:
- Help -> Eclipse Marketplace...
- 搜索 "Eclipse LSP4E" 和 "Eclipse LSP4J"，通常安装一个包含这两个的包即可（如 "Eclipse LSP Integration"）。
- 安装并重启。
配置 Python 语言服务器:
- Window -> Preferences -> LSP -> Language Servers。
- 点击 Add...，选择 PyLS (Python Language Server，由 Microsoft 维护，基于 Pyright 和 Jedi)。
- 在 Command 字段中，你需要提供一个启动 pyls 的命令，最简单的方式是先通过 pip 安装它：
```
pip install python-lsp-server
```
- 安装后，Command 可以填写 pyls 或 python-lsp-server。Arguments 通常留空。
- 点击 OK。
关联文件类型:
- 在同一个 LSP 偏好设置窗口，确保 Python 文件类型关联到了 PyLS 服务器。

安装 LSP 后，Eclipse 的 Python 开发体验会向 VS Code 靠拢,补全功能会非常出色。

如果自动补全还是不工作,可以检查以下几点：

文件编码: 确保你的 Python 文件保存为 UTF-8 编码，在 Eclipse 中，右键点击文件 -> Properties -> Resource -> Text file encoding。
项目设置: 右键点击你的项目 -> Properties -> PyDev - Interpreter/Globals,确保解释器配置正确。
禁用其他插件: 如果安装了其他代码分析或美化插件（如 Pylint 插件），可能会与 PyDev 冲突,尝试临时禁用它们看看问题是否解决。
重启 Eclipse: 有时候简单的重启就能解决很多奇怪的问题。
检查 PyDev 控制台: PyDev 内部出错，错误信息可能会显示在 Window -> Show View -> PyDev Console 中。

给你的建议路径：

希望这份详细的指南能帮助你在 Eclipse 中获得流畅的 Python 自动补全体验！