必须勾选Add to PATH、Add to explorer context menu及手动运行subl --install-cmd等关键步骤，否则将导致命令行不可用、右键菜单缺失、插件安装失败等问题。
Windows/macOS/Linux 安装必须避开的三个默认选项
直接双击安装包一路“下一步”，大概率会卡在后续使用环节：命令行打不开、右键菜单不出现、插件装不上。根本原因不是软件问题，而是安装时没干预默认配置。
- Windows 用户必须勾选
Add to PATH—— 否则终端里敲subl会报'subl' is not recognized；不勾选Create desktop shortcut倒不影响功能，但缺了右键菜单（Add to explorer context menu）会导致无法右键 .py/.json 文件直接用 Sublime 打开 - macOS 用户若用
brew install --cask sublime-text安装，subl命令自动可用；但若拖拽 .dmg 安装，必须手动运行一次sudo /Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl --install-cmd，否则subl .不生效 - Linux（Ubuntu/Debian）严禁用
sudo apt install sublime-text装社区源版本——它自带旧版 Package Control，且.sublime-package加载失败率超 70%；正确做法是添加官方源：wget -qO - https://download.sublimetext.com/sublimehq-archive.gpg | sudo apt-key add -，再sudo apt update && sudo apt install sublime-text
首次启动后必须改的四个首选项
刚打开 Sublime Text 是“能用但总差点意思”的状态。真正影响日常效率的不是主题或字体大小，而是这四条底层行为设置。
-
"font_size": 12→ 改成14或15：高分屏下默认字号太小，肉眼易疲劳，且不会影响缩放逻辑 -
"translate_tabs_to_spaces": false→ 强制设为true：避免协作时混用 tab/space 导致 Git diff 爆炸，Python/JS/YAML 项目尤其敏感 -
"detect_indentation": true→ 改成false：否则打开别人传来的文件时，Sublime 会自作主张重排缩进，改完保存反而破坏原格式 -
"ensure_newline_at_eof_on_save": true→ 保留该值：Git 提交时少一堆no newline at end of file警告，CI 流水线更干净
中文界面不是装个插件就完事
很多人装完 ChineseLocalization 发现菜单栏变中文了，但状态栏、命令面板、错误提示仍是英文——这是因为插件只翻译 UI 字符串，不触碰核心语言环境。
- 必须重启 Sublime Text 两次：第一次装完插件后重启，第二次在
Preferences → Package Settings → ChineseLocalization → Settings – User里填入{"language": "zh-CN"}再重启 - 如果仍显示英文，检查是否误装了
Chinese (Traditional)插件（名字极相似），它只翻译繁体，且与简体包冲突 - Mac 上部分系统级弹窗（如“无法打开因为来自未识别开发者”）无法被插件覆盖，这是 macOS Gatekeeper 行为，需手动右键 → “打开”绕过，不是 Sublime 问题
Package Control 安装失败的三种真实原因
粘贴那段经典 Python 安装脚本后没反应？不是网络问题，多数是权限或路径错位。
- Windows 下用管理员身份运行 Sublime Text 才能写入
%LOCALAPPDATA%\Sublime Text 3\Installed Packages\；普通用户权限下脚本静默失败，无报错 - macOS 上如果 Sublime 是从 App Store 或非官网渠道安装，
sublime.installed_packages_path()返回空路径，脚本直接跳过写入 - Linux 用户若用 snap 安装，沙盒机制禁止访问
~/.config/sublime-text-3/Installed Packages/，必须改用 deb 包安装
真正稳定的安装方式，是先确认 sublime.installed_packages_path() 返回路径存在且可写，再执行脚本——否则装了也白装。
