必须选system installer才能启用code命令、右键菜单及flutter等工具链集成；安装时须勾选“添加到path”、路径禁用中文与空格、首次启动后需装中文包并验证code --version。
最新版 VS Code（2025/2026 年发布的 1.97.2 及后续版本）安装关键不在“点下一步”，而在选对安装类型和权限配置——装错类型，code 命令用不了、右键菜单不出现、“用 Code 打开”失效，后续所有插件、终端集成、Flutter/React 等开发流程都会卡住。
选 System Installer 还是 User Installer？
这是最常被跳过的决定性步骤。不是“哪个方便选哪个”，而是取决于你是否需要全局能力：
- 如果你要从命令行直接运行
code .、在任意文件夹右键调出“Open with Code”、或给 Flutter/Dart/Node 工具链提供统一编辑器入口 → 必须选 System Installer（需管理员权限） - 如果你只是个人单机使用、没有管理员权限、或明确不想影响其他账号 → 选 User Installer，但接受
code命令不可用、右键菜单大概率注册失败 - 注意：
PATH添加选项只在 System Installer 安装过程中出现，勾选它才让code命令生效；User Installer 即使手动加 PATH，也常因权限问题失效
安装路径和快捷方式别默认
C 盘不是必须的，但路径里不能含中文、空格或特殊符号——否则部分插件（如 Claude Code、SonarLint）启动时会因路径解析失败静默退出：
- 推荐路径：
D:\DevTools\VSCode2025（不含空格、纯英文、非系统盘） - 务必勾选
创建桌面快捷方式：User Installer 默认不创建，System Installer 虽自动勾选，但建议手动确认 - 不要勾选“添加到开始菜单文件夹”以外的冗余项（如 Quick Launch），无实际用途且可能干扰启动
首次启动后必做的三件事
装完不等于能用。很多用户卡在中文界面、插件不生效、AI 插件登录失败，根源都在这三步没做：
- 立刻装中文包：按
Ctrl + Shift + X打开扩展面板，搜Chinese (Simplified) Language Pack for Visual Studio Code，装完右下角点Change Language and Restart—— 不重启，语言不会切换 - 验证
code命令：打开终端（CMD/PowerShell/Terminal），输入code --version。返回版本号（如1.97.2）才算成功；若报“不是内部或外部命令”，说明安装类型或 PATH 没配对 - 插件登录别跳过授权页：比如装
Claude Code后，必须点击侧边栏图标 →Sign in with Anthropic→ 在浏览器完成授权 → 切回 VS Code 等自动同步。直接关掉弹窗会导致插件始终显示“Not signed in”
真正麻烦的从来不是下载和点击安装，而是安装类型与权限、PATH 注册、首次语言切换这三处细节没对齐。一旦错一个，后续调试插件、配置 code-server、跑 Flutter devtools 都会反复掉坑里。
