Sublime Text 4 基础教程

Sublime Text 是一款轻量级但功能强大的代码编辑器，支持多窗口分屏、快速搜索与导航、项目管理等高效开发功能。本文档涵盖安装、汉化、插件管理、自定义设置、快捷键、项目管理等核心内容。

安装 Sublime Text 4

下载与安装

官网下载 ^db9ebd

• 官网链接：https://www.sublimetext.com/ ^6592e0
• 支持平台：Windows/macOS/Linux。

安装步骤

• Windows：双击安装包 → 按照提示完成安装（默认路径即可）。
• macOS：下载 .dmg 文件 → 拖动到 Applications 文件夹。
• Linux：解压后运行 sublime_text 文件，或通过包管理器安装（如 sudo apt install sublime-text）。

中文本地化（可选）

安装 ChineseLocalizations 插件

1. 打开 Sublime Text 4。
2. 按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（Mac）打开命令面板。
3. 输入 Install Package Control → 回车安装。
4. 再次按下 Ctrl+Shift+P，输入 Package Control: Install Package → 搜索 ChineseLocalizations → 安装。
5. 安装完成后，菜单栏 Help → Language → 选择 简体中文（需重启生效）。

验证是否成功

• 如果界面未切换，尝试重启 Sublime Text 或检查插件是否启用（Preferences → Package Settings → ChineseLocalizations → Settings）。

插件管理与扩展

安装 Package Control

Package Control 是管理插件的必备工具。安装方法如下：

方法1（推荐）：

• 菜单栏安装：Tools → Install Package Control（Sublime Text 4 默认支持）。

方法2（命令面板）：

• 按下 Ctrl+Shift+P → 输入 Install Package Control → 回车安装。

方法3（手动安装）：

由于网络上的代理或使用旧版本的 Sublime Text 而无法使用命令面板/菜单方法，则以如下步骤安装 Package Control：

1. 菜单栏：Preferences → Browse Packages...。
2. 进入 Installed Packages/ 文件夹。
3. 下载 Package Control.sublime-package  并复制到该目录。
4. 重启 Sublime Text。

安装 Package Control 后，可以轻松安装管理插件。

安装常用插件

推荐插件：

安装步骤：

1. 按下 Ctrl+Shift+P 打开命令面板，输入 Install Package。
2. 选择 Package Control: Install Package，回车等待弹出插件列表。
3. 搜索插件名称，回车安装。

自定义设置与优化

修改偏好设置

Sublime Text 的设置分为 默认设置（只读）和 用户设置（可自定义覆盖）。

通过菜单栏打开设置

1. 点击顶部菜单栏：Preferences → Settings。
2. Sublime Text 将打开一个左右并排的窗口：
   • 左侧：Preferences.sublime-settings – Default（只读）。
   • 右侧：Preferences.sublime-settings – User（可编辑）。
3. 在右侧添加或修改配置项，保存后立即生效。

通过控制台打开设置

