Visual Studio Code（通常简称 VS Code）是微软推出的免费、开源、跨平台代码编辑器：体积比传统大型 IDE 小得多，却内置了智能补全、语法高亮、集成终端、Git 版本控制与调试器，再靠扩展市场把 Python、C/C++、前端、远程开发等能力补齐。本文以 VS Code 1.146.0 稳定版（2026-11-11 发布）的 Windows x64 用户安装包 VSCodeUserSetup-x64-1.146.0.exe 为例，整理官方下载页与直链、GitHub 官方仓库、百度网盘备用链接、安装配置、逐项使用方法与常见问题排查。
先说清渠道：官网是 code.visualstudio.com，安装包由微软官方更新服务器 update.code.visualstudio.com 分发；GitHub 上的 microsoft/vscode 是官方源码仓库，1.146.0 的 Release 只附源码归档，不提供 Windows 安装版 exe。文末把官方入口、直链和网盘备用链接统一列出。
一、VS Code 是什么
VS Code 是一款面向「写代码」的轻量编辑器，不是 Visual Studio 那个重量级 IDE。默认界面是英文，装一个官方简体中文语言包即可全中文；源码以 MIT 许可开源在 GitHub，官方发行的二进制遵循微软软件许可，个人和商业使用都免费。Windows、macOS、Linux 三平台同一套操作逻辑，配置还能通过「设置同步」在多台电脑间同步。
它最常被提起的三点：
- 开箱即用又不过度臃肿：官方要求页写着下载包小于 200 MB、磁盘占用小于 500 MB，推荐 1.6 GHz 以上处理器与 1 GB 内存；本版 x64 用户安装版实测约 273 MB。
- 扩展生态：编辑器本体只提供基础能力，语言支持、格式化、主题、远程连接、AI 辅助都通过 Visual Studio Marketplace 的扩展按需安装，装多少由自己决定。
- 写代码的全流程都在一个窗口：资源管理器、全局搜索、源代码管理、运行与调试、扩展五个视图，加底部集成终端，改代码、跑命令、提交 Git、打断点调试不用切软件。
顺带说明文件名：VSCodeUserSetup-x64-1.146.0.exe 里的 UserSetup 指用户安装版，x64 指 64 位 Windows，1.146.0 是版本号。它和「系统安装版（System setup）」是同一套程序，区别只在安装位置和权限。
二、核心功能特性
| 特性 | 说明 |
|---|---|
| 智能编辑 | IntelliSense 代码补全、语法高亮、括号匹配、转到定义 / 查找引用、重命名符号、多光标、代码片段、格式化、文件对比 |
| 集成终端 | 窗口内直接开 PowerShell / CMD / bash / WSL，按 Ctrl + 反引号呼出，可多终端分栏，命令输出与编辑器同屏 |
| Git 版本控制 | 内置源代码管理视图，查看改动、暂存、提交、拉取推送、解决冲突、查看差异；需要电脑另外安装 Git 程序 |
| 调试与任务 | 断点、单步、变量监视、调用堆栈、调试控制台；通过 launch.json 配置调试、tasks.json 配置构建任务，F5 启动 |
| 扩展市场 | Ctrl+Shift+X 打开扩展视图，可搜索、安装、禁用、卸载、装指定版本或离线 VSIX；语言包、主题、格式化器、语言服务都在这里 |
| 远程开发 | 通过 Remote – SSH、WSL、Dev Containers 等扩展，把界面留在本地、代码和运行时放在远程服务器、WSL 或容器里 |
| 工作区与设置 | 以文件夹为单位打开项目，支持多根工作区、工作区级设置、settings.json 直接编辑；设置同步可跨设备同步配置、扩展、快捷键与片段 |
| 命令面板 | Ctrl+Shift+P 几乎能执行所有命令；Ctrl+P 按文件名快速跳转，是熟练之后效率最高的入口 |
| AI 辅助 | 内置 GitHub Copilot / Agents 相关能力，1.146 起进一步强化会话管理与模型对比；AI 功能需单独登录账号，部分能力需订阅 |
| 界面语言 | 默认英文，装官方 Chinese (Simplified) Language Pack 后切换为简体中文（zh-cn），也支持繁体中文等十余种语言 |
三、版本信息与系统要求
| 项目 | 说明 |
|---|---|
| 当前版本 | 1.146.0，官网标注 2026-11-11 发布（Stable 稳定版）；GitHub 官方 Release 同日打标签 |
| 1.146 主要更新 | Agent 会话收件箱模式（实验）、独立聊天窗口（预览）、模型对比增强（预览，可让 Agent 自行跑对比）、Agents 窗口内直接安装与管理扩展（实验）、Skills over MCP（预览）、更细粒度的权限提示与沙箱密钥遮蔽 |
| 需要注意的变化 | Local agent harness 已弃用：功能冻结，计划 2027 年 2 月移除，官方建议改用 Copilot harness；企业策略 vscode.temporaryDefaultToLocalHarness 届时一并移除。普通用户若一直用默认设置，通常无需操作 |
| Windows 要求 | 官方下载页写明 Windows 10 / 11 64 位；要求页按「受支持的 Windows 客户端 64 位版本」表述。推荐 1.6 GHz 以上 CPU、1 GB 内存，磁盘占用小于 500 MB |
| 其它平台 | macOS（Universal / Apple silicon / Intel，需 macOS 12.0 或更新且仍在安全更新期内）、Linux（Ubuntu 20.04 / Debian 10 / RHEL 8 / Fedora 36 等，另有 .deb / .rpm / .tar.gz / Snap） |
| 明确不支持 | Windows Server；App-V、MSIX 等应用虚拟化；FSLogix 管理的用户；多用户同时使用的共享虚拟桌面 / VDI 池；把完整 VS Code 跑在 Windows / Linux 容器里 |
| 安装包 | VSCodeUserSetup-x64-1.146.0.exe，官方直链返回 286,108,864 字节（约 273 MB），是 Windows x64 用户安装版 |
| 授权 | 源码以 MIT 许可开源；官方发行版遵循微软软件许可条款，个人与商业使用免费。扩展各有自己的授权，Copilot 等 AI 服务需账号与订阅 |
| 更新节奏 | 官方稳定版按月发布大版本、期间有补丁版本，内置自动更新；Insiders 版每日更新尝鲜 |
别被名字绕晕：VS Code 是编辑器，Visual Studio 是完整 IDE，两者独立下载、互不依赖。另外官方明确不支持在 Windows Server 与共享虚拟桌面上运行，企业批量部署前先看要求页。
四、下载与安装（以 VSCodeUserSetup-x64-1.146.0 为例）
1. 该选哪个包
| 类型 | 适用与区别 |
|---|---|
User Installer（用户安装版） VSCodeUserSetup-x64-1.146.0.exe |
官方推荐大多数人使用：不需要管理员权限，装到 %LOCALAPPDATA%\Programs\Microsoft VS Code，后台更新最顺畅。注意以管理员身份运行时更新会被禁用 |
| System Installer（系统安装版） | 为机器上所有用户安装，需要管理员权限，装到 Program Files，软件内更新同样需要提权 |
| .zip 免安装版 | 解压到任意目录直接运行 Code.exe；适合 U 盘、无管理员权限、或要做便携模式的场景，代价是不会自动更新，每次升级要手动换包 |
| ARM64 版 | 骁龙等 ARM64 架构 Windows 设备，另有 User / System / zip 三种 |
| CLI 版 / Insiders 版 | CLI 只含命令行工具；Insiders 是每日构建的尝鲜版，不建议当主力环境 |
2. 安装步骤
- 从文末官网或官方直链下载，核对文件名是
VSCodeUserSetup-x64-1.146.0.exe；第三方站点所谓「绿色增强版 / 破解版」不要取用。 - 双击运行，同意协议 → 选安装位置（用户版默认在用户目录，别改到需要管理员权限的路径）→ 一路下一步。
- 「选择附加任务」页按需勾选：添加到 PATH（建议勾，之后终端可用
code命令）、通过 Code 打开 的文件 / 目录右键菜单、以及是否添加 Copilot CLI 命令（不需要可跳过，不影响 VS Code 本体）。 - 装完重启一下已打开的终端窗口，运行
code --version能显示版本号即安装成功；在项目目录执行code .可直接用 VS Code 打开当前文件夹。
3. 无人值守安装与便携模式
VSCodeUserSetup-x64-1.146.0.exe /VERYSILENT /NORESTART /MERGETASKS=!runcode /copilotcli=none code --version code . code --install-extension MS-CEINTL.vscode-language-pack-zh-hans code --list-extensions
安装包基于 Inno Setup，支持标准的 /VERYSILENT、/NORESTART；官方特别说明 /mergetasks=!runcode 可阻止装完自动启动，/copilotcli=none 表示不额外添加 Copilot CLI 命令。若要用便携模式，必须下载 .zip 版，解压后在程序目录里建一个 data 文件夹，之后设置、扩展、会话状态都会保存在里面；注意便携模式不支持 User / System 安装版，也不支持自动更新，升级时把 data 目录搬到新版解压目录即可。
五、使用方法（逐项实操）
1. 界面与第一步：认识五个视图
左侧「活动栏」从上到下是资源管理器、搜索、源代码管理、运行和调试、扩展；中间是编辑区（可多标签、分屏对照）；底部状态栏显示行列号、缩进、编码、换行符与 Git 分支，点这些文字就能快速改设置。用 文件 → 打开文件夹 把整个项目目录加载进来，才算真正进入「工作区」模式。
2. 切换简体中文界面
- 按 Ctrl+Shift+X 打开扩展，搜索
Chinese (Simplified) Language Pack（微软官方简体中文语言包），点安装。 - 按 Ctrl+Shift+P 打开命令面板，输入
Configure Display Language，选择zh-cn（简体中文），按提示重启 VS Code。 - 也可以直接搜「display」找到该命令；该设置写入用户目录的
argv.json。临时指定语言可用命令行code . --locale=zh-cn。
注意：语言包只翻译 VS Code 原生界面，第三方扩展自带的菜单与提示由扩展作者决定是否汉化，保持英文属正常现象。系统语言是中文时，新版通常会自动提示安装对应语言包。
3. 安装与管理扩展
Ctrl+Shift+X 打开扩展视图，搜索名称 → 安装 → 按需重启；已安装列表里可禁用、卸载、切换版本或安装预发布版，也能从 VSIX 文件离线安装。扩展不是越多越好，装太多会拖慢启动和占用内存，建议按项目需要装。
| 用途 | 常见扩展 |
|---|---|
| 界面中文 | Chinese (Simplified) Language Pack for Visual Studio Code（官方） |
| 语言支持 | Python、C/C++、Java Extension Pack、Go、ESLint、Prettier |
| 效率增强 | Path Intellisense（路径补全）、Auto Rename Tag（成对标签重命名）、GitLens（Git 历史）、Code Runner（快速运行片段） |
| 外观主题 | One Dark Pro、Material Icon Theme、vscode-icons |
| 远程开发 | Remote – SSH、WSL、Dev Containers（微软官方 Remote 系列） |
4. 常用快捷键
| 快捷键 | 作用 | 快捷键 | 作用 |
|---|---|---|---|
| Ctrl+Shift+P | 命令面板（万能入口） | Ctrl+P | 按文件名快速打开 |
| Ctrl+, | 打开设置 | Ctrl+B | 显示 / 隐藏侧边栏 |
| Ctrl+` | 集成终端 | Ctrl+Shift+G | 源代码管理（Git） |
| Ctrl+Shift+F | 全项目搜索 | Ctrl+Shift+X | 扩展视图 |
| F5 | 启动调试 | Shift+Alt+F | 格式化文档 |
| Ctrl+/ | 注释 / 取消注释 | Ctrl+D | 选中下一个相同词（多光标） |
记不住也没关系：命令面板里输入中文或英文关键词都能搜到对应命令，右侧还显示快捷键。所有键位都能在 文件 → 首选项 → 键盘快捷方式 里改。
5. 终端、调试与 Git
- 终端：Ctrl+` 打开，右上角下拉可切换 PowerShell / CMD / WSL / bash，也能拆分成多个终端。跑构建、装依赖、启动本地服务都不用离开编辑器。
- 调试：在代码行号左侧点一下打断点，按 F5；首次使用会引导创建
.vscode/launch.json，选对应语言后按需改参数、程序入口与环境变量。调试时可看变量、监视表达式、调用堆栈与调试控制台。 - 任务：
终端 → 配置任务生成.vscode/tasks.json，把编译、打包、测试命令固化下来，用「运行任务」一键执行。 - Git：先在系统里装好 Git，再在源代码管理视图查看改动、暂存、填写提交信息、提交与同步；点文件可看差异，冲突时可直接在编辑器里选保留哪一侧。
6. 远程开发、设置同步与 AI 功能
- 远程开发：装 Remote – SSH 后，点左下角绿色远程图标连接服务器，代码与运行环境都在远端，本地只负责界面；WSL 扩展可直接在 Windows 的 Linux 子系统里开发；Dev Containers 则把环境放进容器。官方要求页也说明容器里跑的是 VS Code Server，客户端留在桌面。
- 设置同步：用 GitHub 或 Microsoft 账号登录「设置同步」，把设置、快捷键、扩展、代码片段、UI 状态同步到其它电脑，换机不用重配。
- AI 与 Agents：1.146 起可在 Agents 窗口开启收件箱模式（设置
sessions.list.inboxEnabled）、把聊天拆成独立窗口（sessions.chatWindows.enabled）、用「Compare Models」对比多个模型结果，还能在 Agents 窗口内直接搜索安装扩展。这些都是实验 / 预览功能，开关默认关闭，按需开启即可；Copilot 相关能力需登录账号，部分需订阅。
六、常见问题与排查
| 现象 | 排查方向 |
|---|---|
终端里 code 提示不是内部或外部命令 |
关掉重开终端（PATH 只对新窗口生效）；重新运行安装包确认勾选了「添加到 PATH」；检查 PATH 里有用户版的 %LOCALAPPDATA%\Programs\Microsoft VS Code\bin（系统版是 C:\Program Files\Microsoft VS Code\bin） |
| 装了中文语言包界面还是英文 | 按 Ctrl+Shift+P 执行 Configure Display Language 选 zh-cn 并重启；若提示 argv.json 保存失败，先用「Preferences: Configure Runtime Arguments」检查并保存该文件 |
| 扩展下载慢 / 安装失败 | 检查网络与代理设置，或从 Marketplace 下载 VSIX 后用「从 VSIX 安装」离线装；企业环境需确认策略是否允许该扩展 |
| 源代码管理视图提示未找到 Git | VS Code 只是调用系统 Git，需另外安装 Git for Windows 并重启 VS Code；再检查 git.path 设置 |
| 按 F5 没反应或提示无调试配置 | 先在「运行和调试」里创建 launch.json 并选对应语言；同时确认本机已装该语言的运行时与调试扩展 |
| 打开老项目中文乱码 | 点状态栏右下角编码 → 「通过编码重新打开」选 GBK / GB18030；之后用「通过编码保存」转成 UTF-8，或在 settings.json 设 files.encoding 与 files.autoGuessEncoding |
| User Setup 版不自动更新 | 官方说明：以管理员身份运行用户安装版时更新会被禁用；改为普通权限启动，或手动下载新安装包覆盖 |
| 安装程序报错装不上 | 官方建议改用 .zip 版，解压到 AppData\Local\Programs 后直接运行；同时排查杀毒软件拦截与磁盘权限 |
| 插件装多了启动变卡 | 在扩展视图按启用状态排查，禁用或卸载不常用扩展；也可用「扩展二分查找」命令快速定位问题扩展 |
| Windows Server / 共享虚拟桌面能不能装 | 官方要求页明确列为不支持：Windows Server、App-V / MSIX 虚拟化、FSLogix、多用户共享 VDI 等场景都不在支持范围 |
打开 \\server\share 网络路径被拦 |
1.78.1 起 UNC 路径需用户确认或加入 security.allowedUNCHosts；也可以把网络共享映射为盘符再打开 |
| 以管理员身份从终端启动失败（AppLocker 环境） | 官方说明进程沙箱与 AppLocker 冲突，需在命令面板执行「Preferences: Configure Runtime Arguments」，在 argv.json 加 "disable-chromium-sandbox": true 后重启 |
| zip 绿色版每次升级都要重配 | 在程序目录建 data 文件夹启用便携模式，升级时把 data 搬到新版解压目录即可保留设置与扩展 |
| 端口被占 / 远程连不上 | 远程 SSH 需目标机可登录且网络可达；本地服务端口冲突可在终端里换端口，或用「端口转发」视图查看映射 |
七、相关工具
写代码的配套工具这里也有中文教程：改单个配置或日志文本可用 Notepad++ 中文教程；拿到 .zip 绿色版用 7-Zip 中文教程 解压；本机文件太多找不过来用 Everything 秒级文件搜索；远程开发要把代码传到服务器，图形界面看 WinSCP 使用教程 与 PuTTY 连接教程。
八、VS Code 1.146.0 下载地址
- 官方网站（本文指定的官方入口）：https://code.visualstudio.com/ ｜ 官方下载页：https://code.visualstudio.com/download（含 User / System / zip / CLI / ARM64 与各平台版本）
- VSCodeUserSetup-x64-1.146.0.exe 官方直链：https://update.code.visualstudio.com/1.146.0/win32-x64-user/stable（Windows x64 用户安装版，约 273 MB；浏览器会跳到微软下载服务器并给出
VSCodeUserSetup-x64-1.146.0.exe） - ARM64 用户安装版官方直链：https://update.code.visualstudio.com/1.146.0/win32-arm64-user/stable
- 1.146 版本更新说明：code.visualstudio.com/updates/v1_146 ｜ 系统要求：官方 Requirements ｜ 扩展市场：Visual Studio Marketplace
- 官方文档：Windows 安装与常见问题、界面语言设置、便携模式 ｜ 官方简体中文语言包：Chinese (Simplified) Language Pack
- 官方 GitHub 仓库：https://github.com/microsoft/vscode（源码 MIT 开源） ｜ 1.146.0 Release 页面（仅附源码 zip / tar.gz 归档，不提供 Windows 安装版 exe，安装包请走上面的官网直链）
- 百度网盘备用下载：https://pan.baidu.com/s/1_Y47UYdLftsG7tbYgOkHWA 提取码：
dr99
官方直链带版本号，若将来版本升级后链接调整，请回官网下载页点「Download for Windows」取最新版。VS Code 本体完全免费，凡是要收费、要求装「下载器」或宣称「已破解 Copilot」的页面都不是官方渠道。下载后可核对文件名与
code --version输出是否为1.146.0。
小结
VS Code 1.146.0 的取舍很清楚：一个两百多兆的编辑器，把写代码最常用的补全、终端、Git、调试和扩展市场做齐，剩下交给扩展按需补。日常写脚本、做前端、改配置用用户安装版最省心——不用管理员权限、自动更新顺；要给全机所有账户装就换系统安装版；U 盘随身或受限环境用 zip 版加 data 目录。装完先做三件事：勾好 PATH、装官方简体中文语言包、按项目装必要扩展，再用 Ctrl+Shift+P 和 Ctrl+` 把日常流程串起来。它不是完整 IDE，也不支持 Windows Server 这类场景，但在「免费、轻、跨平台、什么语言都能写」这个范围内，依然是 Windows 上最稳妥的默认选择。
