一.前期准备：确认系统与下载官方安装包

1.核对操作系统版本

1.1.Windows：右键【此电脑】→【属性】，查看【系统类型】(64位/32位，目前绝大多数为64位)

1.2.macOS：点击左上角苹果图标→【关于本机】，查看芯片类型(Intel/Apple Silicon)和系统版本(建议10.15+)

1.3.Linux：终端输入uname -a查看发行版(如Ubuntu、CentOS)和架构(x86_64/arm64)

2.官方下载(安全无捆绑)

2.1.VS Code官网会自动识别系统，优先下载稳定版（Stable），拒绝第三方修改包

2.2.官方下载地址：https://code.visualstudio.com/Download

2.3.版本选择

2.3.1.Windows：点击【Windows】(64位选VSCodeUserSetup-x64-*.exe，32位选VSCodeUserSetup-ia32-*.exe)

2.3.2.macOS：点击【macOS】(Universal版本兼容Intel/M系列芯片)

2.3.3.Linux：点击【Linux】，根据发行版选择deb(Ubuntu/Debian)、rpm(Fedora/CentOS)或tar.gz(通用版)

二.分系统详细安装步骤(核心环节)

1.(一)Windows系统安装(保姆级，关键选项必勾)

1.1.运行安装程序找到下载的.exe文件(默认在【下载】文件夹)，右键选择【以管理员身份运行】(避免权限不足)

1.2.接受许可协议勾选【我接受协议】，点击【下一步】

1.3.选择安装路径建议自定义路径(避免C盘占用过高)，示例

1.3.1.非C盘：D:\Program Files\Microsoft VS Code
1.3.2.简洁路径：C:\VS Code（C 盘充足时）点击【下一步】
1.3.3.附加任务(✅必勾选项)以下选项直接影响使用体验，强烈推荐全部勾选

✅ 添加到PATH(重启后生效)：终端可直接用code .打开文件夹
✅ 创建桌面快捷方式：快速启动
✅ 添加到【通过Code打开】上下文菜单：右键文件/文件夹可直接用VS Code打开
✅ 添加到开始菜单：方便查找。点击【下一步】→【安装】，等待1-3分钟完成
完成安装勾选【运行Visual Studio Code】，点击【完成】自动启动

2.(二)macOS系统安装(两种方法)

2.1.方法1：官方安装包(新手首选)

2.1.1.打开下载的.dmg文件，将【Visual Studio Code】图标拖拽到【应用程序】文件夹

2.1.2.首次启动若提示【无法验证开发者】：
2.1.2.1.右键VS Code图标→【打开】→再次点击【打开】(绕过系统验证)
2.1.2.2.(可选)添加到 Dock：右键 Dock 中的 VS Code→【选项】→【保留在 Dock】

2.2.方法2：Homebrew安装(终端用户推荐)

2.2.1.bash运行

#1.安装Homebrew(已安装则跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
#2.安装VS Code
brew install --cask visual-studio-code
 
#3.启动VS Code
code

3.(三)Linux系统安装(分发行版)

3.1.Ubuntu/Debian系列(deb包)

3.1.1.bash运行

#更新软件源
sudo apt update && sudo apt upgrade -y
 
#进入下载目录（假设安装包在「下载」文件夹）
cd ~/下载
 
#安装deb包（替换为实际文件名）
sudo dpkg -i code_*.deb
 
#修复依赖（若安装失败）
sudo apt --fix-broken install -y
 
#启动VS Code
code

3.2.Fedora/CentOS系列(rpm包)

3.2.1.bash运行

#进入下载目录
cd ~/下载
 
#安装rpm包
sudo dnf install code_*.rpm -y
 
#启动VS Code
code

3.3.通用 tar.gz包(无root权限)

3.3.1.bash运行

#解压安装包
tar -xzf code-*-linux-x64.tar.gz -C ~/应用
 
#进入解压目录并启动
cd ~/应用/VSCode-linux-x64
./code

三.验证安装是否成功(必做)

1.基础启动验证

1.1.Windows：双击桌面快捷方式/开始菜单搜索【Visual Studio Code】，能打开界面即成功

