package control是硬性前置，2026年st4必须用官网标“sublime text 4”且含hashlib.sha256校验的脚本（如h='df21e130'+'eea76'），旧脚本会静默失败；执行成功后务必重启，再通过ctrl+shift+p验证package control: install package是否可用。
Package Control装不对，后面全白搭
所有排错类插件都依赖它，不是“推荐”，是硬性前置。2026年Sublime Text 4必须用官网标为“Sublime Text 4”的安装脚本，含hashlib.sha256校验段——旧版urllib2或缺校验的脚本会静默失败，控制台报AttributeError: module 'urllib' has no attribute 'request'或URLError。
操作步骤：
- 按
Ctrl + `打开控制台，粘贴官网最新脚本（含h = 'df21e130' + 'eea76'这类校验值） - 看到
Successfully installed后必须重启 Sublime - 重启后按
Ctrl + Shift + P输入Package Control: Install Package，左下角出现Fetching list of available packages才算就位 - 若仍无响应，先执行
Package Control: Synchronize Sources；公司网络开代理时需临时关闭
SublimeLinter + 具体 linter 才真能标红报错
SublimeLinter本身不检查任何代码，它只是个调度器。只装它，编辑器完全静默，你不会看到任何波浪线或提示——这不是插件没生效，是根本没配干活的人。
真实排错链路：
- JavaScript：装
SublimeLinter+SublimeLinter-eslint+ 项目根目录有.eslintrc.js或package.json里含eslintConfig - CSS/SCSS：装
SublimeLinter+SublimeLinter-stylelint+ 项目有.stylelintrc - Python：装
SublimeLinter+SublimeLinter-pylint或SublimeLinter-flake8，确保系统已装pylint或flake8 - 报
No config found不是插件问题，是项目缺配置文件
Debugger插件断点不生效？先看这三处
Debugger（蓝色靶心图标）不是万能调试器，它只桥接外部调试适配器。断点能设但不停，大概率卡在这三个地方：
-
program字段写成$file或漏引号——必须是"${file}"；cwd写成"./"会导致ModuleNotFoundError，得用"${fileDirname}" - Python解释器路径不对：终端跑
which python3，配置里显式填"python": "/usr/bin/python3"（Mac/Linux）或完整Windows路径 - PHP/Xdebug：确认
xdebug.mode=debug且xdebug.client_port=9003，和launch.json中port一致；浏览器访问要带?XDEBUG_SESSION_START=1
插件报错定位：别信弹窗标题，盯控制台第一行
Sublime 插件出错时，弹窗标题常误导人（比如写“无法启动”），真正线索在控制台（Ctrl + `）顶行红色堆栈：
- 第一行
File "./Packages/Emmet/main.py"里的Emmet就是真凶，不是别的插件 -
ImportError: cannot import name 'create_connection'——插件调用了 ST 内置 Python 不支持的标准库函数，得换兼容版或删掉 -
ssl.CERTIFICATE_VERIFY_FAILED不是插件问题，是系统时间不准（误差＞5分钟）、证书过期或杀软拦截；关ssl_verification只是掩耳盗铃 -
NoneType is not callable——插件主文件里on_activated这类回调被删了或没定义，不是配置问题
最易被忽略的是：插件路径放错位置、ignored_packages静默屏蔽、以及修改channels后没重启 Sublime——这三件事不做，装了也等于没装。
