用Sublime写Python项目实例｜附带详细环境配置步骤

使用 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 开发支持，所以需要手动设置。

1. 打开终端或命令行，输入

   python --version

   或

   python3 --version

   ，看是否能输出版本号。

2. 如果没有安装 Python，可以去官网下载安装包：https://www.php.cn/link/b64f6155563e634a2e0c13b684e73a1f
3. 在 Sublime 中，点击菜单栏的 Tools > Build System > New Build System…
4. 替换里面的 JSON 内容为以下内容（根据你用的是 python 还是 python3 修改）：

{     "cmd": ["python3", "-u", "$file"],     "file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",     "selector": "source.python" }

5. 保存为

   Python3.sublime-build

   ，之后在 Build System 里选择这个新配置即可。

这样你就可以按

Ctrl+B

直接运行当前打开的

.py

文件了。

立即学习“Python免费学习笔记（深入）”；

安装 Package Control 和常用插件

Package Control 是 Sublime 的一个插件管理器，几乎所有实用插件都通过它来安装。

安装方法：

1. 打开 Sublime，按下 `Ctrl+“ 打开控制台。
2. 粘贴下面这段代码进去回车：

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 解释器。

步骤如下：

1. 创建虚拟环境（以项目目录为例）：

cd your_project_folder python3 -m venv venv

2. 激活虚拟环境：

• macOS/linux：

  source venv/bin/activate
• windows：

  venvScriptsactivate

3. 安装项目所需的依赖，比如

   pip install requests

4. 回到 Sublime，创建一个自定义的 build system，路径指向虚拟环境中的 python：

{     "cmd": ["/path/to/your/project/venv/bin/python", "-u", "$file"],     "file_regex": "^[ ]*File "(...*?)", line ([0-9]*)",     "selector": "source.python" }

5. 保存为

   ProjectName.sublime-build

   ，然后切换到这个构建系统。

此外，Sublime 支持

.sublime-project

文件来保存项目配置。你可以通过菜单 Project > Save Project As… 来生成一个项目文件，里面可以配置工作目录、构建系统、环境变量等。

小技巧和注意事项

• 如果你在运行脚本时遇到找不到模块的问题，可能是因为 Sublime 默认使用的 Python 不是你想用的那个，记得检查构建系统的路径。
• 可以把常用的命令写成快捷键，通过

  Preferences > Key Bindings

  添加。

• Anaconda 插件有时候会卡顿，可以在设置中关闭一些不需要的功能，比如禁用自动补全或者只在保存时检查语法。
• 多个 Python 版本共存时，最好为每个项目单独配置构建系统，避免混淆。

基本上就这些，用 Sublime 写 Python 项目其实不复杂，但有些细节容易忽略，特别是路径和环境配置方面。只要一开始配好了，后续写起来效率还是挺高的。