Eclipse 本身是一个 Java 开发环境,但它通过强大的插件机制支持多种语言,对于 Python 开发,最流行和功能最强大的插件就是 PyDev。

核心概念:PyDev
PyDev 是一个为 Eclipse IDE 提供的 Python 开发环境插件,它将 Eclipse 转变成一个功能齐全的 Python IDE,支持:
- 代码编辑:语法高亮、代码折叠、自动补全。
- 代码分析:实时错误检查、代码风格提示(Pylint 集成)。
- 调试:强大的图形化调试器,支持设置断点、查看变量、单步执行等。
- 代码重构:重命名、提取方法等。
- 单元测试:与 Python 的
unittest模块无缝集成。 - 代码模板:快速生成常用代码结构(如
if __name__ == "__main__":)。 - 代码导航:快速跳转到定义、查看大纲等。
第一步:安装 PyDev 插件
在开始之前,请确保你已经安装了 Eclipse,Eclipse for RCP/RAP Developers 或 Eclipse for Java Developers 都是不错的选择,它们自带了 Oomph 安装器,可以方便地管理插件。
- 打开 Eclipse,进入
Help->Install New Software...。 - 在 "Work with" 下拉框中,如果还没有 PyDev 的更新地址,点击
Add...。- Name: 输入
PyDev(或任何你喜欢的名字)。 - Location: 输入 PyDev 的更新站点地址:
http://pydev.org/updates
- Name: 输入
- 点击
Add后,Eclipse 会开始扫描可用的软件,在列表中勾选 "PyDev"。 - 点击
Next,然后仔细阅读并接受许可协议,最后点击Finish。 - 安装完成后,Eclipse 会提示你重启,重启后,PyDev 插件就安装成功了。
第二步:配置 Python 解释器
这是最关键的一步,PyDev 需要知道你的 Python 安装在哪里,才能正确地运行和调试代码。
-
打开 PyDev 的首选项设置:
(图片来源网络,侵删)- 在 Windows/Linux 上:
Window->Preferences->PyDev->Interpreter - Python - 在 macOS 上:
Eclipse->Settings->PyDev->Interpreter - Python
- 在 Windows/Linux 上:
-
添加新的 Python 解释器:
- 在右侧的窗口中,点击
New...按钮。 - Interpreter Name: 给你的解释器起一个名字,
Python 3.9。 - Executable: 点击
Browse...按钮,然后找到你的 Python 可执行文件(python.exeon Windows,pythonon macOS/Linux)的路径。- Windows:
C:\Users\YourUser\AppData\Local\Programs\Python\Python39\python.exe - macOS:
/usr/bin/python3或/usr/local/bin/python3(具体路径取决于你的安装方式) - Linux:
/usr/bin/python3
- Windows:
- 选择完可执行文件后,PyDev 会自动扫描并显示该 Python 环境中已安装的所有标准库和第三方库(通过
pip install安装的)。
- 在右侧的窗口中,点击
-
完成配置:
- 点击
OK,然后你会看到一个包含所有库的列表,通常直接点击OK即可。 - 在首设窗口点击
Apply and Close。
- 点击
Eclipse 已经知道你的 Python 环境,可以开始创建项目了。
第三步:创建 Python 项目和模块
创建项目
File->New->PyDev Project。- Project name: 输入你的项目名称,
my_python_app。 - PyDev Interpreter: 从下拉菜单中选择你在上一步配置好的 Python 解释器。
- Layout: 选择一个项目布局。
- Source folders: 将源代码放在
src文件夹中,这是一个良好的实践。 - Tests folder: 将测试代码放在
tests文件夹中。
- Source folders: 将源代码放在
- 点击
Finish。
创建模块(Python 文件)
在项目资源管理器中,右键点击你的项目或源文件夹(如 src),选择 New -> PyDev Module。