1.2.macOS：从启动台/Dock打开，加载界面无报错即成功

1.3.Linux：终端输入code，能打开编辑器即成功

2.版本验证(打开VSCode后)

2.1.Windows/Linux：【文件】→【首选项】→【关于】(快捷键Ctrl+Shift+P输入【关于】)

2.2.macOS：【Visual Studio Code】→【关于】(快捷键Command+Shift+P输入【关于】)
显示版本号(如1.87.0)且提示【已是最新版本】即成功

3.终端命令验证(关键)

3.1.打开终端(Windows用cmd/PowerShell)，bash运行输入

code --version

3.1.1.输出如下格式信息，说明PATH配置成功(plaintext)

1.87.0
abc1234567890abcdefghijklmnopqrstuvwxyz
x64

四.首次启动必做配置(中文+插件+优化)

1.安装中文语言包(一键汉化)

1.1.打开左侧【扩展】面板(快捷键Ctrl+Shift+X/Command+Shift+X)

1.2.搜索【Chinese】，找到 【Chinese (Simplified) Language Pack】(微软官方)

1.3.点击【安装】→【重新启动】，VS Code自动切换为中文界面

2.必备插件推荐(按开发场景)

2.1.安装方法：扩展面板搜索插件名称→点击【安装】，部分插件需重启生效

插件名称	作用	适用场景
Python	官方插件，支持语法高亮、调试、格式化	Python 开发（必装）
Pylance	智能代码补全，提升开发效率	Python 开发（必装）
Code Runner	一键运行代码，支持多语言	快速测试代码片段
GitLens	增强 Git 功能，查看提交历史	版本控制
Material Icon Theme	美化文件图标，提升辨识度	界面优化

3.基础设置优化

3.1.打开设置界面(Ctrl+,/Command+,)，推荐配置

✅ 「文件→自动保存」：勾选，避免代码丢失
✅ 「字体大小」：调整为 14-16(适配屏幕)
✅ 「缩进：空格数」：设置为 4（(Python 开发必设)
✅ 「终端→集成：默认终端」：Windows选PowerShell，macOS/Linux选系统终端

4.Python环境配置(Python 开发必做)

4.1.新建/打开.py文件

4.2.点击右下角【选择解释器】(或Ctrl+Shift+P输入【Python：选择解释器】)

4.3.选择已安装的Python路径(如D:\Python314\python.exe)

4.4.测试：右键代码→【运行Python文件】，能正常执行即配置完成

五.常见问题排查

1.Windows安装失败

1.1.权限不足：重新以管理员身份运行安装包

1.2.路径错误：安装路径避免中文/空格/特殊字符(如D:\VSCode)

1.3.路径过长：安装时勾选【禁用路径长度限制】(Windows 10+支持)

2.macOS无法启动

2.1.安全验证：右键VS Code→【打开】→【打开】(绕过系统验证)

2.2.仍失败：【系统设置】→【安全性与隐私】→【通用】→【仍要打开】

3.终端无法识别code命令

3.1.Windows：重新安装，勾选【添加到PATH】，重启电脑

3.2.macOS：VS Code中Command+Shift+P→输入【Shell Command：安装 'code' 命令在PATH】→执行后重启终端

六.进阶优化(可选)

1.开启自动更新

1.1.Windows/Linux：【帮助】→【检查更新】

1.2.macOS：【Visual Studio Code】→【检查更新】

2.自定义快捷键

2.1.打开【键盘快捷方式】(Ctrl+K Ctrl+S/Command+K Command+S)，常用快捷键

2.1.1.快速打开文件：Ctrl+P/Command+P

2.1.2.格式化代码：Shift+Alt+F/Shift+Option+F

3.安装主题

3.1.扩展面板搜索【Theme】，推荐【One Dark Pro】【Material Theme】，提升界面美观度

七.总结

1.本文覆盖VS Code全平台安装、验证、配置全流程，核心要点

1.1.务必从官方网站下载安装包，避免捆绑软件

1.2.Windows安装时必勾【添加到PATH】，终端使用更便捷

1.3.首次启动优先安装中文语言包，降低上手难度

1.4.Python开发需配置解释器+安装【Python】【Pylance】插件