Sublime如何设置一个项目级的代码风格配置文件？ (.editorconfig支持)

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，只认物理目录结构和文件存在性。