Sublime

概述

Sublime Text 是一款广受开发者欢迎的轻量级文本编辑器，在 macOS 的地位类似于windows下的notepad++。

1. 轻量快速：Sublime Text 启动迅速，即使在处理大文件时也能保持流畅，不会出现卡顿现象。相比许多重型 IDE，它在资源占用上极为节制。

2. 界面清爽：原生 macOS 风格的设计与简洁的界面相得益彰。无干扰的编辑环境、清晰的代码高亮和缩进指南，让用户能够专注于内容创作。

3. 强大的插件系统：Package Control 提供了丰富的插件生态，用户可以根据需要安装各种扩展，从语法支持到代码格式化，几乎无所不包。

4. 完全免费： 官网提供免费试用版，功能无限制，仅会不定期弹出购买提示。

下载与安装

直接访问 Sublime Text 官网，选择 MacOS 版本（支持 Intel 和 Apple Silicon 芯片，会自动适配），下载后将.dmg文件中的应用拖拽至「应用程序」文件夹，完成安装。

它实际上跨平台应用，Linux、Windows、macOS 每个平台都有自己的版本。如有需要，可以下载其他平台版本。

快捷键

安装 Package Control（插件管理工具）

安装

官网：Installation - Package Control

推荐安装方式：

1. 单击Preferences / Settings > Browse Packages…菜单。
2. 进入父文件夹，然后进行Installed Packages/文件夹。
3. 下载最新版本的Package Control.sublime-package，官网最新版本地址：https://packagecontrol.io/Package Control.sublime-package。
4. 将下载的文件（不要改名，就是：Package Control.sublime-package，中间是空格，如果是Github下载的会空格被改为.，需要自行改为空格）拷贝到Installed Packages/目录之下。
5. 重启 Sublime Text 使其生效。

备选安装方式（国内成功率低）：

1. 打开 Sublime Text，按Cmd + Shift + P调出命令面板。
2. 输入Install Package Control并回车，系统会自动下载并安装最新版本。
3. 安装完成后重启 Sublime Text。

添加国内可用的 Package Control 官方源 – 不再推荐

官方源现在稳定性很高，不再需要使用国内源。

解决安装最新版本无法使用问题

FFIEngineError: Error initializing ctypes和AttributeError: dlsym(...) EVP_PKEY_size: symbol not found

macOS系统不高时（比如Intel芯的MacBook系统版本升级受限），安装最新版本的 Package Control 可能会无法使用，查看控制台报错，可发现如下错误：

Traceback(most recent call last): File"~/Library/Application Support/Sublime Text 3/Installed Packages/Package Control.sublime-package/package_control/deps/oscrypto/_openssl/_libcrypto_ctypes.py", line305,in<module>File"./python3.3/ctypes/__init__.py", line366,in__getattr__ File"./python3.3/ctypes/__init__.py", line371,in__getitem__ AttributeError: dlsym(0x7ff90042fc60, EVP_PKEY_size): symbol not found

这是因为低版本的macOS系统默认的 OpenSSL 版本（LibreSSL 2.8.x）过旧，缺少 Package Control 新版本所需的加密符号，导致其核心功能无法启动。

解决版本就是降级 Package Control 到匹配的历史版本，在这里查看所有的历史版本：https://github.com/wbond/package_control/releases/

推荐使用最后一个支持 Sublime 3 的 Package Control 官方稳定版本：https://download.csdn.net/download/zhiyuan411/91800485

There are no packages available for installation

参见官方帮助：https://packagecontrol.io/docs/troubleshooting，就是Sublime安装源出问题了，例如安装源已经失效或者使用的代理不可用之类的。

This message is displayed whenever Package Control can not find any packages that are installable. The most common reason for this is an HTTP error in downloading package information from the default channel.

To help resolve the issue, follow these steps:

1. Select the View > Show Console menu entry
2. Look for any lines starting with Package Control:
3. Try enabling the debug log for more information
4. Ensure any proxy information is set in the Package Control settings
5. If you have a proxy and it rewrites secure connections, add its CA cert as trusted:
   1. Click the Preferences > Browse Packages… menu
   2. Open the User folder
   3. Create a file named Package Control.user-ca-bundle and paste in a PEM-formatted version of the certificate
6. Make sure you have the latest version of Package Control installed: 3.3.0
7. If you are still having trouble, review the open issues. If you do not find a relevant issue, please open a new one, and be sure to include your debug log.

推荐插件

官方最受欢迎插件榜单

https://packagecontrol.io/browse/popular

