杰瑞科技汇

Sublime怎么搭Python开发环境?

第一步:基础安装

安装 Sublime Text

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

Sublime怎么搭Python开发环境?-图1
(图片来源网络,侵删)

它支持 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怎么搭Python开发环境?-图2
(图片来源网络,侵删)

安装方法:

  1. 打开 Sublime Text。

  2. 通过菜单栏打开 View -> Show Console (或者使用快捷键 Ctrl + ``)。

  3. 在弹出的控制台中,根据你的 Sublime Text 版本,粘贴并运行以下对应的代码:

    Sublime怎么搭Python开发环境?-图3
    (图片来源网络,侵删)
    • 对于 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)
  4. 等待安装完成,安装后,重启 Sublime Text,重启后,你可以在 Preferences -> Package Settings 中看到 Package Control 菜单,这表示安装成功。


第三步:安装核心插件

现在我们有了包管理器,就可以安装让 Sublime Text 变成 Python IDE 的核心插件了。

如何安装插件:

  1. Ctrl + Shift + P (或 Cmd + Shift + P 在 macOS) 打开命令面板。
  2. 输入 Install Package 并选择它。
  3. 在出现的搜索框中输入插件名称,然后从列表中选择并安装。

以下是推荐的 Python 开发必备插件:

Anaconda

这是 Python 开发的瑞士军刀,提供了一站式的 IDE 体验。

  • 功能:
    • 代码自动补全: 基于当前文件的上下文提供智能提示。
    • 代码检查: 实时显示 PEP 8 风格错误和警告。
    • 代码跳转: 快速跳转到函数/类的定义 (F12) 或引用 (Shift+F12)。
    • 代码格式化: 自动格式化你的代码(需要配合 autopep8yapf)。
    • 运行代码: 右键即可运行当前 Python 脚本。
  • 安装: 在命令面板中输入 Package Control: Install Package,然后搜索 Anaconda 并安装。

LSP (Language Server Protocol)

这是一个更现代、更通用的语言服务器客户端,Anaconda 的一些功能可能会被它取代或增强,对于 Python,它会使用 pylsp 语言服务器。

  • 功能:
    • 提供强大的代码分析、自动补全、定义跳转等功能。
    • 支持多种编程语言,扩展性好。
  • 安装: Package Control: Install Package -> 搜索 LSP 并安装。
  • 配置 (重要): 安装 LSP 后,你还需要为 Python 安装语言服务器本身。
    1. 在命令面板中运行 LSP: Install Server
    2. 搜索 Python LSP Server (pylsp) 并安装。
    3. 重启 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:

    1. 打开一个 .py 文件。
    2. 在 Sublime Text 的状态栏(窗口底部)找到 Python 版本号。
    3. 点击版本号,会弹出一个菜单,列出你系统中所有可用的 Python 解释器。
    4. 选择你想要使用的那个即可,这个选择会被记住,用于当前项目。
  • 使用 LSP: LSP 通常会自动检测到你系统中的 Python 解释器,你也可以手动指定:

    1. Ctrl + Shift + P
    2. 输入 LSP: Select LSP Server
    3. 选择 pylsp
    4. 然后选择 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)。

  1. 安装插件: Package Control: Install Package -> 搜索 SublimeDebugger 并安装。
  2. 配置:
    • 打开一个 Python 文件。
    • 在代码中你想开始调试的地方,右键 -> SublimeDebugger: Toggle Breakpoint (设置断点)。
    • 再次右键 -> SublimeDebugger: Debug
    • Sublime 会在一个面板中启动 pdb 调试器,你可以使用 n(下一步), c(继续), s(进入函数) 等命令进行调试。

第六步:项目管理

对于较大的项目,使用 Sublime Text 的项目功能非常方便。

  1. 创建项目:
    • 在项目根目录(my_project)下,将所有相关文件和文件夹组织好。
    • 在 Sublime Text 中,通过 Project -> Save Project As... 保存一个 .sublime-project 文件(my_project.sublime-project)。
  2. 添加文件夹到项目:
    • 保存项目后,再次打开 Project -> Edit Project
    • 这会打开项目的配置文件(.sublime-project),你可以手动添加需要包含的文件夹:
      {
          "folders":
          [
              {
                  "path": ".", // 当前目录
                  "follow_symlinks": true
              },
              {
                  "path": "../lib" // 可以添加其他相关目录
              }
          ]
      }
  3. 使用项目:
    • 之后,你只需双击 .sublime-project 文件即可快速加载整个项目及其配置(如解释器设置等)。

推荐的插件清单

插件名称 主要功能 是否必需
Package Control 包管理器 绝对必需
Anaconda 代码补全、检查、跳转、格式化 强烈推荐 (新手友好)
LSP 现代语言服务器客户端,提供核心语言功能 强烈推荐 (功能更强大)
SublimeREPL 内置交互式 Python 终端 推荐
GitGutter 侧边栏显示 Git 修改状态 推荐 (如果你用 Git)
SideBarEnhancements 增强侧边栏功能 推荐
SublimeDebugger 图形化调试界面 进阶 (可选)

通过以上步骤,你就拥有了一个功能强大、高度可定制的 Python 开发环境,Sublime Text 的魅力在于它的简洁和速度,你可以根据自己的需求不断添加和调整插件,打造出最适合自己的 IDE,祝你编码愉快!

分享:
扫描分享到社交APP
上一篇
下一篇