跨语言团队协作编码标准必须由.editorconfig、.vscode/settings.json、prettier、eslint四层配置兜底：.editorconfig定义缩进/换行/编码等编辑器基础行为，原生跨工具生效；.vscode/settings.json需提交git作为工作区契约，指定默认格式化器与保存行为；prettier专注排版统一，eslint专注代码质量，二者职责分离并禁用冲突规则；多根工作区需在.code-workspace中统一基础设置，子项目补充语言特有配置。
直接上结论：跨语言团队协作的编码标准，不能靠人盯人或口头约定，必须用 .editorconfig + 项目级 .vscode/settings.json + prettier + eslint（按语言启用）四层配置兜底，缺一不可。
为什么.editorconfig是跨语言协作的第一道防线
它不依赖任何插件或语言服务器，只定义编辑器基础行为，且被 VSCode、IntelliJ、Sublime 等主流工具原生支持。只要文件放在项目根目录，所有成员打开即生效。
-
indent_style和indent_size统一缩进方式——Python 要 4 空格，TypeScript/HTML 推荐 2 空格，[*.py]段可单独覆盖 -
end_of_line = lf强制换行符为 LF，避免 Windows/Mac/Linux 提交时出现大量^M差异 -
charset = utf-8防止中文注释、日志输出乱码，尤其在 Node.js 或 Python subprocess 场景下关键 - 别把
[*.md]的trim_trailing_whitespace设为true，否则 Markdown 表格对齐会被破坏
vscode/settings.json 必须提交到 Git，而不是忽略
很多人误以为这是“个人设置”，加到 .gitignore，结果新人 clone 后格式化全乱。这个文件本质是工作区契约，优先级高于用户全局设置。
- 必须指定
"editor.defaultFormatter": "esbenp.prettier-vscode"，否则不同人可能用着不同的格式化器 -
"editor.formatOnSave": true是底线，但要配合"editor.codeActionsOnSave": { "source.fixAll.eslint": true }才能兼顾格式+质量 - 对多语言项目，
"eslint.validate"应按需列出：比如["javascript", "typescript", "vue", "markdown"]，但不要加"python"——ESLint 不处理 Python - 如果团队混用 Python，得额外配
pylance+black，并在settings.json里加"python.defaultInterpreterPath"和"python.formatting.provider": "black"
Prettier 和 ESLint 的分工必须清晰，否则保存时互相打架
常见错误是让 Prettier 处理引号、分号，又让 ESLint 也检查这些——结果保存一次，代码来回跳两次，最后还报错。
- Prettier 只管“怎么排版”：
printWidth、singleQuote、trailingComma；它的配置里**不要出现**no-unused-vars这类逻辑规则 - ESLint 只管“怎么写对”：变量作用域、未使用导入、潜在
undefined访问等；需用eslint-config-prettier关闭所有与 Prettier 冲突的格式规则 - TypeScript 项目务必加
@typescript-eslint插件，否则any、explicit-function-return-type这类规则压根不生效 - Vue 项目注意
eslint-plugin-vue的版本兼容性：v9+ 要求 Vue 3，若混用 Vue 2 组件，得降级或用eslint-plugin-vue@8
容易被忽略的细节：多根工作区和语言专属设置的冲突
当团队用多根工作区（.code-workspace）管理前端+后端+共享库时，.vscode/settings.json 放在哪，优先级就落在哪。
- 如果只在某个子项目（如
frontend/）里放了settings.json，那后端开发者打开整个工作区时，该配置不会自动继承 - 正确做法：在
.code-workspace文件里显式声明"settings"，例如统一"editor.tabSize": 2；子项目再用自己的settings.json补充语言特有规则（如 Python 的python.formatting.provider） - VSCode 对
Makefile、shell、dockerfile等配置项默认不启用格式化，需手动在settings.json加"[makefile]": { "editor.insertSpaces": false }，否则 Makefile 会因空格缩进而失效
