404错误源于Package Control请求channel列表时地址失效或被拦截，与插件本身无关；需检查channels配置、更换镜像源（如Gitee）、重启Sublime，并确保.sublime-package文件放入Installed Packages/目录。
404 错误不是插件坏了，是 Package Control 去请求 channel 列表时返回了 404 —— 本质是它访问的 JSON 地址失效或被拦截，和你要装的那个插件本身完全无关。
Package Control: Install Package 命令根本没出现
这是所有“404”类问题的前置陷阱：命令面板搜不到 Package Control: Install Package，说明 Package Control 没加载，后续任何安装操作都无效。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control，看是否有响应 - 没有？打开控制台（
Ctrl+`），粘贴 ST4 官方手动安装脚本（含hashlib.sha256校验的那一版），执行后必须看到Success - 执行成功后，**必须完全退出 Sublime（右键任务栏选「退出」，不是关窗口）再重启**，否则不生效
- ST4 用户若用旧脚本，会因缺少
hashlib.sha256报错；ST3 用户则可能因证书过期卡在 SSL 验证
There are no packages available for installation
这个提示 = Package Control 成功运行了，但请求 "channels" 地址时返回空、404 或超时。国内用户几乎全是这个原因。
- 打开
Preferences → Package Settings → Package Control → Settings – User，检查"channels"字段是否为空或只有一条默认地址（如"https://packagecontrol.io/channel_v3.json"） - 把该 URL 粘到浏览器里直接访问——打不开就换镜像，别等
- 推荐用 Gitee 镜像：
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"，2026 年仍稳定 - 改完配置后**必须重启 Sublime**，缓存不会自动刷新
- 如果控制台报
schema_version mismatch，说明 channel 版本和 Package Control 不匹配，统一用channel_v3.json
.sublime-package 文件放错目录导致“装了等于没装”
手动下载的 EmmyLua.sublime-package 类文件，放进错位置会被 Sublime 完全忽略，不报错、不提示、也不加载。
-
.sublime-package文件 → 必须直接丢进Installed Packages/目录（不是Packages/！） - GitHub 下载 ZIP 解压后的文件夹（如
Emmet/）→ 必须整体复制进Packages/根目录，不能嵌套、不能带-master后缀 - 不确定路径？在控制台运行
print(sublime.installed_packages_path())和print(sublime.packages_path())查真实路径 - Windows 路径示例：
%APPDATA%\Sublime Text 4\Installed Packages\和%APPDATA%\Sublime Text 4\Packages\
插件文件夹在 Packages/ 里却没反应
文件放对了，重启也做了，但命令面板搜不到、快捷键不触发——八成是被 ignored_packages 屏蔽了。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 常见值如
["Vintage", "Anaconda"]，如果你刚放进去的插件叫OmniMarkupPreviewer，而它也在这个列表里，就会静默失效 - 删掉对应项，或整行注释掉，保存后**必须重启 Sublime** 才生效
- 某些插件（如
Origami）还需在命令面板里手动执行一次初始化命令，不是放进去就自动弹窗
真正离线环境或内网受限时，手动安装反而是最快最可控的方式；但最容易被忽略的是：文件夹命名必须和插件官方名**完全一致**，多一个字符、少一个大写，Sublime 就不认。
