VSCode不能自动读取.editorconfig，必须安装并启用官方EditorConfig插件；插件生效后，右下角状态栏会显示与配置一致的缩进和换行符，否则需通过开发者工具检查加载日志。
EditorConfig 不能替代 PEP 8 检查或格式化工具，它只管基础缩进、换行、空格等编辑器层面的统一，Python 项目里必须配合 black 或 autopep8 才算真正落地代码风格一致。
VSCode 能自动读取 .editorconfig 吗？
能，但前提是安装了官方 EditorConfig 插件（EditorConfig for VS Code），且插件启用。VSCode 自身不内置 EditorConfig 支持。没装插件时，哪怕文件存在、路径正确，所有配置都完全无效。
- 插件安装后无需额外配置，重启 VSCode 即可生效
- 确认是否生效：打开一个 Python 文件，右下角状态栏会显示当前缩进类型（如
Spaces: 4）和换行符（CRLF或LF），这个值应与.editorconfig中定义的一致 - 如果状态栏没变化，用快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）输入Developer: Toggle Developer Tools，在 Console 里搜editorconfig看是否有加载错误
.editorconfig 里 Python 相关配置怎么写才不踩坑？
EditorConfig 是按文件扩展名匹配的，**.py 必须写对；常见错误是漏掉双星号或写成 *.py，导致子目录下的文件不生效。Python 项目通常还需覆盖 .ipynb 和 requirements.txt 等辅助文件。
[*.py]
indent_style = space
indent_size = 4
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
[*.ipynb]
end_of_line = lf
insert_final_newline = true
[*.{txt,md}]
trim_trailing_whitespace = false
-
indent_size = 4是 PEP 8 强制要求，别设成 2 或 tab —— 即使你个人习惯用 tab，Python 解析器不认 -
end_of_line = lf是跨平台关键：Windows 默认 CRLF，Linux/macOS 是 LF；Git 提交前若不统一，容易引发 diff 噪声 -
trim_trailing_whitespace = true对.py有用，但对.md或.txt可能误删有意为之的空格（比如 Markdown 的缩进列表），所以单独关掉
为什么改了 .editorconfig 但已有文件没自动重排版？
EditorConfig 不做格式化，它只告诉编辑器“新建行该用几个空格”“保存时删不删末尾空格”。已存在的缩进混乱、括号换行错误、空格缺失等问题，它完全不管。
立即学习“Python免费学习笔记（深入）”；
- 要批量修复旧文件，必须用
black .或autopep8 --in-place --aggressive --aggressive . - VSCode 的
Format Document（Shift+Alt+F）是否起作用，取决于你是否设置了默认 formatter（如ms-python.python或ms-python.black），且该 formatter 是否启用editor.formatOnSave - 推荐组合：
.editorconfig管编辑行为 +black管保存时格式化 +pre-commit钩子防漏网之鱼
最常被忽略的是：.editorconfig 对多行字符串、f-string、类型注解里的空格无感知，这些全靠 linter（如 pylint）或 formatter（如 black）兜底。编辑器配得再准，不跑一遍 black，团队提交的代码照样参差不齐。
