在Linux环境下安装Visual Studio Code(简称VS Code)是许多开发者的日常需求,作为微软推出的跨平台轻量级编辑器,VS Code凭借其丰富的插件生态、强大的调试功能和简洁的界面,成为Linux系统上进行编程开发的首选工具之一,本文将详细介绍在主流Linux发行版中安装VS Code的完整流程、配置方法及常见问题解决,帮助开发者快速搭建高效的开发环境。

安装前的准备工作
在开始安装VS Code前,需确保系统满足基本要求并完成必要的环境配置,VS Code支持64位x86架构和ARM架构的Linux系统,推荐操作系统版本为Ubuntu 18.04+、CentOS 7+、Fedora 30+、Debian 10+或Arch Linux,需提前安装以下基础依赖:
- curl或wget:用于从官方源下载安装包;
- GPG密钥工具:验证安装包完整性(部分发行版需要);
- 桌面环境:若使用图形界面,需确保已安装GNOME、KDE等桌面环境(非必需,但图形化操作更便捷)。
可通过终端检查系统信息,例如执行uname -a查看内核架构,lsb_release -a确认发行版版本,确保与VS Code兼容。
主流Linux发行版的安装方法
VS Code在Linux上的安装方式主要有三种:通过发行版官方包管理器安装、从官网下载deb/rpm包手动安装、以及直接下载tar.gz压缩包解压使用,不同发行版可根据习惯选择最合适的方式。
基于Debian/Ubuntu系统的安装
Debian和Ubuntu及其衍生版(如Linux Mint)通常使用apt包管理器,推荐通过微软官方源安装,以确保获取最新版本。
-
添加微软GPG密钥:
终端执行以下命令,导入VS Code的数字签名密钥:curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg sudo install -o root -g root -m 644 microsoft.gpg /etc/apt/trusted.gpg.d/
-
添加软件源:
根据系统版本选择对应的源(以Ubuntu 22.04为例):echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
-
安装VS Code:
更新软件包列表后直接安装:sudo apt update sudo apt install code
安装完成后,可在终端输入code命令启动,或通过应用程序菜单找到VS Code图标。
基于CentOS/RHEL/Fedora系统的安装
CentOS、RHEL和Fedora使用yum或dnf包管理器,同样需通过微软官方源安装。
-
安装EPEL仓库(CentOS/RHEL需要):

sudo yum install epel-release
-
添加微软软件源:
创建yum配置文件:sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
-
安装VS Code:
CentOS/RHEL使用yum,Fedora使用dnf:sudo yum install code # CentOS/RHEL sudo dnf install code # Fedora
基于Arch Linux系统的安装
Arch Linux用户可通过官方仓库直接安装,步骤最为简单:
sudo pacman -S visual-studio-code
安装后同样可通过终端命令code启动。
手动安装通用方法(适用于所有发行版)
若无法通过包管理器安装,或需要特定版本,可从VS Code官网下载对应系统的安装包(deb/rpm/tar.gz)。
-
下载安装包:
访问VS Code官网,选择“Linux”版本,根据系统架构下载deb(Debian/Ubuntu)、rpm(CentOS/RHEL/Fedora)或tar.gz(通用)格式。 -
安装deb/rpm包:
- Debian/Ubuntu:
sudo dpkg -i code_*.deb sudo apt install -f # 修复依赖关系
- CentOS/RHEL/Fedora:
sudo rpm -ivh code-*.rpm
- Debian/Ubuntu:
-
解压tar.gz包:
下载后解压到指定目录(如/opt),并创建软链接:sudo tar -xzvf code*.tar.gz -C /opt sudo ln -s /opt/VSCode-linux-x64/code /usr/local/bin/code
若需桌面快捷方式,可从
/opt/VSCode-linux-x64/resources/app/resources/linux目录复制.desktop文件到~/.local/share/applications/或/usr/share/applications/。
安装后的基本配置
首次启动VS Code时,建议进行基础配置以提升开发体验。

-
主题与界面设置:
- 点击“文件”→“首选项”→“颜色主题”,可选择暗色(Dark)、亮色(Light)或高对比度主题;
- 在“设置”中搜索
font,调整编辑器字体大小(如"editor.fontSize": 14)和字体族(推荐等宽字体如Fira Code)。
-
插件安装:
VS Code的核心优势在于插件生态,可通过左侧活动栏的“扩展”图标(或按Ctrl+Shift+X)搜索并安装插件,推荐插件包括:- Python:Python语言支持,包含调试、代码补全等功能;
- GitLens:增强Git功能,显示代码行 blame 信息;
- Docker:Docker容器管理,直接在编辑器中操作镜像和容器;
- Chinese Language Pack:中文语言包,支持界面汉化。
-
终端集成:
VS Code内置终端(按Ctrl+``),默认使用系统shell(如bash、zsh),可直接在编辑器中执行命令,无需切换窗口,若需修改默认终端,可在“设置”中搜索terminal.integrated.defaultShell,并指定shell路径(如/bin/zsh`)。
常见问题与解决方案
-
终端无法执行
code命令:
手动安装时未创建软链接,需执行sudo ln -s /opt/VSCode-linux-x64/code /usr/local/bin/code,将VS Code添加到系统PATH。 -
插件安装失败:
检查网络连接是否正常,或尝试配置代理(在“设置”中搜索proxy添加代理地址);若插件版本不兼容,可降级VS Code或更新插件。 -
中文显示乱码:
安装中文字体(如sudo apt install fonts-noto-cjk),并在设置中添加:"editor.fontFamily": "'Noto Sans CJK SC', 'Consolas', 'monospace'", "files.encoding": "utf8"
-
启动报错“无法定位符号”:
缺少系统依赖,如Ubuntu可执行sudo apt install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xauth libasound2,CentOS可执行sudo yum install gtk3 libnotify nss libXScrnSaver alsa-lib。
在Linux系统中安装VS Code是搭建开发环境的重要一步,无论是通过包管理器快速安装,还是手动配置压缩包,都能灵活适配不同发行版的需求,安装完成后,通过插件扩展和个性化设置,可将VS Code打造成功能强大的开发工具,支持Python、Java、Go等多种语言的开发,掌握安装与配置技巧,不仅能提升开发效率,更能充分利用Linux系统的开源优势,构建高效的开发工作流。