sublime text 4 插件安装失败90%因路径或命名错误：package control 必须放 installed packages/，github 插件 zip 解压后重命名文件夹并放入 packages/ 根目录，汉化包需配 "locale": "zh_cn" 且重启生效。
离线装不上，90% 是因为文件放错了目录，不是 Sublime 有问题，是路径或命名没对上。
Package Control 必须直投 Installed Packages/ 目录
ST4 启动后按 Ctrl+Shift+P 搜不到 Package Control: Install Package，说明它根本没加载——哪怕控制台显示 “installed”，也可能是旧脚本静默失败。
- 先运行
sublime.version()确认返回值是4xxx - 关闭 Sublime Text，进
Installed Packages/目录，删掉所有含Package Control字样的文件（包括Package Control.sublime-package和残留文件夹） - 从官方镜像下载完整包：https://www.php.cn/link/e24d10bcd13335d6929198e462e39f38（注意 URL 中空格是
%20） - 检查文件大小：必须在
180–220 KB；小于100 KB就是下载不全，丢弃重试 - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/，不解压、不改名、不放进子文件夹
GitHub 插件 ZIP 必须重命名后扔进 Packages/ 根目录
从 GitHub 点 Download ZIP 得到的压缩包，解压后默认是 Emmet-master/ 或 ConvertToUTF8-main/ 这类带后缀的文件夹——Sublime 不认这层包装壳。
- 打开
Preferences → Browse Packages…，这就是你要往里塞插件的Packages/目录 - 把解压后的文件夹重命名为插件官方名：
Emmet-master/ → Emmet/，Origami-dev/ → Origami/ - 大小写必须完全一致，不能多空格、不能加下划线、不能带
-master后缀 - 整个重命名后的文件夹直接拖进
Packages/根目录（不是Installed Packages/，也不是Packages/User/） - 检查该文件夹内至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand或sublime_plugin.EventListener的类
汉化包 ChineseLocalization 要配 "locale": "zh_CN" 才生效
只装插件不写配置，等于白装。它依赖用户设置里的 locale 字段触发翻译逻辑。
- 下载最新版
ChineseLocalization.sublime-package（截至 2026 年 7 月，v3.4.1是 ST4 兼容版本） - 拖入
Packages/目录（不是Installed Packages/），不要解压 - 彻底退出 Sublime Text（macOS 用 Activity Monitor 杀掉所有进程；Windows 在任务管理器中结束全部相关进程）
- 重启后，打开
Preferences → Settings，右侧用户设置里添加一行："locale": "zh_CN" - 保存后必须完全退出再重开——仅关闭窗口或
Cmd+Q可能残留后台进程，导致设置不加载 - 若仍为英文，检查是否误写成
zh-cn（小写）、zh_CN.UTF-8（多余后缀）或zh-Simplified（ST4 已弃用）
插件放对了但不生效？先查 ignored_packages 和语法作用域
命令面板搜不到、快捷键无效、菜单不出现——大概率不是没装上，而是被 Sublime 主动跳过。
- 打开
Preferences → Settings，检查右侧用户配置中是否有"ignored_packages"字段；如果刚放进去的插件名（比如"Emmet"）也在这个列表里，它就被静默屏蔽 - 插件常只在特定语法下触发：比如
VueSyntaxHighlight只响应.vue文件或text.html.vue作用域；开纯.html文件时右下角显示HTML，它就彻底沉默 - 可按
Ctrl+Shift+P输入Set Syntax:手动切换语法再试命令；或临时注释掉ignored_packages项验证 - 路径和命名必须严格匹配：Windows 上看着一样也不行，Sublime 对大小写、空格、层级极其敏感，错一个就静默失败
最容易被忽略的是路径层级和命名一致性——Sublime 不会提示“放错位置”，它只是沉默地跳过；ignored_packages 列表也从不报错，只让插件彻底消失。动手前多看一眼 sublime.version()，ST4 对校验更严格，旧版文件可能根本加载不了。
