浙江领先的线上培训和职业文化发展平台

VSCode 完整安装、汉化及插件使用指南（Windows/macOS/Linux 通用）

2026-01-17 杨亦涛 浏览量: 13

VSCode 完整安装、汉化及插件使用指南（Windows/macOS/Linux 通用）

VSCode（Visual Studio Code）的下载安装、界面汉化、插件使用与插件汉化均有标准化流程。本指南以 Windows 平台操作为主，macOS/Linux 操作逻辑一致，关键差异已明确标注，确保新手可直接对照上手。

一、下载与安装（全平台通用，分平台说明）

1. 下载步骤（优先官网，安全无捆绑）

  1.  
  2. 访问 VSCode 官方网站（https://code.visualstudio.com/），官网会自动识别当前系统版本，推荐直接下载匹配版本（若识别错误，可手动点击页面底部“其他平台”选择对应版本）。
  3. 点击页面显著位置的 “Download for Windows/macOS/Linux” 按钮，根据系统选择对应安装包： Windows 系统：优先选择 User Setup（用户级安装，无需管理员权限，仅当前用户可用，适合个人设备）；若需全电脑所有用户共用，可选 System Setup（系统级安装，需管理员权限）。
  4. macOS 系统：下载.dmg 格式镜像文件，兼容 macOS 10.15+ 版本，老旧系统需下载对应历史版本。
  5. Linux 系统：Debian/Ubuntu 系列选择.deb 包，Fedora/CentOS 系列选择.rpm 包；Arch 系可通过 Pacman 安装（sudo pacman -S code），也可通过 Snap 包安装（命令：sudo snap install code –classic），适配更多 Linux 发行版。

2. 安装步骤（以 Windows 为例，其他平台简化说明）

Windows 平台安装

  1.  
  2. 双击下载完成的安装包，进入安装向导，勾选 “我接受许可协议” 后点击 “下一步”。
  3. 选择安装路径：建议安装在非系统盘根目录（如 D:Program FilesMicrosoft VS Code），避免中文路径和空格，设置完成后点击 “下一步”。
  4. 附加任务（推荐全部勾选，提升使用便捷性）： 创建桌面快捷方式（快速启动 VSCode，勾选后桌面生成图标）。
  5. 添加到 PATH（关键选项，勾选后终端/命令提示符可直接输入 code 命令启动 VSCode，无需切换安装目录）。
  6. 右键菜单添加 “通过 Code 打开”（支持文件/文件夹，右键点击目标内容可快速用 VSCode 打开，大幅提升效率）。
  7. 点击 “安装”，等待进度条走完（约 1-3 分钟，视设备性能而定）；安装结束后勾选 “运行 Visual Studio Code”，点击 “完成” 自动启动软件。

macOS/Linux 平台安装

  • macOS：打开下载的.dmg 镜像文件，磁盘会自动挂载，将左侧 “Code” 图标拖拽至右侧 “Applications” 文件夹（拖拽过程约 10 秒），拷贝完成后可在启动台找到 VSCode；首次打开需按住 Control 点击图标，选择 “打开” 绕过安全验证（macOS 对非 App Store 应用的默认限制）。
  • Linux（Debian/Ubuntu）：打开终端，通过 cd 命令进入安装包所在目录（如 cd ~/Downloads），执行命令 sudo dpkg -i code_*.deb（* 替换为实际安装包文件名，可输入 code 后按 Tab 键自动补全）；若提示依赖缺失，补充执行 sudo apt -f install 自动修复依赖，修复完成后重新执行安装命令即可。
  • Linux（Fedora/CentOS）：进入安装包目录，执行命令 sudo rpm -ivh code_*.rpm，依赖缺失时可通过 sudo dnf install -y code 自动补全依赖并安装。

二、界面汉化（官方语言包，稳定无风险）

