异常教程

VSCode Linux 安装（长文讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言：为什么选择 VSCode Linux 安装？

在编程开发领域，代码编辑器的选择往往直接影响开发效率。Visual Studio Code（VSCode）凭借其轻量级、高度可定制化以及跨平台支持的特点，已成为开发者们的首选工具之一。对于 Linux 用户而言，VSCode 提供了与 Windows 和 macOS 平台一致的开发体验，同时完美适配 Linux 的命令行环境和系统特性。本文将从零开始，逐步讲解如何在 Linux 系统中安装和配置 VSCode，并通过实际案例帮助读者快速上手。

安装前的准备工作：了解 Linux 包管理器

在开始安装之前，我们需要了解 Linux 系统的核心工具——包管理器。它就像是一个超级市场，里面存放着各种软件的安装包。常见的包管理器包括 apt（Ubuntu/Debian）、dnf（Fedora）、pacman（Arch Linux）等。通过包管理器安装软件，可以确保依赖项自动下载、版本兼容性更好，且后续升级更方便。

如何确定你的 Linux 发行版？

打开终端（Terminal），输入以下命令：

lsb_release -a

根据输出结果，你可以识别出当前使用的 Linux 发行版（如 Ubuntu 22.04、Fedora 38 等）。

安装 VSCode 的三种主流方法

方法一：通过 Microsoft 官方仓库安装（推荐）

Microsoft 为 Linux 提供了官方的软件仓库，这确保了安装包的安全性和稳定性。以下是具体步骤：

步骤 1：添加 Microsoft GPG 密钥

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/microsoft.gpg > /dev/null

解释：这里使用 wget 下载 Microsoft 的公钥（GPG），并通过 gpg 工具将其转换为系统可信任的格式。

步骤 2：添加 VSCode 软件仓库

sudo sh -c 'echo "deb [arch=amd64,arm64,armhf] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

解释：此命令向系统添加 VSCode 的软件仓库地址，后续安装时系统会从这里下载软件包。

步骤 3：更新包列表并安装

sudo apt update
sudo apt install code -y

解释：code 是 VSCode 的命令行快捷方式，安装完成后可以直接通过 code 命令启动编辑器。

方法二：通过 DEB/RPM 包离线安装

如果你的 Linux 系统无法联网，或者需要离线安装，可以选择下载对应的安装包：

下载对应系统的安装包

访问 VSCode 官方下载页面 ，根据系统架构（如 x64、arm64）选择对应的 .deb（Debian/Ubuntu）或 .rpm（Red Hat/Fedora）文件。

安装命令示例（以 Debian/Ubuntu 为例）

sudo dpkg -i ~/Downloads/code_1.84.0-1696990480_amd64.deb
sudo apt --fix-broken install  # 修复依赖关系

方法三：通过 Snap 包管理器安装

Snap 是一种通用的包格式，可以跨 Linux 发行版使用。安装步骤如下：

sudo apt install snapd -y
sudo snap install --classic code

注意：--classic 参数允许 VSCode 访问系统文件，但可能带来一定安全风险。

验证安装与基础配置

启动 VSCode 并探索界面

安装完成后，可以通过以下方式启动：

  • 在终端输入 code；
  • 通过桌面环境的应用程序菜单搜索“VSCode”。

初次使用建议配置

  1. 设置默认终端：
    打开命令面板（Ctrl+Shift+P），输入 Terminal: Select Default Shell，选择你的 Linux 终端（如 Bash、Zsh）。

  2. 安装常用插件：
    推荐安装以下插件以提升开发效率：

    • Python（Python 开发必备）
    • C/C++（由 Microsoft 提供的官方扩展）
    • Markdown All in One（Markdown 文件增强工具）

进阶配置：让 VSCode 更贴合 Linux 环境

配置远程开发（Remote Development）

VSCode 的远程开发功能允许你在本地编辑器中操作远程服务器上的代码。以下是配置步骤：

安装 Remote Development 插件

在扩展商店搜索并安装 Remote Development 扩展包。

通过 SSH 连接远程服务器

在 VSCode 中按 Ctrl+Shift+P，输入 Remote-SSH: Connect to Host...，然后输入服务器地址（如 user@server_ip）。连接成功后，所有操作都会在远程服务器上执行。

自定义快捷键与主题

修改快捷键示例

  1. 打开快捷键设置（Ctrl+K Ctrl+S）；
  2. 搜索 Save All，将其绑定为 Ctrl+S（覆盖默认的单文件保存）。

更换主题

通过命令面板输入 Preferences: Color Theme，选择如 Dark+ 或 Monokai 等主题。

集成 Linux 命令行工具

示例：在 VSCode 中直接运行 Shell 命令

在终端中输入以下命令，直接执行 Python 脚本：

python3 ~/projects/hello.py

使用 Shell 脚本调试

通过 VSCode 的调试功能，可以轻松调试 Bash 脚本。创建一个 .vscode/launch.json 文件，添加以下配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Bash Debug",
      "type": "bashdb",
      "request": "launch",
      "program": "${file}",
      "cwd": "${fileDirname}"
    }
  ]
}

常见问题与解决方案

问题 1：安装后无法启动 VSCode

可能原因：缺少依赖库。
解决方案：

sudo apt install --install-recommends apt-transport-https

问题 2：VSCode 无法识别 Python 解释器

解决步骤：

  1. 打开命令面板，输入 Python: Select Interpreter；
  2. 选择系统中已安装的 Python 路径（如 /usr/bin/python3）。

问题 3：插件安装失败

解决方法：

  • 清除缓存： 
    rm -rf ~/.vscode/extensions
  • 重新安装插件。

结论：让 VSCode 成为你的 Linux 开发利器

通过本文的详细步骤，你已经掌握了 VSCode 在 Linux 系统上的安装与配置方法。从基础的软件仓库安装，到高级的远程开发和插件集成，每个环节都体现了 VSCode 在 Linux 环境中的强大灵活性。建议读者根据自身需求，进一步探索 VSCode 的扩展库（如 Git 集成、Docker 支持等），逐步构建属于自己的高效开发工作流。记住，工具的熟练程度直接影响开发效率，持续学习与实践是提升的关键。

提示：若想深入学习 Linux 开发，可以尝试在 VSCode 中配置一个完整的全栈项目（如使用 Node.js 或 Django），通过实践巩固所学知识。

最新发布

查看更多文章