Sublime Text 需安装官方 EditorConfig 插件（非 Tools 或旧版），.editorconfig 必须置于项目根目录并用 Open Folder 打开项目，插件才可逐级上溯识别；状态栏显示路径即生效，否则查控制台报错。
Sublime Text 本身不原生解析 .editorconfig，但通过安装插件可以完整支持项目级代码风格配置——关键在于装对插件、放对文件、配对路径。
必须安装 EditorConfig 插件（不是其他同名插件）
Sublime 的包管理器里搜 EditorConfig，认准作者是 EditorConfig 官方团队（GitHub 仓库名 editorconfig/editorconfig-sublime）。装错成 EditorConfig Tools 或旧版 SublimeEditorConfig 会导致不生效或报错 Unable to parse .editorconfig。
- 用
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板，输入Package Control: Install Package - 搜索并安装
EditorConfig（图标是蓝色齿轮） - 安装后无需重启，但需确保当前文件属于某个含
.editorconfig的项目根目录下
.editorconfig 文件必须放在项目根目录且路径可上溯
EditorConfig 插件默认从当前打开的文件路径逐级向上查找 .editorconfig，直到找到第一个匹配文件或到达文件系统根。它不会跨磁盘/挂载点查找，也不会读取 Sublime 的 project.sublime-project 里指定的“工作区路径”以外的目录。
- 正确位置：
/my-project/.editorconfig，且你通过File → Open Folder…打开的是/my-project - 错误示例：文件在
/my-project/src/main.js，但.editorconfig放在/my-project/config/.editorconfig—— 插件不会自动识别该路径 - 若必须放子目录，可用
root = true显式终止上溯，再配合[*]段落覆盖全部文件
常见配置项与 Sublime 实际生效行为
Sublime 的 EditorConfig 插件只实现核心规范，不支持所有字段。比如 trim_trailing_whitespace 和 insert_final_newline 仅在保存时触发（需开启 save_on_focus_lost 或手动 Ctrl+S），而 indent_style、indent_size、end_of_line 是实时生效的编辑器行为。
[*] indent_style = space indent_size = 2 end_of_line = lf charset = utf-8 trim_trailing_whitespace = true insert_final_newline = true max_line_length = 100[*.md] indent_size = 4
-
max_line_length不会自动换行，仅作提示（Sublime 需额外装TrailingSpaces或SublimeLinter-contrib-alex类插件辅助） -
charset影响文件保存编码，但打开已存在的非 UTF-8 文件时，Sublime 仍按自身检测逻辑解码，不会强制转码 - 通配符如
[*.py]或[package.json]必须严格匹配扩展名或文件名，不支持 glob 双星号（**/*.py）
调试不生效？先看状态栏和控制台
插件启用后，Sublime 窗口右下角状态栏应显示当前生效的 .editorconfig 路径（如 EditorConfig: /my-project/.editorconfig）。不显示说明未命中，此时打开 Ctrl+` 控制台，查看是否有 EditorConfig: No config file found 或 parse error on line X。
- 典型 parse error：用了
# comment但前面有空格、等号前后加了空格（indent_size = 2✅，indent_size= 2❌） - 路径问题：用
File → Open Folder…打开项目；若只用File → Open File…单个文件，插件无法定位项目根 - 权限问题：Windows 下某些网络路径或 OneDrive 同步目录可能被拦截，建议先复制到本地磁盘测试
真正卡住的地方往往不是语法写错，而是 Sublime 没“意识到”自己在一个项目里——它不靠 .sublime-project 文件驱动 EditorConfig，只认物理目录结构和文件存在性。
