sublime text安装后需完成四项关键配置才能正常使用:windows安装时必须勾选add to explorer context menu、add to path、create a desktop shortcut;package control须用含sha256校验的最新脚本安装并重启;chineselocalization插件需从ignored_packages列表中移除;build system需注意路径斜杠格式、编码设置及环境变量继承。

装完 Sublime Text 不能直接用——按 Ctrl+Shift+P 没反应、右键没“Open with Sublime Text”、中文界面出不来、写完 Python 按 Ctrl+B 报错,基本都是因为跳过了这几个配置步骤。
安装时必须勾选的三项选项
Windows 下双击 sublime_text_build_xxxx_x64_setup.exe 后,在 “Select Components” 页面,这三项不勾等于白装:
-
Add to explorer context menu:不勾,右键文件就找不到“Open with Sublime Text” -
Add to PATH:不勾,命令行输subl打不开编辑器,Git 集成、脚本调用全失效 -
Create a desktop shortcut:非强制但强烈建议,尤其新手别靠开始菜单找图标
路径别改到带中文或空格的目录(比如 D:我的软件Sublime Text),否则后续 Build System 容易因路径解析失败而报 File not found 或 Permission denied。
Package Control 必须手动装,且 ST4 要校验 sha256
ST4(2026 年主流版本)的 Package Control 安装脚本已变更,旧版代码会静默失败——你粘贴完没报错,但 Ctrl+Shift+P 里搜不到 Install Package,就是没装上。
正确做法是打开控制台(Ctrl+`),粘贴官方最新脚本(含 sha256 校验):
import urllib.request,os,hashlib; h = '2915d1851351e5ee549c20394736b442' + '8bc59f460fa1548d1514676163dafc88'; 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('https://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); open(os.path.join(ipp, pf), 'wb').write(by) if dh == h else None; print('Error validating download' if dh != h else 'Restart Sublime Text')
执行后必须重启 Sublime Text,左下角出现 “Package Control” 提示才算成功。如果没提示,说明校验失败,得重试或手动下载 Package Control.sublime-package 放进 Installed Packages 目录。
ChineseLocalization 插件常被 ignored_packages 屏蔽
装完插件后界面还是英文?不是插件没生效,而是它被默认屏蔽了。
检查路径:%APPDATA%Sublime TextPackagesUserPreferences.sublime-settings(Windows)或 ~/Library/Application Support/Sublime Text/Packages/User/Preferences.sublime-settings(macOS),确认里面没有这一行:
"ignored_packages": ["ChineseLocalization"]
如果有,删掉或把 ChineseLocalization 从数组里移除。再重启,中文才真正生效。ST4 默认会把部分插件加入 ignored_packages 列表,这是个隐蔽坑点。
Build System 配置最容易栽在路径斜杠和编码上
写完 C++ 或 Python 按 Ctrl+B 报错,八成是 Build System 的路径写法或编码没对:
- Windows 上用反斜杠
会被当成转义符,必须写成正斜杠/或双反斜杠\ - Python 中文输出乱码?加
"encoding": "utf-8"不够,还得确保系统 locale 是 UTF-8(Linux/macOS 默认是,Windows 得开 Beta 版 UTF-8 支持) - C++ 编译报
g++: command not found?不是插件问题,是PATH没设好——MinGW 或 MSVC 的 bin 目录必须在系统环境变量里,且 Sublime 启动方式要能继承该变量(桌面快捷方式启动有时会丢PATH,建议改用命令行subl .启动)
Build System 文件保存时,文件名必须是 xxx.sublime-build(比如 C++.sublime-build),扩展名错一个字母就不识别。
最麻烦的不是某一步不会做,而是某一步看似做完、其实没生效——比如 Package Control 安装无提示、ChineseLocalization 在 ignored 列表里、Build System 的 shell_cmd 里漏了个引号。这些地方没报错,但功能就是卡住,得一个个排查。











