安装sublime text时必须勾选add to explorer context menu、add to path、create a desktop shortcut三项；路径避免中文或空格；package control需用官方install.sh或最新python脚本安装；chineselocalization生效需检查ignored_packages、default_locale及插件版本；python构建系统路径须用正斜杠或双反斜杠。
安装时必须勾选的三项系统级选项
跳过这三项，后续所有配置都会打折扣——不是功能不能用，而是要用时才发现缺了底层支撑。
-
Add to explorer context menu：不勾，右键任何文件都找不到“Open with Sublime Text”，连快速编辑日志都得先拖进编辑器窗口 -
Add to PATH：不勾，终端里敲subl .会报command not found，Git commit message、脚本调用、CLI 集成全断链 -
Create a desktop shortcut：非强制但强推荐，尤其 Windows 用户，开始菜单里搜“sublime”有时因索引延迟根本不出结果
路径别改到带中文或空格的目录（比如 C:Program Files (x86)Sublime Text 或 D:我的软件Sublime），否则后续 Python.sublime-build 里写路径容易触发解析失败，错误信息是 Unable to find target command 或直接静默失败。
Package Control 安装失败的真正原因和绕过方案
官方推荐的控制台安装脚本在 2026 年已默认要求 sha256 校验，直连 http://packagecontrol.io/ 会因证书或重定向失败而卡住。这不是网络问题，是校验机制升级后的必然现象。
- Windows/macOS/Linux 通用安全安装方式：用终端执行
curl -fsSL https://packagecontrol.io/install.sh | bash（需确保subl已加入 PATH） - 若终端不可用，改用浏览器访问
https://packagecontrol.io/installation，复制页面上最新版 Python 脚本（注意看页脚时间戳是否为 2026 年），粘贴进 Sublime 的 Console（Ctrl+`）后回车 - 装完不重启就搜不到
Install Package？检查左下角状态栏是否出现Package Control字样；没出现就说明installed_packages_path()返回路径异常，手动在命令行查：subl --command "print(sublime.installed_packages_path())"
ChineseLocalization 插件不生效的三个隐藏开关
装完插件重启后还是英文界面？大概率不是插件坏了，而是被三处配置静默屏蔽了。
-
"ignored_packages": ["ChineseLocalization"]：打开Preferences → Settings – User，确认该数组里没它；有就删掉，保存后立刻生效 -
"default_locale": "en"：同样在用户设置里，改成"default_locale": "zh_CN"；注意别漏引号，也别写成zh-cn或zh，只有zh_CN被识别 - 插件本身被降级：ST4.4.5 后，旧版
ChineseLocalization会因 API 变更报错退出；必须通过 Package Control 重新 Install，不要手动覆盖.sublime-package文件
改完设置后不用重启，Sublime 会热重载 locale，但菜单栏可能要点击一次 View → Command Palette 才刷新语言。
Build System 中 Python 路径失效的斜杠陷阱
Python.sublime-build 里写错一个斜杠，运行就黑屏或报 [WinError 2] 系统找不到指定的文件。这不是路径不存在，是 Windows 下反斜杠被当转义符处理了。
- 绝对路径必须用正斜杠或双反斜杠：
"cmd": ["C:/Python39/python.exe", "-u", "$file"]或"cmd": ["C:\Python39\python.exe", "-u", "$file"] - 千万别写成
C:Python39python.exe—— 控制台里显示正常，实际执行时P和p会被解释为退格或响铃字符 - Mac/Linux 用户注意：不要硬写
/usr/local/bin/python3，用which python3实际查，很多 M1/M2 Mac 默认是/opt/homebrew/bin/python3 - 验证是否生效：建个
test.py写print("ok")，按Ctrl+B，看底部面板输出是否含ok；没输出就说明 build system 没加载成功，回头检查selector是否为"source.python"
最稳妥的做法是新建 Build System（Tools → Build System → New Build System…），只填 cmd 和 selector，其他字段全删——越简陋越不容易出错。