安装插件方法

1. 打开命令面板

   • 按下快捷键Command + Shift + P（macOS）或Ctrl + Shift + P（Windows/Linux），调出命令面板。

2. 选择安装命令

   • 在命令面板中输入Package Control: Install Package并回车（输入过程中会自动联想，可简化输入）。
   • 首次使用时，系统会先加载插件库索引，需等待几秒（底部状态栏会显示加载进度）。

3. 搜索目标插件

   • 在弹出的插件搜索框中，输入你需要安装的插件名称（如Emmet、Pretty JSON等），按回车或点击列表中的插件名称。
   • 搜索时无需输入完整名称，匹配关键词即可（如搜索json可找到Pretty JSON）。

4. 等待安装完成
   插件会自动下载并安装，底部状态栏会显示安装进度。安装完成后，通常会自动生效（部分插件可能需要重启 Sublime）。

5. 验证安装结果

   • 方法1：通过Preferences → Package Settings查看是否有目标插件的配置选项。
   • 方法2：使用插件特有的功能（如快捷键、右键菜单）验证是否生效。
   • 方法3：打开命令面板，输入插件相关命令（如Pretty JSON: Format JSON），确认能正常调出。

启用vim编辑模式

该插件默认就已经安装，但是默认是被屏蔽状态。点击菜单Preferences -> Settings，加入如下设置：

"ignored_packages":[]

这样就可以启用vim编辑模式，输入ESC后进入VIM编辑模式。

Flatland Theme

黑色主题，可以定制选中时的颜色。默认主题选中时的颜色太浅。

安装之后，在Preferences -> Color Schema中选中Flatland的主题即可应用。

ConvertToUTF8

该插件依赖另一个插件：Codecs33，先安装该插件。

该插件在打开文件时，自动识别GBK编码的文件并正确展示，也可以使用菜单File -> Set File Encoding to来改变当前文件编码。

Pretty JSON

该插件可以通过快捷键cmd + Ctrl + J格式化Json数据，更多功能可以命令面板（cmd + Shift + P）中输入Pretty JSON后查看支持的各种命令。

在菜单Preferences -> Key Bindings中添加如下内容来设置快捷键Ctrl + Alt + J来格式化Json数据：

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

BracketHighlighter

该插件可以自动标示出大括号，括号等匹配的另一部分，标识在行号之外，方便识别。

说明文档参考：Basic Usage - BracketHighlighter Documentation

在Preferences -> Package Settings -> BracketHighlighter -> Bracket Settings中添加如下设置：（这个是在成对的括号左侧显示一条竖线，表明开闭括号的范围与位置）

"content_highlight_bar":true

除了展示之外，跳转到匹配的括号等动作，可以通过命令面板（cmd + Shift + P）中输入BracketHighlighter来执行。需要设置快捷键，参见：https://github.com/facelessuser/BracketHighlighter/blob/master/Example.sublime-keymap

CodeFormatter

支持以下编程语言的格式化：

• PHP - By PHP_Beautifier
• JavaScript/JSON - By JSBeautifier
• HTML - By JSBeautifier
• CSS - By JSBeautifier
• Python - By PythonTidy (only Sublime Text 2)

使用快捷键Ctrl + Alt + F来执行格式化。

SublimeAStyleFormatter

支持对Java，C/C++，C#代码的格式化。

使用快捷键Ctrl + Alt + F来执行格式化。（和CodeFormatter会根据文件类型自动进行区分，如果发生冲突，也可以在Preferences -> Package Settings -> SublimeAStyleFormatter -> Key Bindings - Default中设置）

也可以点击右键使用AstyleFormatter -> Format来格式化代码。

packageresourceviewer

方便地修改包的内容，可以用来修改选中文字时的颜色。

安装之后，使用快捷键：cmd + shift + P来调用命令 packageresourceviewer: Open Resource 来打开包文件，我们在输入框里输入主题的名称：flatland即可进一步显示它的包内的文件，选中Flatland Monokai.tmTheme文件并打开编辑：

• 将selection配置项的值改为明显的颜色，例如：#3333FF

ChineseLocalizations

中文本地化菜单。

MarkdownEditing

Markdown编辑器，支持自动化补全。

安装后提示错误：Error loading syntax file** "Packages/Markdown/Markdown.xxxxx"，是因为在安装MarkdownEditing时打开了md文件，导致了和原生Markdown包的冲突。解决办法就是：将所有md文件关闭后，重启sublime，然后再重新打开md文件即可。

MarkdownEditing默认是GitHub 风格的 Markdown（扩展Markdown语法）。

