第一步:安装 Package Control (最重要的一步)
如果你是第一次使用 Sublime Text,或者还没有安装过 Package Control,请务必先完成这一步。这是安装所有其他插件的前提。
通过命令行安装 (推荐,最稳定)
-
打开 Sublime Text。
-
打开控制台:
- Windows / Linux: 按
Ctrl + `` (反引号键,通常在Tab` 键上方)。 - macOS: 按 `Cmd + + `` (反引号键)。
- Windows / Linux: 按
-
粘贴代码:在打开的控制台中,会看到一个
>提示符,将下面对应你操作系统的代码复制并粘贴进去,然后按 Enter 键。-
Windows (32-bit)
import urllib.request,os,hashlib; h = '7183a2d3e96f11eeadd761d777e62404e330c659d4bb41d3bdf617ec50f545c5'; 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) -
Windows (64-bit)
import urllib.request,os,hashlib; h = '7183a2d3e96f11eeadd761d777e62404e330c659d4bb41d3bdf617ec50f545c5'; 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) -
OS X
import urllib.request,os,hashlib; h = '7183a2d3e96f11eeadd761d777e62404e330c659d4bb41d3bdf617ec50f545c5'; 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) -
Linux
import urllib.request,os,hashlib; h = '7183a2d3e96f11eeadd761d777e62404e330c659d4bb41d3bdf617ec50f545c5'; 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:安装完成后,关闭并重新打开 Sublime Text,Package Control 就已经成功安装了,你可以在
Preferences > Package Settings菜单下看到Package Control选项,这表示安装成功。
手动安装 (如果方法一失败)
如果因为网络问题导致方法一失败,可以尝试手动安装。
- 下载文件:访问 Package Control 官网 下载
Package Control.sublime-package文件。 - 找到目录:找到 Sublime Text 的
Installed Packages文件夹。- Windows:
%APPDATA%\Sublime Text 3\Installed Packages\ - macOS:
~/Library/Application Support/Sublime Text 3/Installed Packages/ - Linux:
~/.config/sublime-text-3/Installed Packages/ - (注意:如果你的 Sublime Text 是版本 4,路径中的
3应改为4)
- Windows:
- 复制文件:将下载好的
Package Control.sublime-package文件复制到上述文件夹中。 - 重启 Sublime Text。
第二步:安装 Python 插件
现在你已经有了 Package Control,安装 Python 相关的插件就非常轻松了,对于 Python 开发,有几个核心插件是必备的。
安装必备插件
我们来安装最核心的插件。
- Anaconda: 这是一个功能强大的 Python IDE 插件,集成了代码补全、语法检查、代码格式化、Goto Definition 等多种功能,是 Python 开发的首选。
- SublimeREPL: 允许你在 Sublime Text 内部直接运行 Python 解释器,进行交互式编程和调试。
- GitGutter: 在代码行号旁边显示文件的修改状态(新增、修改、删除),非常适合版本控制。
安装步骤:
-
打开命令面板:
- 按
Ctrl + Shift + P(Windows/Linux) 或Cmd + Shift + P(macOS)。 - 这会弹出一个命令输入框。
- 按
-
输入安装命令:
- 在命令框中输入
install,你会看到Package Control: Install Package这个选项。 - 选中它并按 Enter 键。
- 在命令框中输入
-
搜索并安装插件:
- 等待片刻,会出现一个插件列表,现在你可以直接输入你想安装的插件名称。
- 输入
Anaconda,从列表中选择Anaconda,然后按 Enter 键。 - 重复以上步骤,分别搜索并安装
SublimeREPL和GitGutter。
安装过程可能需要一点时间,请耐心等待,安装完成后,Sublime Text 通常会自动重启,或者提示你重启。
第三步:配置和使用插件
安装好插件后,还需要一些简单的配置才能让它们更好地工作。
配置 Anaconda
Anaconda 通常开箱即用,但你可以进行一些个性化设置。
-
打开 Anaconda 的设置:
Preferences > Package Settings > Anaconda > Settings - User- 这会打开一个用户专属的配置文件(如果不存在会自动创建)。
-
常用配置示例: 你可以在这个文件中添加或修改以下内容(使用 JSON 格式):
{ // 设置 Python 解释器路径,Anaconda 会自动检测,但如果检测不到,可以手动指定 // "python_interpreter": "C:/Python39/python.exe", // Windows 示例 // "python_interpreter": "/usr/bin/python3", // Linux/macOS 示例 // 关闭 Linting,因为我们用 PEP8 更好用 "suppress_pep8_warning": true, // 启用 PEP8 代码风格检查 "linters": { "pep8": { "enabled": true, // "python": "C:/Python39/python.exe", // pep8 不在环境变量中,需要指定路径 // "pep8_path": "C:/Python39/Scripts/pep8.exe" } }, // 设置代码格式化工具,autopep8 "auto_formatting": true, "formatting": "autopep8" }
使用 SublimeREPL 运行代码
-
打开一个
.py文件。 -
打开命令面板 (
Ctrl+Shift+P)。 -
输入
SublimeREPL,你会看到几个选项:SublimeREPL: Python- 打开一个 Python 交互式终端。SublimeREPL: Python - RUN current file- 在终端中运行当前打开的 Python 文件。SublimeREPL: Python - PDB- 以调试模式运行。
选择
Python - RUN current file,SublimeREPL 会在一个新窗口中打开,并执行你的代码。
使用 Anaconda 的功能
- 代码补全: 输入代码时,Anaconda 会自动提示函数、变量和模块。
- 语法检查: 如果代码不符合 PEP8 规范或有语法错误,行号旁会显示波浪线和错误提示。
- 跳转到定义: 将光标放在一个函数或变量上,按
F12(Windows/Linux) 或Cmd+F12(macOS) 可以跳转到它的定义处。 - 查看文档: 将光标放在一个函数上,按
Ctrl+Alt+d(Windows/Linux) 或Ctrl+J(macOS) 可以查看其文档字符串。
第四步:进阶与推荐插件
当你熟悉了基本操作后,可以尝试安装更多插件来提升开发效率。
| 插件名称 | 功能简介 |
|---|---|
| DocBlockr | 自动生成符合规范的 Python Docstring,只需输入 并按 Tab 键。 |
| Git | 提供图形化的 Git 操作界面,如提交、推送、拉取、查看历史等。 |
| SideBarEnhancements | 大大增强侧边栏的功能,支持在新窗口中打开、在浏览器中打开、剪切/复制文件路径等。 |
| ColorPicker | 快速打开一个颜色选择器,获取颜色代码。 |
| Emmet | 前端开发必备,可以快速编写 HTML 和 CSS。 |
| BracketHighlighter | 高亮显示匹配的括号、标签等,方便查看代码结构。 |
常见问题与解决
-
Q: 插件安装失败,提示 "There are no packages available for installation"
- A: 这通常是因为网络问题无法连接到 Package Control 的服务器,请检查你的网络连接,如果使用代理或 VPN,请确保 Sublime Text 可以通过代理访问,你也可以尝试切换网络环境。
-
Q: 如何删除插件?
- A: 同样打开命令面板 (
Ctrl+Shift+P),输入remove,选择Package Control: Remove Package,然后搜索并选择你想删除的插件即可。
- A: 同样打开命令面板 (
-
Q: 如何更新插件?
- A: 打开命令面板,输入
upgrade,选择Package Control: Upgrade All Packages可以更新所有插件,或者选择Package Control: Upgrade Package来更新单个插件。
- A: 打开命令面板,输入
-
Q: Sublime Text 如何配置 Python 解释器路径?
- A: 对于简单的脚本运行,Sublime Text 会使用系统默认的
python命令,如果你想指定特定的 Python 环境(例如虚拟环境),最简单的方法是在你的项目根目录下创建一个.sublime-project文件,并在其中指定,或者,像上面在 Anaconda 配置中提到的那样,直接在插件的配置文件里指定。
- A: 对于简单的脚本运行,Sublime Text 会使用系统默认的
希望这份详细的指南能帮助你在 Sublime Text 中顺利地搭建起强大的 Python 开发环境!
