vscode安装需按系统选对版本并配置 PATH：windows装官网 64 位。exe 并勾选添加 PATH 和文件关联；macos用通用版拖入 applications 并安装 shell 命令；linux 依发行版选 deb/rpm/AUR，避免 snap。
VSCode 下载安装其实很简单，关键是要选对版本、避开常见坑，比如误装系统自带的旧版、权限问题或中文乱码。下面按平台分步说明，覆盖下载、安装、基础配置三块，一步到位。
Windows 用户：直接装官方 64 位版（推荐）
绝大多数 win10/win11 电脑 都是 64 位系统，直接去官网下载 .exe 安装包即可，无需手动选 架构。安装时勾选“Add to PATH”和“register Code as an editor for supported file types”，这样就能在命令行直接输入 code 打开文件夹，右键菜单也能快速用 VSCode 打开。
- 不建议用 microsoft Store 版——更新慢、插件兼容性差、无法调用本地终端
- 如果提示“无法验证发布者”，点“更多信息”→“仍要运行”，这是正常签名验证流程
- 装完首次启动会自动检测并提示安装中文语言包（可选），点“是”就行
macOS 用户：Intel 和 Apple Silicon 都用统一版
VSCode 官方已提供通用二进制（Universal App），一个 .zip 包同时支持 Intel 和 M1/M2/M3 芯片。下载后解压，把 visual studio Code.app 拖进 Applications 文件夹即可。双击启动后，系统可能提示“无法验证开发者”，这时去「系统设置 → 隐私与安全性」拉到最底，点“仍要打开”。
- 终端命令支持：首次运行 VSCode 后，在命令面板（Cmd+Shift+P）输入“Shell Command: Install ‘code’ command in PATH”，回车执行，之后就能在终端用 code . 打开当前项目
- 如需全局使用，确保 /usr/local/bin 在你的 shell PATH 中（zsh 默认已包含）
Linux 用户：根据发行版选安装方式
ubuntu/debian 系统推荐用 .deb 包；Fedora/RHEL 用 .rpm；Arch 用户可直接从 AUR 安装（visualstudiocode-bin）。不建议用 snap 版——沙盒限制多，git、终端、文件系统访问常出问题。
- Debian/Ubuntu 示例：wget -O vscode.deb https://update.code.visualstudio.com/latest/linux-deb-x64/stable && sudo apt install ./vscode.deb
- 安装后终端输入 code 若提示“command not found”，运行 sudo ln -s /usr/share/code/bin/code /usr/local/bin/code 建软链接
- 首次启动可能提示缺失依赖（如 libxkbfile1、libsecret-1-0），按提示 apt install 补齐即可
装完第一件事：检查基础体验是否正常
打开任意文件夹，试试快捷键是否响应：Ctrl/Cmd+P（快速打开）、Ctrl/Cmd+,（设置）、Ctrl/Cmd+Shift+P（命令面板）。如果中文显示方块、终端乱码，进「设置 → Settings → Terminal › Integrated › Env: Linux/macOS/Windows」，确认 locale 设为 zh-CN.UTF-8 或对应系统语言 编码。
- 插件不用急着装，先确认编辑器本身流畅——滚动、搜索、保存无卡顿
- 如果窗口黑屏或白屏，尝试关闭硬件加速：code –disable-gpu 启动一次，再进设置关掉“Use Hardware Acceleration”
- 同步设置（登录 github 账号）建议等熟悉界面后再开启，避免覆盖本地偏好
基本上就这些。VSCode 本身轻量，安装不复杂但容易忽略细节。只要版本选对、PATH 配好、首启验证通过，后面就是安心写代码的事了。
