VS Code settings.json 配置
在团队开发中，统一的编码格式是提升协作效率、避免冲突的关键。
本文整理了两套VS Code的settings.json配置（无插件版+插件版），附带逐行注释和配置总结，适配前端/Node.js项目，新手可直接复制使用，老手可按需微调，兼顾规范性和实用性。
1. 无插件版（极简刚需·轻量化适配）
适用于刚入门开发者、极简党，或追求编辑器轻量化的场景，核心解决团队协作中4大格式痛点，无需安装任何插件，配置简洁高效。
以下是完整配置及逐行注释：
{// ========== 编码设置 ==========// 强制默认编码为 UTF-8 (无BOM)，确保所有文件统一编码，避免跨平台乱码"files.encoding":"utf8",// 关闭自动猜测文件编码，防止VS Code误识别为GBK导致乱码（Windows/Mac跨平台协作必配）"files.autoGuessEncoding":false,// ========== 缩进设置 ==========// 设置缩进宽度为2个空格，统一团队缩进标准"editor.tabSize":2,// 输入Tab键时自动替换为空格，避免Tab与空格混用导致格式混乱"editor.insertSpaces":true,// 关闭自动检测文件缩进，强制使用上述2空格缩进，避免缩进忽大忽小"editor.detectIndentation":false,// ========== 换行符设置 ==========// 设置文件换行符为\n（LF，Unix风格），适配Linux/macOS环境，避免跨平台提交代码时换行符冲突"files.eol":"\n",// ========== 编辑器功能优化 ==========// 关闭粘性滚动（代码滚动时顶部不固定当前层级），提升编辑视野整洁度"editor.stickyScroll.enabled":false,// 启动时不恢复上次打开的窗口，保持编辑器启动干净，提升专注力"window.restoreWindows":"none"}配置目的总结
| 类别 | 作用 |
|---|---|
| 编码统一 | 强制UTF-8无BOM，杜绝GBK乱码问题 |
| 缩进统一 | 2空格缩进，Tab自动转空格，避免格式混乱 |
| 换行统一 | LF换行符（Unix风格），解决跨平台冲突 |
| 启动行为 | 不恢复上次窗口，保持启动界面整洁 |
适用场景：纯前端/Node.js项目、跨平台团队协作、轻量化编辑器需求。
2. 插件版（完整适配·颜值与实用双在线）
在无插件版基础上，新增插件配置和外观美化，适配有插件使用需求、追求编辑器视觉体验的开发者，兼顾编码规范、协作效率和使用舒适度。
以下是完整配置及逐行注释：
{// ========== 编码设置 ==========// 强制默认编码为 UTF-8 (无BOM)，确保所有文件统一编码，避免跨平台乱码"files.encoding":"utf8",// 关闭自动猜测文件编码，防止VS Code误识别为GBK导致乱码"files.autoGuessEncoding":false,// ========== 缩进设置 ==========// 设置缩进宽度为2个空格，统一团队缩进标准"editor.tabSize":2,// 输入Tab键时自动替换为空格，避免Tab与空格混用导致格式混乱"editor.insertSpaces":true,// 关闭自动检测文件缩进，强制使用上述2空格缩进"editor.detectIndentation":false,// ========== 换行符设置 ==========// 设置文件换行符为\n（LF，Unix风格），适配跨平台协作"files.eol":"\n",// ========== 插件与主题设置 ==========// 指定Claude Code插件的显示位置为侧边面板，不占用编辑区，方便查资料、问问题"claudeCode.preferredLocation":"panel",// 设置VS Code图标主题为vscode-icons，文件图标清晰易识别，提升视觉体验"workbench.iconTheme":"vscode-icons",// ========== 编辑器功能优化 ==========// 关闭粘性滚动，提升编辑视野整洁度"editor.stickyScroll.enabled":false,// 启动时不恢复上次打开的窗口，保持启动界面干净"window.restoreWindows":"none"}配置分类总结
| 类别 | 配置项 | 作用 |
|---|---|---|
| 编码规范 | files.encoding、files.autoGuessEncoding | 强制UTF-8，杜绝GBK乱码 |
| 缩进规范 | editor.tabSize、editor.insertSpaces等 | 统一2空格缩进，避免格式混乱 |
| 换行规范 | files.eol | Unix风格LF换行符，解决跨平台冲突 |
| 插件配置 | claudeCode.preferredLocation | Claude Code插件显示在侧边面板，提升效率 |
| 外观美化 | workbench.iconTheme | 使用vscode-icons图标主题，视觉更清晰 |
| 行为优化 | editor.stickyScroll、window.restoreWindows | 关闭粘性滚动，不恢复窗口，保持整洁 |
适用场景：现代化前端开发、需要使用辅助插件、注重编辑器视觉体验的团队。
3. 补充配置：.editorconfig（跨编辑器统一规范）
配合settings.json使用，可实现跨编辑器（VS Code、WebStorm等）格式统一，即使团队成员使用不同编辑器，也能强制遵循编码、缩进、换行规范，进一步提升协作效率。
root = true [*] charset = utf-8 indent_style = space indent_size = 2 end_of_line = lf trim_trailing_whitespace = true insert_final_newline = true