- Module name: 输入模块名,
calculator,PyDev 会自动创建calculator.py文件。 - If main is checked: 如果勾选,PyDev 会在文件末尾自动添加
if __name__ == "__main__":的代码块,方便你直接运行和测试该模块。
创建包
包是一个包含 __init__.py 文件的目录,用于组织模块。
- 在项目资源管理器中,右键点击项目或源文件夹。
- 选择
New->PyDev Package。 - Package name: 输入包名,
utils,PyDev 会创建一个名为utils的文件夹,并在其中创建一个空的__init__.py文件。
第四步:编写和运行代码
你可以在 calculator.py 中编写代码了。
calculator.py
def add(a, b):
"""返回两个数的和"""
return a + b
def subtract(a, b):
"""返回两个数的差"""
return a - b
if __name__ == "__main__":
print("Testing calculator module...")
print(f"5 + 3 = {add(5, 3)}")
print(f"5 - 3 = {subtract(5, 3)}")
运行代码:
右键点击 calculator.py 文件,选择 Run As -> Python Run,控制台会输出结果。
第五步:导入和使用其他模块
假设你在 src 目录下创建了另一个模块 math_helper.py。
math_helper.py
PI = 3.14159
def square(number):
"""返回一个数的平方"""
return number * number
修改 calculator.py 来导入并使用这个模块。
calculator.py (修改后)
# 从当前包的 math_helper 模块导入 square 函数
from math_helper import square
def add(a, b):
"""返回两个数的和"""
return a + b
if __name__ == "__main__":
print("Testing calculator module...")
print(f"5 + 3 = {add(5, 3)}")
print(f"The square of 4 is: {square(4)}") # 使用了 math_helper 中的函数
关键点:
- 模块搜索路径:PyDev 会自动将项目源文件夹(如
src)添加到 Python 的模块搜索路径(sys.path)中。src目录下的模块可以直接互相导入。 - 导入第三方库:如果你已经通过 PyDev 的解释器配置安装了第三方库(如
requests),你可以在任何模块中直接import requests使用它。
第六步:调试代码
PyDev 的调试器非常强大。
- 设置断点:在代码行号前面的空白区域双击,会出现一个蓝色的小圆点,这就是断点。
def add(a, b): # 在这里设置断点 result = a + b return result - 启动调试:右键点击文件,选择
Debug As->Python Debug。 - 切换到 Debug 视图:Eclipse 会切换到 Debug 透视图,你会看到:
- 变量视图:显示当前作用域内所有变量的值。
- 调试控制栏:有
Resume(F8)、Step Over(F6)、Step Into(F5)、Step Return(F7) 等按钮。 - 控制台视图:显示程序的输出。
- 单步执行:
- 按
F6(Step Over) 逐行执行代码,当代码调用一个函数时,会直接执行完整个函数,然后停在下一行。 - 按
F5(Step Into) 进入函数内部,逐行执行函数代码。
- 按
- 查看变量:在执行过程中,变量视图会实时更新,你可以随时检查变量的值是否符合预期。
- 结束调试:点击工具栏上的红色方块按钮,或者按
Ctrl+F2。
第七步:安装和管理第三方库
PyDev 提供了便捷的界面来管理 pip。
- 打开
Window->Preferences->PyDev->Interpreter - Python。 - 在右侧,选择你配置好的解释器。
- 下方的列表显示了已安装的库,点击旁边的 按钮,选择
PyDev Package - Install/Uninstall packages...。 - 在弹出的窗口中,你可以:
- Install: 在
New packages框中输入库名(如requests),点击Add,然后点击OK和Apply。 - Uninstall: 在
Installed packages列表中选中库,点击Remove。
- Install: 在
这个功能比在命令行中使用 pip 更集成,方便在 IDE 内完成所有操作。
| 功能 | 操作 |
|---|---|
| 安装插件 | Help -> Install New Software -> 添加 http://pydev.org/updates |
| 配置解释器 | Window -> Preferences -> PyDev -> Interpreter - Python -> New |
| 创建项目 | File -> New -> PyDev Project |
| 创建模块 | 右键项目/文件夹 -> New -> PyDev Module |
| 创建包 | 右键项目/文件夹 -> New -> PyDev Package |
| 运行代码 | 右键 .py 文件 -> Run As -> Python Run |
| 调试代码 | 设置断点 -> 右键 .py 文件 -> Debug As -> Python Debug |
| 管理库 | Preferences -> PyDev -> Interpreter -> -> Install/Uninstall packages |
遵循以上步骤,你就可以在 Eclipse 中搭建一个功能完善的 Python 开发环境了,PyDev 虽然不如 PyCharm 那样专门为 Python 优化,但对于习惯使用 Eclipse 的开发者来说,它是一个非常强大且免费的选择。
