EditorConfig-Sublime插件必须安装但不会自动修改已有代码，仅在新建、粘贴或保存时生效；需确保.editorconfig置于项目根目录、含root=true、关闭detect_indentation、依赖editorconfig-core-py可用。
EditorConfig-Sublime 插件必须装，但不能只靠它自动生效——它只读配置，不改文件。
EditorConfig-Sublime 安装后没反应？检查 .editorconfig 文件位置和内容
常见错误现象是：插件已装、.editorconfig 文件也放在项目根目录，但缩进/换行符仍不统一。根本原因是 EditorConfig 协议本身不修改现有文件，只在新建或保存时应用规则。
-
.editorconfig必须放在项目最顶层目录（即sublime-project所在目录或 Git 仓库根），且文件名全小写、无扩展名 - 确保文件里有明确的
root = true，否则子目录可能向上查找失败 - 检查关键字段是否拼错，比如
indent_style写成indent-style就会静默失效 - 如果用的是 Python 项目，
indent_size = 4和tab_width = 4要同时存在，否则 Sublime 可能忽略缩进设置
Package Control 安装失败？别粘贴旧版控制台代码
Sublime Text 4（2026 年主流版本）已内置 Package Control，无需手动执行控制台命令。强行粘贴 ST2/ST3 时代的 Python 下载脚本，大概率报错 AttributeError: module 'sublime' has no attribute 'installed_packages_path' 或连接超时。
- 直接按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package—— 如果命令可选，说明已就绪 - 若命令不存在，去官网
packagecontrol.io下载最新版Package Control.sublime-package，手动丢进Sublime Text/Packages/目录（不是Installed Packages） - 重启后，再打开命令面板搜
Package Control: List Packages，能列出已安装插件即为成功
SideBarEnhancements 和 BracketHighlighter 冲突？优先级要手动调
这两个插件都监听右键菜单和括号高亮事件，装完后偶尔出现右键无“Open in Terminal”选项，或匹配括号闪烁两次。这不是 Bug，是事件监听顺序问题。
- SideBarEnhancements 的右键菜单项默认权重较低，可在其设置中把
"show_open_with_menu": true改为false，避免和系统自带菜单抢焦点 - BracketHighlighter 的高亮延迟由
bracket_highlighter.sublime-settings中的"delay_ms"控制，默认 50ms；设为0会卡 UI，建议保留 20–30 - 如果同时启用
AutoFileName，它的路径补全会和 SideBarEnhancements 的“Reveal in Side Bar”快捷键（Ctrl+Shift+R）冲突，需在后者设置里禁用"reveal_on_sidebar"
SublimeREPL 运行 Python 报错“python not in path”？构建系统比插件更关键
很多人以为装了 SublimeREPL 就能直接跑 Python，结果点 Tools → SublimeREPL → Python → Python 弹出 python: command not found。其实 SublimeREPL 本身不带解释器，它只是个终端壳。
- 先确认系统级 Python 是否可用：终端执行
python --version或python3 --version，记下完整路径（如/usr/bin/python3或C:Python311python.exe） - 打开
Preferences → Package Settings → SublimeREPL → Settings – User，填入："default_extend_python_paths": ["/usr/bin"]（Linux/macOS）或"default_extend_python_paths": ["C:\Python311"]（Windows） - 更稳妥的做法是绕过 SublimeREPL，用 Sublime 自带构建系统：
Tools → Build System → New Build System…，写入"cmd": ["python", "-i", "$file"]，保存为Python-REPL.sublime-build，再绑定快捷键
真正难的不是装插件，而是理解每个插件在 Sublime 整体数据流中的位置——它是改文件内容、改编辑行为、还是改 UI 响应？搞错一层，调试半天。
