如果你刚拿到一台新电脑,或者刚转行打算写代码,第一件事多半是找一个趁手的编辑器。我看过太多人在这一步栽跟头:搜索“VSCode下载”,点进一个带着“高速下载”按钮的网站,结果装完发现多了好几个全家桶软件,真正的 VSCode 连影子都没见到。其实 Visual Studio Code(VSCode)是微软开源、完全免费的编辑器,不存在什么破解版、注册码,也没有必要去第三方站点找所谓“绿色免安装版”。你真正需要的只是一个官方安装包,外加一份完整的配置路径。
我尽量从下载、安装、汉化、基础配置、插件、环境对接、日常高频操作到问题排查,按保姆级的方式完整过一遍。适合完全没碰过编辑器的人,也适合那些已经装了 VSCode 但一直用得不顺手、想重新整顿一遍配置的人。文章里所有步骤都是我平时给新同事配机器时实际会做的动作,不搞花架子。
1. 安装之前先弄明白:官方渠道、版本选择和安装包形态
1.1 为什么一定要走官网,而不是搜索引擎里的“高速下载”
VSCode 的安装包在官网和微软的 GitHub Releases 都能下载,但很多中文搜索环境里,搜索结果前几条经常是付费推广或仿冒站点。这类站点最常见的套路是:给你放一个体积很大的下载器,点进去后开始推各种浏览器助手、压缩软件、全家桶,真正的 VSCode 安装包反而被藏起来了。
所以第一步很重要:地址栏只认 code.visualstudio.com。打开之后,页面顶部会有一个很显眼的下载按钮,系统会自动识别你的操作系统。如果识别不准,页面下方也有 Windows、macOS、Linux 的分类入口。这个页面会自动跳转到当前最新稳定版的下载地址,不需要额外输入邮箱,也不需要注册账号。
如果你对官网下载速度不满意,也可以到微软的官方 GitHub Releases 页面去找对应的安装包文件。文件名里一般会标明平台和架构,比如 VSCodeSetup-x64-xxx.exe 是 Windows 64 位安装包,VSCode-darwin-universal.zip 是 macOS 通用包。这里说一句:VSCode 本身就是免费开源软件,任何让你付费、注册、输入银行卡信息才能拿到“完整版”的渠道,基本都是假的。
1.2 2026 年怎么选版本:稳定版还是 Insiders
VSCode 的更新节奏大约是每个月一个稳定版本,另外还有每天更新的 Insiders 预览版。稳定版的版本号听起来不那么“新”,但它的功能已经经过测试,插件兼容性也可靠。Insiders 适合想第一时间试新功能的人,但它不稳定,偶尔会遇到编辑器界面异常、插件加载失败甚至直接崩溃的情况。
所以我给新人的建议非常明确:日常开发、写作业、做项目,用稳定版。除非你有强烈的尝鲜需求,否则别装 Insiders,更不要“稳定版和预览版混着用”,两个版本都会写各自的配置目录,混着装容易让人分不清当前到底在用哪个。
如果你已经在用 Insiders 或者某个老版本,想换回稳定版,直接用官网安装包覆盖安装即可。VSCode 的配置和已安装插件都在用户目录下,覆盖安装不会清掉这些东西,放心操作。
1.3 根据操作系统选安装包:x64、ARM64、Apple Silicon
下载前先确认自己电脑的架构。Windows 绝大多数是 x64,最近几年也有不少 ARM 架构的轻薄本;macOS 从 2020 年起逐步转向 Apple Silicon,也就是 M 系列芯片,老款 Intel Mac 也有不少还在使用。选错架构的包一般也能装上,但运行效率会打折扣,比如 Intel 版安装包在 Apple Silicon 上需要转译,内存占用和发热都会明显一些。
Linux 用户看的发行版:Ubuntu/Debian 系用 .deb,Fedora/RHEL 系用 .rpm,另外还有 tar.gz 压缩包和 Snap 包。我的习惯是优先用系统包管理器装 .deb 或 .rpm,这样以后可以直接通过系统命令更新,不用每次手动下载。tar.gz 解压就能用,但更新要靠自己。Snap 安装最省心,但启动速度有时候会慢一点,这要看个人取舍。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 分系统安装与首次启动:从双击到看到欢迎页
2.1 Windows:安装选项里的三个勾,后面能省很多事
Windows 下安装包是 exe 文件,双击后一路 Next 就能装完。但在“选择其他任务”这一步,有几个选项千万注意:
- 将“通过 Code 打开”添加到 Windows 资源管理器目录上下文菜单
- 将“通过 Code 打开”添加到 Windows 资源管理器文件上下文菜单
- 将 Code 注册为受支持文件类型的编辑器
这三个选项会直接决定你以后在文件夹里右键点“使用 Code 打开”能不能生效。如果不勾选,后续就只能先打开 VSCode 再在软件里选择文件夹,日常操作会别捏很多。
另一个选项是“添加到 PATH”。勾选后,你可以在命令行里直接输入 code . 打开当前目录。这也是很多开发者最依赖的操作之一。如果你在安装时漏掉了这个选项,不用急着重装,打开 VSCode,按 Ctrl+Shift+P,输入 Shell Command: Install 'code' command in PATH,按回车即可。
安装路径方面,默认装在用户目录下就好。如果选择“系统安装模式”,会装到 Program Files,需要管理员权限,后续自动更新时可能遇到权限问题。个人开发机用用户模式就够了。
2.2 macOS:拖进 Applications 后,别忘了装命令行工具
macOS 的安装包是 zip 压缩包,解压后得到一个 Visual Studio Code.app,把它拖到“应用程序”文件夹即可。第一次打开时,macOS 可能会提示“无法打开,因为来自身份不明的开发者”。这种情况去“系统设置 -> 隐私与安全性”里,找到被拦截的提示,点“仍要打开”。
打开后建议立刻安装命令行工具:按 Cmd+Shift+P,输入 Shell Command: Install 'code' command in PATH,回车。这样你就能在 Terminal 里用 code 命令打开任意文件夹。对后端开发、写脚本的人来说,这是 macOS 下最顺手的一步。
如果你是在 Apple Silicon 上用 Intel 版安装包,系统可能提示安装 Rosetta。Rosetta 是苹果的转译层,它的作用是让 Intel 应用能在新架构上跑,但既然 VSCo
