第一步:基础安装
安装 Sublime Text
如果你还没有安装 Sublime Text,请先从其官网下载并安装: https://www.sublimetext.com/

它支持 Windows, macOS 和 Linux。
安装 Python
确保你的电脑上已经安装了 Python,你可以在终端(Windows上是CMD或PowerShell,macOS/Linux上是Terminal)中输入以下命令来检查:
python --version # 或者 python3 --version
如果没有安装,请前往 Python 官网下载并安装:https://www.python.org/downloads/
重要: 在安装 Python 时,请务必勾选 "Add Python to PATH" 选项,这会让你在命令行中方便地调用 python 命令。
第二步:安装 Package Control (核心)
Package Control 是 Sublime Text 的包管理器,几乎所有你需要的功能插件都通过它来安装,这是最关键的一步。

安装方法:
-
打开 Sublime Text。
-
通过菜单栏打开
View->Show Console(或者使用快捷键Ctrl + ``)。 -
在弹出的控制台中,根据你的 Sublime Text 版本,粘贴并运行以下对应的代码:
(图片来源网络,侵删)-
对于 Sublime Text 3:
import urllib.request,os,hashlib; h = '6f4c264a24d9b328eeae6099a1b69a5e'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); by = urllib.request.urlopen( 'http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join( ipp, pf), 'wb' ).write(by) -
对于 Sublime Text 4:
import urllib.request,os,hashlib; h = '6f4c264a24d9b328eeae6099a1b69a5e'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); by = urllib.request.urlopen( 'http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join( ipp, pf), 'wb' ).write(by)
-
-
等待安装完成,安装后,重启 Sublime Text,重启后,你可以在
Preferences->Package Settings中看到Package Control菜单,这表示安装成功。
第三步:安装核心插件
现在我们有了包管理器,就可以安装让 Sublime Text 变成 Python IDE 的核心插件了。
如何安装插件:
- 按
Ctrl + Shift + P(或Cmd + Shift + P在 macOS) 打开命令面板。 - 输入
Install Package并选择它。 - 在出现的搜索框中输入插件名称,然后从列表中选择并安装。
以下是推荐的 Python 开发必备插件:
Anaconda
这是 Python 开发的瑞士军刀,提供了一站式的 IDE 体验。
- 功能:
- 代码自动补全: 基于当前文件的上下文提供智能提示。
- 代码检查: 实时显示 PEP 8 风格错误和警告。
- 代码跳转: 快速跳转到函数/类的定义 (
F12) 或引用 (Shift+F12)。 - 代码格式化: 自动格式化你的代码(需要配合
autopep8或yapf)。 - 运行代码: 右键即可运行当前 Python 脚本。
- 安装: 在命令面板中输入
Package Control: Install Package,然后搜索Anaconda并安装。
LSP (Language Server Protocol)
这是一个更现代、更通用的语言服务器客户端,Anaconda 的一些功能可能会被它取代或增强,对于 Python,它会使用 pylsp 语言服务器。
- 功能:
- 提供强大的代码分析、自动补全、定义跳转等功能。
- 支持多种编程语言,扩展性好。
- 安装:
Package Control: Install Package-> 搜索LSP并安装。 - 配置 (重要): 安装 LSP 后,你还需要为 Python 安装语言服务器本身。
- 在命令面板中运行
LSP: Install Server。 - 搜索
Python LSP Server (pylsp)并安装。 - 重启 Sublime Text。
- 在命令面板中运行
SublimeREPL
让你在 Sublime Text 内部直接运行一个交互式 Python 解释器(REPL),非常适合快速测试代码片段。
- 功能:
- 在 Sublime 中打开一个 Python 交互式终端。
- 可以直接运行选中的代码。
- 安装:
Package Control: Install Package-> 搜索SublimeREPL并安装。 - 使用: 右键代码 ->
SublimeREPL->Python->Python(即可打开交互式终端)。
GitGutter
在代码行号旁边显示修改过的标记(增加、删除、修改),让你一目了然地看到自上次提交以来的所有变更。
- 功能:
实时显示 Git diff 状态。
- 安装:
Package Control: Install Package-> 搜索GitGutter并安装。
SideBarEnhancements
极大地增强了侧边栏的功能,让你可以更方便地管理文件和文件夹。
- 功能:
- 在侧边栏中右键可以新建文件、文件夹,复制、移动、删除等。
- 提供了比默认侧边栏丰富得多的上下文菜单。
- 安装:
Package Control: Install Package-> 搜索SideBarEnhancements并安装。
第四步:配置与快捷键
为了让开发更顺畅,我们需要进行一些基本配置。
选择解释器 (非常重要)
如果你的电脑上有多个 Python 版本(Python 2.7, Python 3.8, Anaconda 等),你需要告诉 Sublime Text 使用哪一个。
-
使用 Anaconda:
- 打开一个
.py文件。 - 在 Sublime Text 的状态栏(窗口底部)找到 Python 版本号。
- 点击版本号,会弹出一个菜单,列出你系统中所有可用的 Python 解释器。
- 选择你想要使用的那个即可,这个选择会被记住,用于当前项目。
- 打开一个
-
使用 LSP: LSP 通常会自动检测到你系统中的 Python 解释器,你也可以手动指定:
- 按
Ctrl + Shift + P。 - 输入
LSP: Select LSP Server。 - 选择
pylsp。 - 然后选择
Set Interpreter,再从列表中选择或手动输入路径。
- 按
配置文件
Sublime Text 的配置文件是 JSON 格式,可以让你精细控制编辑器的行为。
- 用户配置文件:
Preferences->Settings->User Settings,这里的设置会覆盖默认设置。 - 插件配置文件:
Preferences->Package Settings->[插件名]->Settings - User。
示例 Preferences.sublime-settings (User Settings):
{
// 设置默认编码
"default_encoding": "UTF-8",
// 设置行尾符
"default_line_ending": "unix",
// 启用行号
"line_numbers": true,
// 启用语法高亮
"color_scheme": "Packages/Theme - Default/Color Scheme - Default.tmTheme",
// 字体和大小
"font_face": "Consolas",
"font_size": 14,
// 缩进使用空格
"translate_tabs_to_spaces": true,
"tab_size": 4,
// 保存时自动格式化 (需要 Anaconda 或 LSP 配合)
"auto_format_on_save": true,
// 查找时区分大小写
"find_selected_text": true,
"highlight_matches": true
}
快捷键
快捷键是提升效率的关键,你可以自定义快捷键:Preferences -> Key Bindings -> User Key Bindings。
示例 Default (Windows).sublime-keymap (User Key Bindings):
[
// 运行当前 Python 文件
{ "keys": ["f5"], "command": "run_existing_window_command", "args": {"id": "repl_python_run", "file": "config/Python/Main.sublime-menu"} },
// 使用 SublimeREPL 打开交互式终端
{ "keys": ["ctrl+shift+r"], "command": "run_existing_window_command", "args": {"id": "repl_python", "file": "config/Python/Main.sublime-menu"} },
// 保存并格式化代码
{ "keys": ["ctrl+shift+f"], "command": "anaconda_formatting" } // 如果使用 Anaconda
// { "keys": ["ctrl+shift+f"], "command": "lsp_format_document" } // 如果使用 LSP
]
注意: 快捷键可能会与其他插件冲突,请根据你的习惯调整。
第五步:调试配置 (进阶)
Sublime Text 本身没有内置图形化调试器,但我们可以使用插件 SublimeDebugger 来集成 pdb (Python Debugger)。
- 安装插件:
Package Control: Install Package-> 搜索SublimeDebugger并安装。 - 配置:
- 打开一个 Python 文件。
- 在代码中你想开始调试的地方,右键 ->
SublimeDebugger: Toggle Breakpoint(设置断点)。 - 再次右键 ->
SublimeDebugger: Debug。 - Sublime 会在一个面板中启动
pdb调试器,你可以使用n(下一步),c(继续),s(进入函数) 等命令进行调试。
第六步:项目管理
对于较大的项目,使用 Sublime Text 的项目功能非常方便。
- 创建项目:
- 在项目根目录(
my_project)下,将所有相关文件和文件夹组织好。 - 在 Sublime Text 中,通过
Project->Save Project As...保存一个.sublime-project文件(my_project.sublime-project)。
- 在项目根目录(
- 添加文件夹到项目:
- 保存项目后,再次打开
Project->Edit Project。 - 这会打开项目的配置文件(
.sublime-project),你可以手动添加需要包含的文件夹:{ "folders": [ { "path": ".", // 当前目录 "follow_symlinks": true }, { "path": "../lib" // 可以添加其他相关目录 } ] }
- 保存项目后,再次打开
- 使用项目:
- 之后,你只需双击
.sublime-project文件即可快速加载整个项目及其配置(如解释器设置等)。
- 之后,你只需双击
推荐的插件清单
| 插件名称 | 主要功能 | 是否必需 |
|---|---|---|
| Package Control | 包管理器 | 绝对必需 |
| Anaconda | 代码补全、检查、跳转、格式化 | 强烈推荐 (新手友好) |
| LSP | 现代语言服务器客户端,提供核心语言功能 | 强烈推荐 (功能更强大) |
| SublimeREPL | 内置交互式 Python 终端 | 推荐 |
| GitGutter | 侧边栏显示 Git 修改状态 | 推荐 (如果你用 Git) |
| SideBarEnhancements | 增强侧边栏功能 | 推荐 |
| SublimeDebugger | 图形化调试界面 | 进阶 (可选) |
通过以上步骤,你就拥有了一个功能强大、高度可定制的 Python 开发环境,Sublime Text 的魅力在于它的简洁和速度,你可以根据自己的需求不断添加和调整插件,打造出最适合自己的 IDE,祝你编码愉快!