修改为深色主题，要修改GFM的user配置文件（Settings -> Package Settings -> MarkdownEditing下寻找），添加以下代码，保存后立刻生效：– 已过时，现在的主题不再需要单独设置

{"color_scheme":"Packages/MarkdownEditing/MarkdownEditor-ArcDark.tmTheme"}

Compare Side-By-Side

一个简单的并排比较工具。

其他可选插件：File​Diffs：显示当前文件或当前文件中的选择与剪贴板、另一个文件或未保存的更改之间的差异。

如果使用Package Control安装失败，可以直接去GitHub下载：https://github.com/kaste/Compare-Side-By-Side/releases，解压缩后放入sublime的Packages文件夹内，注意：目录名不要带版本号，而是只保留“Compare-Side-By-Side”。

HexViewer

使用命令面板的命令可以将文件切换到十六进制查看模式，还支持有限的十六进制编辑以及额外的各种算法的Hash值计算。

A File Icon

在当前文件标题前显示不同类型文件的特定图标。

常见问题

文件标签状态标识说明

• ×：文件所有变更已保存，处于无修改的正常状态。
• 绿色实心圆圈●（未选中标签显示浅绿色）：文件存在未保存变更，且为新建未命名文件，执行保存操作时需手动指定存储路径与文件名。
• 灰色实心圆圈●（未选中标签显示浅灰色）：文件存在未保存变更，且为已命名的已打开文件。
• 红色实心圆圈●（未选中标签显示浅红色）：文件存在未保存变更，且为已打开文件、原文件丢失/不可访问（本地文件被删除/网络文件断开连接）。
• 所有实心圆圈标识，鼠标悬浮时将切换为×样式；点击该标识可关闭对应文件标签，系统将根据文件状态触发对应提示：未保存变更的文件弹出保存确认弹窗，原文件丢失的文件同步提示访问异常，已保存文件则直接关闭无额外提示。

新版本频繁弹窗付费提醒

Sublime Text采用"优雅共享"(Elegant Sharing)模式：提供无限期免费试用，所有功能完全开放，仅会不定期弹出付费提醒。官方明确表示：“个人或随意使用可不付费，但购买许可证可支持开发并去除提醒”。

如果能力所及，强烈推荐购买正版授权：$99 终身使用，所有设备同步，无弹窗，支持开发者。

Sublime Text Build 4200（2025年5月发布）显著加强了对未注册用户的弹窗提示频率，尤其是“保存操作”触发购买提醒的机制被明显收紧。故，可降级到旧版本（如 Build 4186 或 3211）：从官网（https://www.sublimetext.com/3）下载旧版本覆盖安装之后，关闭更新提示和自动更新。

部分解决办法：

1. 修改 hosts 文件：编辑sudo vi /etc/hosts，在末尾添加如下内容。效果：可阻止联网验证，减少启动时的弹窗，但本地保存次数触发的弹窗可能仍存在（因部分逻辑已内置于客户端）。

   127.0.0.1 license.sublimehq.com127.0.0.1 www.sublimetext.com127.0.0.1 sublimetext.com

2. 清理本地授权缓存文件：进入目录~/Library/Application Support/Sublime Text/Local/，删除或重命名以下文件（如有）。效果：弹窗频率暂时恢复到旧版水平，但若干次保存后可能再次出现。

   Local/Session.sublime_session Local/Settings.sublime_settings# 关键文件：Local/Registry.dat

设置vue文件自动使用HTML文件类型

1. 在Sublime Text中打开任意一个.vue文件，此时该文件默认的文件类型为Plain Text（纯文本），无语法高亮，也无法使用cmd + /注释快捷键；
2. 查看编辑器右下角状态栏，找到显示“Plain Text”的文件类型选项并点击；
3. 在弹出的语法选择菜单中，点击Open all with current extension as…（选项含义：将所有该扩展名的文件都以此类型打开）；
4. 在展开的子菜单中选择HTML，完成.vue文件与HTML文件类型的全局关联设置；
5. 生效效果：新打开的.vue文件会自动以HTML文件类型识别，具体表现为：
   • vue文件内的HTML/CSS代码会显示彩色的语法高亮样式，提升代码可读性；
   • 可正常使用macOS下的cmd + /注释快捷键，快速添加或取消单行/多行注释；
6. 注意事项：该设置仅对新打开的.vue文件生效，已经打开的vue文件需要先关闭再重新打开，或手动点击右下角文件类型并选择HTML，才能应用上述效果。