1. 使用快捷键 Ctrl + `（反引号），打开控制台。
2. 在控制台中输入以下命令直接打开用户设置文件：

sublime.run_command("open_file", {
    "file": "${packages}/User/Preferences.sublime-settings"
})

• ${packages} 会自动解析为 Sublime 的 Packages 根目录，兼容不同系统。

用户配置示例

{
  "font_size": 14,                          // 字体大小（像素）
  "font_face": "Consolas",                  // 字体名称（可选）
  "theme": "Default Dark.sublime-theme",    // UI 主题（界面外观）
  "color_scheme": "Packages/Colorsublime - Themes/3024_Day.tmTheme", // 代码配色方案
  "tab_size": 4,                            // Tab 缩进宽度（空格数）
  "translate_tabs_to_spaces": true,         // 是否将 Tab 自动转为空格
//  "draw_white_space": "all",                // 显示空白字符（none, boundary, all）
  "word_wrap": "auto",                      // 自动换行（on, off, auto）
  "auto_save": true,                        // 自动保存（可选值：true, false, "on_focus_lost"）
  "highlight_line": true,                   // 高亮当前行
  "line_numbers": true,                     // 显示行号
  "scroll_past_end": true                   // 允许滚动超过文件末尾
}

注意：color_scheme 和 theme 需配合插件（如 Colorsublime）使用。在标准的 JSON 不支持注释，实际配置时需删除注释。

自定义快捷键

1. 按下 Ctrl+Shift+P → 输入 Preferences: Key Bindings。
2. 在右侧用户设置中添加自定义键绑定，例如：

[
  { "keys": ["ctrl+alt+j"], "command": "pretty_json" }
]

提示：保存后，使用 Ctrl+Alt+J 触发 Pretty JSON 格式化。

高效工作流程

常用快捷键

项目管理

项目与工作区

操作流程

假如有一个代码文件夹（如 D:\sublime_code），想把它变成一个“项目”。

新建项目（Save Project As...）

操作步骤：

1. 打开 Sublime Text。
2. 菜单栏点击：Project → Save Project As...
3. 弹出保存窗口：
   • 输入文件名：（如 my_project.sublime-project）
   • 点击保存：建议保存在项目根目录。

此时你已创建一个项目文件（.sublime-project），它是一个文本文件，可以用 Sublime 打开查看。

添加文件夹到项目（Add Folder to Project）

把一个文件夹添加到左侧的“侧边栏”中，方便浏览和编辑文件。

操作步骤：

1. 菜单栏点击：Project → Add Folder to Project
2. 选择文件夹（如 D:\my_project）→ 添加。

效果：左侧侧边栏显示文件夹结构，支持双击打开文件、右键新建文件等。

保存工作区状态（自动）

当你保存项目（生成 .sublime-project 文件）并在其中进行操作时，Sublime 会自动在同一目录生成 .sublime-workspace 文件，用于保存会话状态。

保存的内容：

• 已打开的文件
• 光标位置与选中内容
• 分屏布局（Group 数量与位置）
• 文件夹展开/折叠状态
• 搜索历史、命令面板历史

恢复机制：

当你通过 Project → Open Project... 打开项目时，Sublime 会读取 .sublime-workspace 恢复上一次的工作状态。

注意事项：

• .sublime-workspace 文件是自动生成、自动更新的，不建议手动编辑（除非要恢复或清理状态）
• 如果你删除 .sublime-workspace，下次打开项目时会以干净状态启动
• 如果只是用 File → Open Folder... 而不保存为项目，是不会生成 .sublime-workspace 的

打开项目（Open Project...）

快速打开你之前创建的项目。

操作步骤：

1. 菜单栏点击：File → Open Project...
2. 选择 .sublime-project 文件 → 打开。

效果：选择 .sublime-project 文件 → 打开。

文件结构示例

D:\my_project\
├── my_project.sublime-project        ← 项目配置文件
├── my_project.sublime-workspace      ← 工作区状态文件（可选，自动创建）
├── Other

注意：.sublime-workspace 文件通常包含敏感信息（如打开的文件路径），建议不要提交到 Git，可在 .gitignore 中忽略它。

项目配置进阶（可选）

.sublime-project 常见配置大致分两部分：

• folders：定义项目中包含的文件夹（路径、排除规则等）
• settings：为该项目单独设置的编辑器配置（如缩进、字体大小等）

.sublime-project 示例：

{
  "folders": [
    {
      "path": ".",
      "folder_name": "MyProject",
      "folder_exclude_patterns": [".git", "node_modules"],
      "file_exclude_patterns": ["*.log", "*.tmp"]
    }
  ],
  "settings": {
    "tab_size": 4,
    "translate_tabs_to_spaces": true,
    "font_size": 13
  }
}

高级技巧

主题与配色

安装 Colorsublime

1. 按下 Ctrl+Shift+P 打开命令面板，输入 Install Package。
2. 选择 Package Control: Install Package，回车等待弹出插件列表。
3. 在搜索栏中输入 Colorsublime，找到后点击安装。

应用配色方案

• 插件安装完成后，按下 Ctrl+Shift+P 打开命令面板。
• 输入 Colorsublime 并选择选项：Colorsublime: Install Theme。
• 在弹出的主题列表中，使用箭头键或搜索浏览主题（“配色方案”）并实时查看当前选项卡的变化。
• 选择成功后，当前编辑器的配色方案会立即生效。

多语言支持

• 语法高亮：View → Syntax → 选择语言。
• 自动检测语言：根据文件扩展名自动识别语法。

插件开发

1. Tools → Developer → New Plugin...。
2. 编写 Python 脚本并保存为 .sublime-plugin。
3. 通过命令面板调用自定义命令。

常见问题与解决方案

1. 安装插件失败

• 原因：网络问题或依赖缺失。
• 解决：
  • 使用代理或更换源（修改 Package Control 的设置）。
  • 安装依赖（如 Node.js、Python）。

2. 中文输入法冲突

• 解决：

  • 安装 IMESupport 插件。
  • 修改 Preferences.sublime-settings：

  	{
  	  "input_method": "ime"
  	}
  

3. 配置文件错误

• 症状：Sublime Text 启动失败或功能异常。
• 解决：

  • 定位配置文件目录：

    • Windows：C:\Users\<用户名>\AppData\Roaming\Sublime Text\Packages\User
    • Linux：~/.config/sublime-text/Packages/User

  • 备份并重置用户配置：最常见问题是 Preferences.sublime-settings 或其他插件配置文件出错。

    • 进入 User 目录，将以下文件重命名或移动到桌面备份：
      • Preferences.sublime-settings
      • Package Control.sublime-settings
      • 其他自定义 .sublime-settings 文件（如 Python.sublime-settings）
    • 注意：不要删除整个 User 文件夹，以免丢失已安装插件列表。

  • 重新启动 Sublime Text：

    • 启动后，Sublime 会自动生成默认的 Preferences.sublime-settings。
    • 如果此时能正常启动，说明问题出在某个配置文件上。

  • 逐个恢复配置：

    • 将你之前备份的配置文件逐个复制回去，每复制一个就重启 Sublime Text，检查是否出错。

参考文档

• 官方文档：Sublime Text Documentation
• 插件市场：Package Control 仓库
• 主题下载：Colorsublime 主题库