使用 sublime 编写 python 项目需先配置环境。1. 安装 sublime text 4 并确认系统已安装 python；2. 配置构建系统，通过 tools > build system > new build system 创建 python3.sublime-build 文件并保存；3. 安装 package control 插件管理器，通过控制台执行代码安装；4. 推荐安装 anaconda、sublimelinter、gitgutter 和 sidebarenhancements 等插件增强功能；5. 配置虚拟环境，创建 venv 并在 sublime 中设置对应的构建系统；6. 使用 .sublime-project 文件保存项目配置，包括工作目录和构建系统路径；7. 注意检查 python 路径避免模块错误，可自定义快捷键提升效率。
用 Sublime 写 Python 项目，其实挺方便的，尤其是配置好环境之后。虽然它不是专门的 Python IDE，但轻量、启动快、插件丰富，适合写小项目或者做脚本开发。
安装 Sublime Text 并配置 Python 环境
首先得确认你已经安装了 Sublime Text（推荐使用最新的 Sublime Text 4），然后要确保你的系统里已经安装了 Python。Sublime 自带了一个简单的编译系统，但它默认不带完整的 Python 开发支持，所以需要手动设置。
- 打开终端或命令行，输入
python --version
或python3 --version
，看是否能输出版本号。 - 如果没有安装 Python，可以去官网下载安装包：https://www.php.cn/link/b64f6155563e634a2e0c13b684e73a1f
- 在 Sublime 中，点击菜单栏的 Tools > Build System > New Build System…
- 替换里面的 JSON 内容为以下内容（根据你用的是 python 还是 python3 修改）：
{
"cmd": ["python3", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python"
}- 保存为
Python3.sublime-build
，之后在 Build System 里选择这个新配置即可。
这样你就可以按
Ctrl+B直接运行当前打开的
.py文件了。
立即学习“Python免费学习笔记（深入）”；
安装 Package Control 和常用插件
Package Control 是 Sublime 的一个插件管理器，几乎所有实用插件都通过它来安装。
安装方法：
- 打开 Sublime，按下 `Ctrl+`` 打开控制台。
- 粘贴下面这段代码进去回车：
import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedcf1dcaee' + 'ebe013ee18cced0ef93d5f746d99bd'; 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: Invalid hash for %s (%s != %s).' % (pf, dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)等出现提示说明安装成功后，重启 Sublime。
推荐安装的插件：
- Anaconda：提供代码补全、语法检查、跳转定义等功能，功能强大。
- SublimeLinter + SublimeLinter-flake8：用来做代码风格检查，配合 flake8 使用。
- GitGutter：显示文件中被修改过的行，方便查看改动。
- SideBarEnhancements：增强侧边栏的功能，比如右键运行、新建文件等。
安装方式很简单，打开 Command Palette（快捷键
Ctrl+Shift+P），输入
Install Package Control，然后继续搜索你要安装的插件名就可以了。
配置虚拟环境和项目结构
如果你是在做一个实际的 Python 项目，建议使用虚拟环境来隔离依赖。Sublime 支持绑定不同的构建系统到不同项目上，这样你可以为每个项目指定不同的 Python 解释器。
步骤如下：
- 创建虚拟环境（以项目目录为例）：
cd your_project_folder python3 -m venv venv
- 激活虚拟环境：
-
macOS/Linux：
source venv/bin/activate
- Windows：
venv\Scripts\activate
安装项目所需的依赖，比如
pip install requests
回到 Sublime，创建一个自定义的 build system，路径指向虚拟环境中的 python：
{
"cmd": ["/path/to/your/project/venv/bin/python", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python"
}- 保存为
ProjectName.sublime-build
，然后切换到这个构建系统。
此外，Sublime 支持
.sublime-project文件来保存项目配置。你可以通过菜单 Project > Save Project As… 来生成一个项目文件，里面可以配置工作目录、构建系统、环境变量等。
小技巧和注意事项
- 如果你在运行脚本时遇到找不到模块的问题，可能是因为 Sublime 默认使用的 Python 不是你想用的那个，记得检查构建系统的路径。
- 可以把常用的命令写成快捷键，通过
Preferences > Key Bindings
添加。 - Anaconda 插件有时候会卡顿，可以在设置中关闭一些不需要的功能，比如禁用自动补全或者只在保存时检查语法。
- 多个 Python 版本共存时，最好为每个项目单独配置构建系统，避免混淆。
基本上就这些，用 Sublime 写 Python 项目其实不复杂，但有些细节容易忽略，特别是路径和环境配置方面。只要一开始配好了，后续写起来效率还是挺高的。