VSCode 默认英文界面，通过官方中文语言包汉化，兼容性和稳定性优于第三方工具。
  1. 打开扩展面板：两种方式任选——① 快捷键 Ctrl+Shift+X；② 点击左侧边栏的 “扩展” 图标（四个小方块组成的图标）。
  2. 搜索并安装语言包：在扩展搜索框输入 “Chinese”，筛选出微软官方发布的 “Chinese (Simplified) Language Pack”，点击 “安装” 按钮等待完成。
  3. 重启生效：安装完成后，右下角会弹出提示框，点击 “Restart Now” 重启 VSCode，重启后界面自动切换为中文。

手动切换语言（未自动生效时备用方案）

  1. 快捷键 Ctrl+Shift+P 调出命令面板，输入 “Configure Display Language” 并回车。
  2. 在弹出的语言列表中选择 “zh-cn”，保存设置后重启 VSCode 即可。

配置文件兜底（极端情况适配）

若上述方法均无效，可通过配置文件强制设置中文：
  1. Ctrl+Shift+P 调出命令面板，输入 “Preferences: Configure Runtime Arguments” 并回车，打开 argv.json 配置文件（该文件用于自定义 VSCode 启动参数）。
  2. 在文件的大括号内添加一行配置："locale": "zh-cn"（注意与其他配置项用逗号分隔，避免语法错误），保存文件（Ctrl+S）后重启 VSCode，即可强制切换为中文界面。

三、插件的安装、管理与使用

VSCode 核心优势在于插件生态，可通过插件扩展语言支持、格式化、调试等功能，以下是完整操作流程。

1. 插件安装（三种方式，按需选择）

  • 常规安装：打开扩展面板（Ctrl+Shift+X），在顶部搜索框输入插件名称（如 Python、Prettier），优先选择作者为微软（Microsoft）或下载量 10 万+、评分 4.5+ 的插件，点击 “安装”；部分插件安装后需重启 VSCode 生效（右下角会弹出明确重启提示）。
  • 批量安装：Ctrl+Shift+P 调出命令面板，输入 “Extensions: Install Extensions” 回车，在扩展面板左侧勾选需安装的插件（可通过搜索筛选），勾选完成后点击顶部 “安装” 按钮，批量完成安装。
  • 离线安装：访问 VSCode 插件市场（https://marketplace.visualstudio.com/），搜索目标插件并下载.vsix 格式安装包；回到 VSCode，Ctrl+Shift+P 输入 “Extensions: Install from VSIX” 回车，选择下载的.vsix 文件，等待提示 “已安装成功” 即可，离线包需与 VSCode 版本兼容（插件页面会标注兼容版本）。

2. 插件管理（启用/禁用、更新、卸载）

  • 启用/禁用：在扩展面板找到目标插件，点击插件下方的 “禁用”/“启用” 按钮；部分插件状态变更后需重启 VSCode 生效。
  • 插件更新：扩展面板中，有更新的插件会显示 “更新” 按钮，点击即可单独更新；也可通过终端执行命令 code --update-extensions，一键更新所有已安装的扩展。
  • 插件卸载：在扩展面板找到目标插件，点击插件下方的 “卸载” 按钮，必要时重启 VSCode 清除残留。

3. 常用插件推荐（覆盖多开发场景）

插件名称
核心功能
适用场景
Python
Python 语言语法支持、调试、代码检查（Linting）、环境配置
Python 开发（爬虫、后端、数据分析等）
Prettier
自动代码格式化，支持多语言，统一代码风格
全语言开发（前端、后端、脚本等，需统一格式）
ESLint
JavaScript/TypeScript 语法检查、错误提示、自动修复
前端开发（Vue、React、Node.js 等）
GitLens
增强 Git 功能，显示代码提交历史、作者、修改记录
版本控制（多人协作、代码追溯）
Live Server
搭建本地服务器，实时预览 HTML 页面，修改后自动刷新
Web 前端开发（HTML/CSS/JavaScript）

四、插件汉化（适配无官方中文的插件）

