sublime text 装完需配置 path、package control、chineselocalization 插件及 "locale": "zh_cn" 并彻底重启，否则会出现 subl 命令失效、中文乱码、插件装不上、汉化不生效等问题。
Sublime Text 装完就能用，但“能用”和“顺手”之间差的不是功能，是那几个关键配置点没拧紧。跳过它们，你会反复遇到中文乱码、subl 命令失效、插件装不上、汉化后快捷键失灵——这些问题全在安装后前 5 分钟埋下伏笔。
为什么 subl 命令在终端里打不开？
这不是命令没装，而是 Shell 没认出它在哪。macOS 和 Linux 必须手动注册；Windows 则依赖安装时是否勾选了 “Add to PATH”。
- macOS：首次启动 Sublime Text 后，执行
shell commands插件安装（菜单栏 Tools → Command Palette，输入Install Shell Commands） - Linux（APT 安装）：
subl默认已可用；若用 tar 包解压安装，必须手动建软链接：sudo ln -s /opt/sublime_text/sublime_text /usr/bin/subl - Windows：重装时务必勾选安装向导里的 “Add to PATH”，否则 cmd/PowerShell 里敲
subl会报'subl' is not recognized - 验证方式：终端运行
which subl（macOS/Linux）或where subl（Windows），有输出路径才算成功
Package Control 安装失败的三种真实原因
控制台粘贴代码后没反应、弹窗卡住、或者提示 There are no packages available，基本都绕不开网络、权限或缓存这三关。
- 网络拦截：国内环境常被 DNS 污染，直接访问
https://packagecontrol.io可能超时。改用命令面板输入Package Control: Install Package后等待 60 秒，别急着关窗口——它在后台尝试备用源 - 权限问题：Linux 下若以 root 启动过 Sublime Text，
~/.config/sublime-text-4/Cache/Package Control/目录可能属 root，导致普通用户无法写入。删掉整个Cache文件夹即可 - 缓存污染：如果之前装过非官方插件或修改过
Preferences.sublime-settings，Package Control会拒绝加载。临时重命名~/.config/sublime-text-4/Packages/User/为User.bak，再试安装
汉化后快捷键失效或界面错位？
别装“汉化包”，那是最危险的捷径。所有界面文字替换必须走 ChineseLocalizations 插件，且不能跳过重启步骤。
- 安装路径必须严格：通过命令面板执行
Package Control: Install Package→ 输入ChineseLocalizations→ 点击安装（不是拖文件进Packages目录） - 安装后必须重启一次 Sublime Text，否则语言切换菜单不出现；重启后去 Help → Language → 简体中文 才生效
- 如果快捷键变中文（如“保存”显示为 Ctrl+S 但按钮标着“保 存”），说明你误启用了第三方 UI 补丁。删掉
~/.config/sublime-text-4/Packages/ChineseLocalization（注意拼写）目录，只保留ChineseLocalizations - 高分屏用户额外注意：汉化后若菜单字体糊或缩放异常，在
Preferences.sublime-settings用户配置里加一行："font_options": ["gray_antialias"]
如何让配置真正“跨设备复用”？
Sublime Text 的 data 目录才是你所有习惯的实体，不是安装包也不是注册码。它一丢，插件、设置、甚至侧边栏折叠状态全归零。
- 位置固定：
~/.config/sublime-text-4/（Linux）、~/Library/Application Support/Sublime Text/（macOS）、%APPDATA%\Sublime Text\（Windows） - 迁移时只复制
Packages/User/和Installed Packages/两个文件夹，其余可忽略；Cache/和Index/是临时生成的，不用搬 - 同步建议：用
rsync或git管理User/目录，不要用网盘自动同步整个data目录——Index/里有平台相关索引，跨系统同步会导致崩溃 - 一个硬提醒：每次升级 Sublime Text（比如从 Build 4162 升到 4192），
Installed Packages/里的插件不会自动更新，得手动在命令面板执行Package Control: Upgrade Package
