设置优先级

• 用户 → 工作区 → 文件夹 — 后者覆盖前者
• 每个项目的 .vscode/settings.json — 覆盖用户设置
• 工作区中的 "editor.formatOnSave" 覆盖用户设置 — 容易引起混淆
• 多根工作区需使用每文件夹设置 — 或在根目录下使用 .code-workspace 文件
• 部分设置仅在用户级别生效 — 例如 "terminal.integrated.shell" 仅支持用户级配置

格式化器冲突

• 同一语言存在多个格式化器 — 需显式设置 "[language]": {"editor.defaultFormatter": "id"}
• Prettier 与 ESLint 同时执行格式化 — 可禁用其一：在 ESLint 项目中设置 "prettier.enable": false
• 保存时运行了错误的格式化器 — 必须明确指定 defaultFormatter
• .editorconfig 会覆盖部分设置 — 可能与扩展的设置发生冲突

调试器配置

• 大多数调试场景需要 launch.json — 不能仅按 F5 启动
• "cwd" 是相对于工作区根目录的路径 — 并非相对于 launch.json 所在位置
• "program" 路径错误 — 应使用 ${workspaceFolder}/path/to/file
• Node.js：通过 "skipFiles" 避免单步进入 node_modules
• 多进程调试需使用组合配置 — 在 launch.json 中定义 "compounds" 数组

扩展

• 扩展宿主崩溃 — 禁用最近安装的扩展，并逐个启用以排查问题
• 安装后出现 “Cannot find module” 错误 — 完全重启 VS Code
• 扩展设置未生效 — 检查是否被工作区设置覆盖
• 扩展之间存在冲突 — 如快捷键冲突、功能重复等

终端

• 新建终端使用了错误的 Shell — 设置 "terminal.integrated.defaultProfile.*"
• 缺少环境变量 — 终端继承自启动方式，而非 .bashrc 等 shell 配置文件
• 安装新工具后 PATH 未更新 — 需重启 VS Code（而不仅仅是重启终端）
• Shell 集成异常 — 可通过 "terminal.integrated.shellIntegration.enabled": false 禁用该功能

远程开发

• SSH：要求 ~/.ssh/config 中的 Host 名称匹配 — 可通过 "remote.SSH.configFile" 指定其他配置文件
• 容器：必须提供 .devcontainer/devcontainer.json — 不会自动识别 Dockerfile
• WSL：扩展需单独安装 — WSL 扩展保留在 WSL 环境中
• 端口转发：默认自动启用，但并非总是生效 — 请检查“端口”面板

工作区信任

• 受限模式将禁用部分功能 — 如调试、任务、某些扩展
• 首次打开时会弹出信任提示 — 点击“Trust Folder”以启用全部功能
• 多根工作区支持按文件夹设置信任状态 — 可选择性地信任部分文件夹，而不信任其余文件夹

常见修复方法

• IntelliSense 不生效 — 检查“输出”面板中的语言服务器状态
• TypeScript 中出现 “Cannot find module” — 重启 TS 服务器：Cmd+Shift+P → 输入 “TypeScript: Restart TS Server”
• Git 无法检测变更 — 检查当前是否位于子目录中；.git 必须位于工作区根目录，或已通过配置指定
• 设置无法保存 — 检查 settings.json 文件的写入权限