必须先安装Package Control，它是Sublime插件生态的基础设施，未安装则无法安装EditorConfig等任何插件；验证方式为按Ctrl+Shift+P能搜到Package Control: Install Package命令，或菜单栏出现Package Control项。
EditorConfig-Sublime 必装，但得先装 Package Control
没装 Package Control 就没法装任何插件——它不是可选组件，是 Sublime 插件生态的基础设施。很多人卡在这一步，反复重装插件却始终不生效，根源就是 Package Control 没跑起来。
验证是否装好：菜单栏出现 Package Control 项，或按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P）能搜到 Package Control: Install Package 命令。
- 如果控制台报错
sublime.installed_packages_path() is None，说明 Sublime 启动异常，先关掉所有窗口再重开一次 - 粘贴安装代码后没反应？检查是否复制了不可见 Unicode 字符（比如全角空格），建议从官网 https://www.php.cn/link/ae586136fed585b47ccc2bc26537230e 复制最新版（2026 年已适配 ST4）
- 公司内网或防火墙严格时，
urlopen会超时；此时改用手动安装：git clone https://gitcode.com/gh_mirrors/pc/package_control到Packages/目录，重启即可
EditorConfig-Sublime 安装后不生效？检查 .editorconfig 文件位置和内容
插件装完只是第一步，真正起作用靠项目根目录下的 .editorconfig 文件。常见问题是文件放错位置，或规则写法与 Sublime 解析器不兼容。
-
.editorconfig必须放在项目最顶层目录（即打开 Sublime 时显示的文件夹），不能嵌套在src/或app/里 - 别用 Windows 记事本保存——它默认用
GBK编码且加 BOM，Sublime 会静默忽略该文件；用 Sublime 自己新建并保存，编码选UTF-8 - 基础规则要包含
root = true，否则子目录可能继承错误配置；例如：
root = true [*] indent_style = space indent_size = 2 end_of_line = lf charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true [*.md] max_line_length = 0
注意：max_line_length = 0 表示禁用自动换行，很多 Markdown 场景需要这个
搭配 Prettify 和 AutoFileName 提升规范落地效率
EditorConfig 管格式，但不解决“写错标签”“路径拼错”这类低级问题。两个轻量插件能补上关键缺口：
-
HTML-CSS-JS Prettify：按Ctrl+Shift+H（macOSCmd+Shift+H）一键格式化 HTML/CSS/JS，对齐缩进、空格、引号风格，直接响应.editorconfig规则 -
AutoFileName：输入import或require(时自动补全相对路径，避免手敲出../../utils/helper.js这种易错路径；补全结果也受.editorconfig的indent_style影响 - 二者都依赖
Package Control安装，搜索名就是全称，别简写成Prettify或AutoFile——后者会装错成其他插件
别忽略插件冲突：BracketHighlighter 和 EditorConfig 共存时的坑
当同时启用 BracketHighlighter（括号高亮）和 EditorConfig 时，某些语言（如 Python）可能出现缩进标记错位——高亮框偏移一格，看着像缩进错了，其实是渲染层叠加异常。
- 这不是 bug，是 Sublime 渲染优先级导致的视觉干扰；关闭
BracketHighlighter的bracket_styles中default配置项可缓解 - 更稳妥的做法：在
Preferences → Package Settings → BracketHighlighter → Bracket Settings – User里加一行："highlight_match": false，保留匹配跳转功能，只关高亮 - 如果项目用 ESLint 或 Prettier，建议把格式化交给它们，
EditorConfig只保留基础项（indent_style,end_of_line），避免多层规则打架
真正难的从来不是装插件，而是让每个规则在真实协作场景里稳定生效——路径、编码、层级继承、渲染干扰，漏掉任意一环，规范就只停留在配置文件里。