部分第三方插件无官方中文，可通过以下方式汉化，优先选择稳定方案。
  1.  
  2. 优先官方中文：安装插件后，进入插件设置（扩展面板找到对应插件，点击右侧齿轮图标，选择 “扩展设置”），在设置页面搜索 “Language” 或 “语言”，若有中文选项直接切换，切换后无需重启即可生效（部分插件需重启）。
  3. 第三方汉化插件：在扩展面板搜索 “Chinese + 插件名”（如 “Chinese Prettier” 对应 Prettier 插件汉化），选择评分高、下载量大且最近更新时间较近的汉化插件安装；微软官方中文语言包会自动汉化大部分微软系插件（如 Python、C# 等），无需额外安装第三方汉化。
  4. 自定义汉化（进阶操作）： 安装 “i18n-ally” 插件，打开插件设置，配置翻译文件路径，可批量管理多个插件的翻译内容，支持实时预览翻译效果。
  5. 手动修改插件文件：找到 VSCode 插件安装目录（Windows：%USERPROFILE%.vscodeextensions；macOS：~/.vscode/extensions；Linux：~/.vscode/extensions），进入目标插件文件夹，修改 package.nls.json（英文）和 package.nls.zh-cn.json（中文）文件，修改前务必备份原文件，插件更新后手动修改内容会被覆盖，需重新配置。
注意：第三方汉化插件可能存在翻译不准确、兼容性问题，优先等待插件官方更新中文支持，或选择口碑较好的汉化插件。

五、常见问题与排查方案

常见问题
排查与解决步骤
安装后终端输入 code 提示 “不是内部命令”
1. 优先重新安装 VSCode 并确保勾选 “添加到 PATH” 选项，安装完成后重启终端（关键：环境变量生效需重启终端）；2. 手动添加环境变量：Windows 找到 VSCode 安装目录下的 bin 文件夹（如 D:Program FilesMicrosoft VS Codebin），复制路径，右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”→“用户变量”→“Path”→“编辑”→“新建”，粘贴路径后点击确定，重启终端即可；3. Linux/macOS 若未自动添加，可在 ~/.bashrc 或 ~/.zshrc 中添加 alias code=”/安装路径/Code”，执行 source ~/.bashrc 或 source ~/.zshrc 生效。
汉化后界面仍为英文
1. 确认中文语言包已启用（扩展面板搜索 “Chinese”，若显示 “启用” 按钮则点击启用，显示 “禁用” 即为已启用）；2. 按步骤手动切换语言并重启，重启时需完全关闭 VSCode（包括任务管理器中的后台进程）；3. 检查 argv.json 配置，确保无语法错误（逗号遗漏、引号不匹配均会导致失效）；4. 禁用其他第三方语言包插件，避免语言冲突，重启后重试。
插件安装失败
1. 网络问题：关闭代理、VPN，切换手机热点或稳定宽带，部分地区需配置镜像源（扩展面板设置→搜索 “Extensions: Registry”，修改为国内镜像源）；2. 版本不兼容：打开 VSCode→“帮助”→“检查更新”，更新到最新版本后重试；3. 缓存问题：删除插件缓存（Windows：%USERPROFILE%.vscodeextensions；macOS/Linux：~/.vscode/extensions），重启 VSCode 重新安装；4. 离线安装：下载对应版本的.vsix 包手动安装，避免在线安装的网络和版本问题。
插件汉化无效
1. 确认插件是否支持中文：查看插件市场页面的 “语言” 说明，部分插件无汉化版本，无法强制汉化；2. 安装专用汉化插件：确保汉化插件与目标插件版本兼容（查看汉化插件评论区反馈）；3. 自定义翻译：通过 i18n-ally 工具或手动修改翻译文件，若修改后仍无效，可能是插件结构更新，需等待汉化插件适配；4. 重启 VSCode：部分汉化插件生效需重启软件。
VSCode 启动缓慢或卡顿
1. 禁用冗余插件：扩展面板禁用不常用插件，尤其是后台运行的插件（如实时同步类）；2. 清理缓存：删除 VSCode 缓存文件（Windows：%APPDATA%Code；macOS：~/Library/Application Support/Code；Linux：~/.config/Code）；3. 关闭硬件加速：Ctrl+Shift+P 输入 “Preferences: Configure Runtime Arguments”，添加 “disable-hardware-acceleration”: true，重启 VSCode。