第四：VS Code安装教程(Windows/macOS/Linux)

一.前期准备确认系统与下载官方安装包1.核对操作系统版本1.1.Windows右键【此电脑】→【属性】查看【系统类型】(64位/32位目前绝大多数为64位)1.2.macOS点击左上角苹果图标→【关于本机】查看芯片类型(Intel/AppleSilicon)和系统版本(建议10.15)1.3.Linux终端输入uname-a查看发行版(如Ubuntu、CentOS)和架构(x86_64/arm64)2.官方下载(安全无捆绑)2.1.VSCode官网会自动识别系统优先下载稳定版Stable拒绝第三方修改包2.2.官方下载地址https://code.visualstudio.com/Download2.3.版本选择2.3.1.Windows点击【Windows】(64位选VSCodeUserSetup-x64-*.exe32位选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:\ProgramFiles\MicrosoftVSCode1.3.2.简洁路径C:\VSCodeC盘充足时点击【下一步】1.3.3.附加任务(✅必勾选项)以下选项直接影响使用体验强烈推荐全部勾选✅ 添加到PATH(重启后生效)终端可直接用code.打开文件夹 ✅ 创建桌面快捷方式快速启动 ✅ 添加到【通过Code打开】上下文菜单右键文件/文件夹可直接用VSCode打开 ✅ 添加到开始菜单方便查找。点击【下一步】→【安装】等待1-3分钟完成 完成安装勾选【运行VisualStudioCode】点击【完成】自动启动2.(二)macOS系统安装(两种方法)2.1.方法1官方安装包(新手首选)2.1.1.打开下载的.dmg文件将【VisualStudioCode】图标拖拽到【应用程序】文件夹2.1.2.首次启动若提示【无法验证开发者】2.1.2.1.右键VSCode图标→【打开】→再次点击【打开】(绕过系统验证)2.1.2.2.(可选)添加到Dock右键Dock中的VSCode→【选项】→【保留在Dock】2.2.方法2Homebrew安装(终端用户推荐)2.2.1.bash运行#1.安装Homebrew(已安装则跳过)/bin/bash-c$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)#2.安装VSCodebrew install--cask visual-studio-code #3.启动VSCodecode3.(三)Linux系统安装(分发行版)3.1.Ubuntu/Debian系列(deb包)3.1.1.bash运行#更新软件源 sudo apt updatesudo apt upgrade-y #进入下载目录假设安装包在「下载」文件夹 cd~/下载 #安装deb包替换为实际文件名 sudo dpkg-i code_*.deb #修复依赖若安装失败 sudo apt--fix-broken install-y #启动VSCodecode3.2.Fedora/CentOS系列(rpm包)3.2.1.bash运行#进入下载目录 cd~/下载 #安装rpm包 sudo dnf install code_*.rpm-y #启动VSCodecode3.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双击桌面快捷方式/开始菜单搜索【VisualStudioCode】能打开界面即成功1.2.macOS从启动台/Dock打开加载界面无报错即成功1.3.Linux终端输入code能打开编辑器即成功2.版本验证(打开VSCode后)2.1.Windows/Linux【文件】→【首选项】→【关于】(快捷键CtrlShiftP输入【关于】)2.2.macOS【VisualStudioCode】→【关于】(快捷键CommandShiftP输入【关于】)显示版本号(如1.87.0)且提示【已是最新版本】即成功3.终端命令验证(关键)3.1.打开终端(Windows用cmd/PowerShell)bash运行输入code--version3.1.1.输出如下格式信息说明PATH配置成功(plaintext)1.87.0 abc1234567890abcdefghijklmnopqrstuvwxyz x64四.首次启动必做配置(中文插件优化)1.安装中文语言包(一键汉化)1.1.打开左侧【扩展】面板(快捷键CtrlShiftX/CommandShiftX)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选PowerShellmacOS/Linux选系统终端4.Python环境配置(Python 开发必做)4.1.新建/打开.py文件4.2.点击右下角【选择解释器】(或CtrlShiftP输入【Python选择解释器】)4.3.选择已安装的Python路径(如D:\Python314\python.exe)4.4.测试右键代码→【运行Python文件】能正常执行即配置完成五.常见问题排查1.Windows安装失败1.1.权限不足重新以管理员身份运行安装包1.2.路径错误安装路径避免中文/空格/特殊字符(如D:\VSCode)1.3.路径过长安装时勾选【禁用路径长度限制】(Windows10支持)2.macOS无法启动2.1.安全验证右键VS Code→【打开】→【打开】(绕过系统验证)2.2.仍失败【系统设置】→【安全性与隐私】→【通用】→【仍要打开】3.终端无法识别code命令3.1.Windows重新安装勾选【添加到PATH】重启电脑3.2.macOSVS Code中CommandShiftP→输入【Shell Command安装code命令在PATH】→执行后重启终端六.进阶优化(可选)1.开启自动更新1.1.Windows/Linux【帮助】→【检查更新】1.2.macOS【Visual Studio Code】→【检查更新】2.自定义快捷键2.1.打开【键盘快捷方式】(CtrlK CtrlS/CommandK CommandS)常用快捷键2.1.1.快速打开文件CtrlP/CommandP2.1.2.格式化代码ShiftAltF/ShiftOptionF3.安装主题3.1.扩展面板搜索【Theme】推荐【One Dark Pro】【Material Theme】提升界面美观度七.总结1.本文覆盖VS Code全平台安装、验证、配置全流程核心要点1.1.务必从官方网站下载安装包避免捆绑软件1.2.Windows安装时必勾【添加到PATH】终端使用更便捷1.3.首次启动优先安装中文语言包降低上手难度1.4.Python开发需配置解释器安装【Python】【Pylance】插件