.editorconfig 生成器

#.editorconfig 是什么？

.editorconfig 是一份「编辑器层」的代码风格约定：一个纯文本 INI 格式文件，加上各编辑器的 EditorConfig 插件， 就能让同一个仓库里的所有人在任何编辑器中保持一致的缩进字符、缩进宽度、字符集与行尾。它只管最基础的三件事—— 缩进（空格还是 Tab、每级几格）、字符集（utf-8 等）、行尾（lf/crlf/cr），外加最终空行与行尾空白两类清理； 引号单双、分号、换行宽、import 排序、代码质量等规则不在它的管辖范围内。

与 Prettier、ESLint 的分工

三者常被混为一谈，其实分工清晰：

• EditorConfig：最底层，管「文件的物理形态」——缩进字符、字符集、行尾，任何语言、任何编辑器通用，保存前就生效。
• Prettier：管「排版后的代码长相」——引号、分号、折行宽度、逗号风格，按语言解析后重新输出代码。
• ESLint：管「写法对不对」——代码质量与部分风格规则，可自动修复，能约束逻辑层面的约定。

通常的做法是三者并存：EditorConfig 作为全仓库公共底线，Prettier 负责格式化，ESLint 负责质量检查， 并让 Prettier 的 useTabs / tabWidth 选项与 .editorconfig 保持一致，避免互相打架。

放哪里？生效范围怎么算？

.editorconfig 放在哪个目录，就对哪个目录及其全部子目录生效。编辑器打开文件时，从文件所在目录逐级向上查找 .editorconfig， 离文件越近的设置优先级越高，下层可覆盖上层。放仓库根目录是标准做法：团队成员 clone 后无需任何额外配置即可共享同一套规则。 根目录文件里的 root = true 声明告诉插件「到此为止，别再向上查找」， 避免个人 home 目录里的全局配置混入团队仓库。子项目、monorepo 的子包也可以放自己的 .editorconfig 单独收窄规则。

常见分节写法

[*]                          # 所有文件
indent_style = space
indent_size = 2

[*.{js,ts,vue}]              # 大括号匹配多种后缀
max_line_length = 100

[**.py]                      # 任意目录层级下的 .py
indent_size = 4

[src/**]                     # src 目录下的所有文件
charset = utf-8

[Makefile]                   # 精确文件名，必须用 Tab
indent_style = tab

* 匹配除路径分隔符外的任意字符串，** 可跨目录层级， {a,b} 表示多模式任选，\* 转义后只匹配字面星号。 写在后面的分节优先级更高，可覆盖前面的同名设置。

为什么 Makefile 必须用 Tab 缩进？

Makefile 的语法硬性规定：规则下面的命令行必须以一个真实的 Tab 字符（\t）开头，这是 make 解析语法的依据而不是风格偏好—— 如果编辑器把 Tab 自动替换成空格，make 会直接报「missing separator」错误。所以 Makefile 在 .editorconfig 里必须单独分节 写 indent_style = tab，显式覆盖通用区的空格缩进。同理，YAML 对缩进字符敏感（禁止 Tab）、 Markdown 渲染时 Tab 宽度不定，这类文件也建议单独分节处理。

#常见问题 (FAQ)