这是一套面向 AI 辅助开发和代码审查的轻量 VS Code 配置。
我的主要工作方式是让 Codex 完成大部分编码工作，然后使用 VS Code 阅读 diff、审查实现并进行少量修改。因此，这套配置保留了常用语言的导航、诊断和格式化能力，同时减少自动修改、后台扫描和不必要的界面干扰。
- Java、Maven、Spring Boot
- Vue、React
- Node.js、JavaScript、TypeScript
- Go
- Python、uv、Ruff
- Rust、Cargo
- Dart、Flutter
React、Node.js、JavaScript 和 TypeScript 主要使用 VS Code 内置语言服务，不额外安装重复的语言扩展。
Python 使用官方 Python 扩展及其附带的 Pylance、Python Debugger 和 Python Environments，Ruff 负责代码诊断与格式化。Python Environments 会自动发现项目中的 .venv，全局配置不预设解释器路径，并开启基础类型检查和自动导入补全。
Rust 使用 rust-analyzer 提供导航、诊断和格式化，并通过 CodeLLDB 支持调试。Flutter 扩展负责 Dart 和 Flutter 的导航、调试与 Hot Reload；其依赖的 Dart 扩展会自动安装。配置不预设 Rust 或 Flutter SDK 路径。
| 项目 | 配置 |
|---|---|
| 颜色主题 | Vitesse Dark Soft |
| 编辑器字体 | JetBrains Mono |
| 文件图标 | Catppuccin Mocha |
| 产品图标 | Carbon |
| 快捷键 | JetBrains |
| 界面语言 | 简体中文 |
配置开启了 minimap、inlay hints 和 sticky scroll。自动保存与保存时格式化默认关闭，避免代码审查过程中产生意外修改或无关 diff。
配置同时集成了 Goto Alias、File Nesting Updater、Smart Clicks 和 Where Am I。它们分别用于跟踪自动导入声明的真实定义、维护文件嵌套规则、增强双击选区，以及在状态栏识别和切换当前项目。Goto Alias 遇到多个定义时会直接跳转；File Nesting Updater 保留默认的更新提示，确认后才应用上游规则。
git clone https://github.com/Sanjeever/vscode-settings.git
cd vscode-settings使用 PowerShell 7 执行：
pwsh -File .\scripts\install.ps1脚本会：
- 将现有用户设置备份为
settings.json.backup-时间戳 - 将仓库配置复制到
%APPDATA%\Code\User\settings.json - 读取
.vscode/extensions.json并安装推荐扩展
脚本优先使用 PATH 中的 code 命令；如果找不到，则尝试 VS Code 默认的用户安装路径。
先在 VS Code 命令面板中执行：
Shell Command: Install 'code' command in PATH
然后使用 Bash 执行：
bash ./scripts/install.sh脚本会：
- 将现有用户设置备份为
settings.json.backup-时间戳 - 将仓库配置复制到
~/Library/Application Support/Code/User/settings.json - 读取
.vscode/extensions.json并安装推荐扩展
两个脚本都会完整替换原有的 settings.json，不会修改快捷键、argv.json、SSH 配置或其他用户数据。
.vscode/extensions.json 只列出主动选择的扩展。Remote SSH 需要的 Remote - SSH: Editing Configuration Files 和 Remote Explorer 会作为依赖自动安装。
Python 扩展附带 Pylance、Python Debugger 和 Python Environments，因此不在推荐列表中重复列出这些依赖。配置显式启用 Python Environments，并在 uv 可用时优先使用 uv 管理虚拟环境和安装包。
Flutter 扩展会自动安装 Dart 扩展，因此推荐列表中不重复列出 Dart。CodeLLDB 用于 Rust 调试；只需要语言导航和诊断时，rust-analyzer 本身即可工作。
如果不想运行脚本，可以使用 VS Code 打开仓库：
code .打开扩展视图后执行 Extensions: Show Recommended Extensions，安装工作区推荐的扩展。
若要将仓库设置作为全局用户配置使用，请手动复制 .vscode/settings.json。
Windows：
%APPDATA%\Code\User\settings.json
macOS：
~/Library/Application Support/Code/User/settings.json
安装简体中文语言包后，在命令面板中执行：
Configure Display Language
选择 zh-cn，然后重新启动 VS Code。显示语言属于机器级运行参数，因此没有将 argv.json 放入本仓库。
配置中不包含 JDK、Maven、Go、Rust、Flutter、终端或字体的本机绝对路径。
- Windows 和 macOS 应分别安装 JetBrains Mono。
- Java 项目通过各平台的
JAVA_HOME或项目配置选择 JDK。 - Maven 项目优先使用仓库内的 Maven Wrapper。
- Go 工具链通过各平台的
PATH管理。 - Python 和 uv 通过各平台的
PATH管理；Python 项目可将环境放在.venv，由 Python Environments 自动发现。 - Ruff 的项目规则应放在项目自己的
pyproject.toml或ruff.toml中。 - Rust 工具链通过 rustup 和各平台的
PATH管理，项目规则放在自己的Cargo.toml或 Clippy 配置中。 - Flutter 和 Dart SDK 通过项目目录、
FLUTTER_ROOT或各平台的PATH自动发现，不在全局配置中固定路径。 - VS Code Settings Sync 可继续用于个人设备之间的日常同步，本仓库只发布经过检查的公开配置快照。
本仓库刻意不包含：
- API Key、Token、密码和其他凭据
- SSH 主机、用户名和私钥配置
- 本机代理地址
- 本地项目路径
- JDK、Maven 等工具的绝对路径
argv.json、globalStorage、workspaceStorage和扩展缓存
不要直接把整个 VS Code 用户目录复制到公开仓库。更新本仓库前，应检查配置 diff，确认没有引入机器信息或凭据。