探索 Agent 式開發 -

Visual Studio Code 在 Linux 上

安裝

  1. 下載並安裝適用於您的 Linux 發行版的 Visual Studio Code

    注意

    VS Code 每週發布新版本，並在有新版本可用時支援 自動更新。

  2. 安裝額外元件

    安裝 Git、Node.js、TypeScript、語言執行環境等。

  3. 從 Visual Studio Marketplace 安裝 VS Code 擴充功能

    使用佈景主題、格式化程式、適用於您喜愛語言的語言擴充功能與偵錯工具等來自訂 VS Code。

  4. 啟用 AI 功能

    提示

    如果您尚未訂閱 Copilot，可以透過註冊 Copilot 免費方案 來免費使用 Copilot，並獲得每月的內嵌建議和聊天互動額度。

  5. 開始 VS Code 教學課程

    探索 VS Code 的使用者介面與主要功能。

在 Linux 上安裝 VS Code

基於 Debian 和 Ubuntu 的發行版

  1. 在基於 Debian/Ubuntu 的發行版上安裝 Visual Studio Code 最簡單的方法是下載並安裝 .deb 套件 (64 位元)，可以透過圖形化軟體中心 (如果可用) 或透過命令列執行以下操作：

    sudo apt install ./<file>.deb

# If you're on an older Linux distribution, you will need to run this instead:
# sudo dpkg -i <file>.deb
# sudo apt-get install -f # Install dependencies
    注意

    其他二進位檔也可在 VS Code 下載頁面取得。

    當您安裝 .deb 套件時，它會提示您安裝 apt 儲存庫和簽章金鑰，以便使用系統的套件管理器啟用自動更新功能。

  2. 若要在非互動式終端機等環境中自動安裝 apt 儲存庫和簽章金鑰，請先執行以下命令：

    echo "code code/add-microsoft-repo boolean true" | sudo debconf-set-selections

  3. 手動安裝 apt 儲存庫

    1. 執行以下腳本以安裝簽章金鑰

      sudo apt-get install wget gpg &&
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg &&
sudo install -D -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/microsoft.gpg &&
rm -f microsoft.gpg

    2. 建立一個內容如下的 /etc/apt/sources.list.d/vscode.sources 檔案，以新增對上游套件儲存庫的參考：

      Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: amd64,arm64,armhf
Signed-By: /usr/share/keyrings/microsoft.gpg

    3. 最後，更新套件快取並安裝套件

      sudo apt install apt-transport-https &&
sudo apt update &&
sudo apt install code # or code-insiders
注意

由於手動簽章程序和我們使用的發布系統，Debian 儲存庫可能會延遲長達三小時，因此無法立即取得最新版本的 VS Code。

基於 RHEL、Fedora 和 CentOS 的發行版

我們目前在 yum 儲存庫中提供穩定的 64 位元 VS Code，適用於基於 RHEL、Fedora 或 CentOS 的發行版。

  1. 執行以下腳本以安裝金鑰和 yum 儲存庫

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc &&
echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\nautorefresh=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/vscode.repo > /dev/null

  2. 然後使用 dnf (Fedora 22 及更高版本) 更新套件快取並安裝套件

    dnf check-update &&
sudo dnf install code # or code-insiders

    或在舊版本上使用 yum

    yum check-update &&
sudo yum install code # or code-insiders
注意

由於手動簽章程序和我們使用的發布系統，yum 儲存庫可能會延遲長達三小時，因此無法立即取得最新版本的 VS Code。

Snap

VS Code 以 Snap 套件的形式在 Snap Store 中正式發行

Get it from the Snap Store

您可以透過執行以下命令來安裝它

sudo snap install --classic code # or code-insiders

安裝後，Snap 守護程序會在背景自動更新 VS Code。當有新更新可用時，您會收到產品內部的更新通知。

注意

如果您的 Linux 發行版中沒有 snap，請查閱 安裝 snapd 指南，該指南可以幫助您進行設定。

從 官方 Snap 文件了解更多關於 snaps 的資訊。

基於 openSUSE 和 SLE 的發行版

先前 提及的 yum 儲存庫也適用於基於 openSUSE 和 SLE 的系統。

  1. 執行以下腳本以安裝金鑰和 yum 儲存庫

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc &&
echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\nautorefresh=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/zypp/repos.d/vscode.repo > /dev/null

  2. 然後更新套件快取並使用以下方式安裝套件

    sudo zypper install code

適用於 Arch Linux 的 AUR 套件

有一個社群維護的 適用於 VS Code 的 Arch 使用者儲存庫套件。

要獲取更多關於從 AUR 安裝的資訊，請查閱以下 Wiki 條目：安裝 AUR 套件。

適用於 NixOS 的 Nix 套件 (或任何使用 Nix 套件管理器的 Linux 發行版)

nixpkgs 儲存庫中有一個社群維護的 VS Code Nix 套件。

透過 Nix 安裝

  1. 在您的 config.nix 中將 allowUnfree 選項設定為 true

  2. 執行以下命令

    nix-env -i vscode

手動安裝 .rpm 套件

您可以手動下載並安裝 VS Code .rpm 套件 (64 位元)，但是，除非安裝了上述儲存庫，否則自動更新將無法運作。

下載後，可以使用您的套件管理器安裝 .rpm 套件，例如使用 dnf

sudo dnf install <file>.rpm
注意

其他二進位檔也可在 VS Code 下載頁面取得。

更新

VS Code 每週發布新版本，您可以透過查看 發行說明來了解何時有新版本可用。如果 VS Code 儲存庫安裝正確，那麼您的系統套件管理器應該會像處理系統上的其他套件一樣處理自動更新。

注意

針對 Snap 套件，更新是自動的並在背景執行。

將 VS Code 設定為預設文字編輯器

xdg-open

您可以使用以下命令設定 xdg-open 用於文字檔案 (text/plain) 的預設文字編輯器

xdg-mime default code.desktop text/plain

Debian 替代系統

基於 Debian 的發行版允許使用 Debian 替代系統設定預設的 **編輯器**，而無需考慮 MIME 類型。您可以透過執行以下命令並選擇 code 來進行設定

sudo update-alternatives --set editor /usr/bin/code

如果您已透過 Snap 套件安裝 VS Code，請改用此命令

sudo update-alternatives --set editor /snap/bin/code

如果 VS Code 沒有顯示為預設 editor 的替代選項，您需要註冊它

sudo update-alternatives --install /usr/bin/editor editor $(which code) 10

使用自訂標題列

自訂標題列提供了許多優點，包括出色的佈景主題支援以及透過鍵盤導覽和螢幕助讀器提供更好的輔助功能。這些優點可能不總是能很好地轉移到 Linux 平台上。Linux 擁有多種桌面環境和視窗管理器，這可能會讓 VS Code 的佈景主題對使用者來說顯得格格不入。因此，在 Linux 上預設不啟用自訂標題列。

對於需要輔助功能改進的使用者，我們建議在使用螢幕助讀器以輔助功能模式執行時啟用自訂標題列。

您可以透過「**視窗：標題列樣式**」( window.titleBarStyle 在 VS Code 中開啟 在 VS Code Insiders 中開啟 ) 設定手動配置標題列

  • custom：使用自訂標題列。
  • native：使用作業系統的標題列。

將 Windows 作為 Linux 開發機器

使用 VS Code 進行 Linux 開發的另一個選項是使用安裝了 適用於 Linux 的 Windows 子系統 (WSL) 的 Windows 電腦。

Windows 子系統 Linux 版

透過 WSL，您可以在 Windows 上安裝和執行 Linux 發行版，以在 Linux 上開發和測試您的原始碼，同時仍可在 Windows 電腦上本機工作。WSL 支援 Ubuntu、Debian、SUSE 和 Alpine 等可從 Microsoft Store 取得的 Linux 發行版。

當與 WSL 擴充功能結合使用時，您可以在 WSL 上的 Linux 發行版環境中執行時，獲得完整的 VS Code 編輯和偵錯支援。

請參閱 在 WSL 中開發文件以了解更多資訊，或嘗試 在 WSL 中工作入門教學。

後續步驟

安裝 VS Code 後，這些主題將幫助您進一步了解：

常見問題

Debian 與將檔案移至垃圾桶

如果您在 Debian 作業系統上從 VS Code 檔案總管刪除檔案時看到錯誤，這可能是因為 VS Code 正在使用的垃圾桶實作不存在。

執行這些命令來解決此問題

sudo apt-get install gvfs libglib2.0-bin

與來自其他儲存庫的 VS Code 套件衝突

某些發行版，例如 Pop!_OS，提供自己的 code 套件。為了確保使用官方的 VS Code 儲存庫，請建立一個名為 /etc/apt/preferences.d/code 的檔案，內容如下

Package: code
Pin: origin "packages.microsoft.com"
Pin-Priority: 9999

「Visual Studio Code 無法在此大型工作區中監看檔案變更」(錯誤 ENOSPC)

當您看到此通知時，表示 VS Code 檔案監看器已用盡實作檔案監看所需的檔案控制代碼。這通常發生在開啟包含許多檔案的大型工作區時。在調整平台限制之前，請確保將潛在的大型資料夾 (例如 Python 的 .venv) 新增到 files.watcherExclude 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定中 (詳情如下)。也有可能其他正在執行的應用程式消耗了太多的檔案控制代碼，導致 VS Code 無法使用。在這種情況下，關閉這些其他應用程式可能會有所幫助。

目前的限制可以透過執行以下命令來查看

cat /proc/sys/fs/inotify/max_user_watches

可以透過編輯 /etc/sysctl.conf (Arch Linux 和 Ubuntu 24.10 及更高版本使用 /etc/sysctl.d/*.conf 中的檔案) 並將此行新增到檔案末尾來將限制增加到最大值

fs.inotify.max_user_watches=524288

然後可以透過執行 sudo sysctl --system 來載入新值。

雖然 524,288 是可以監看的最大檔案數，但如果您處於記憶體特別受限的環境中，您可能希望降低此數字。每個檔案監看會佔用 1,080 位元組，因此假設所有 524,288 個監看都被消耗，則上限約為 540 MiB。

另一個選項是使用 files.watcherExclude 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定將特定的工作區目錄從 VS Code 檔案監看器中排除。 files.watcherExclude 的預設值排除了 node_modules 和 .git 下的一些資料夾，但您可以新增其他不希望 VS Code 追蹤的目錄。

"files.watcherExclude": {
    "**/.git/objects/**": true,
    "**/.git/subtree-cache/**": true,
    "**/node_modules/*/**": true
  }

我在 Ubuntu 中看不到中文字元

我們正在開發修復程式。同時，請開啟應用程式選單，然後選擇 檔案 > 喜好設定 > 設定。在「文字編輯器」>「字型」部分中，將「字型系列」設定為 Droid Sans Mono, Droid Sans Fallback。如果您想直接編輯 settings.json 檔案，請將 editor.fontFamily 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定如下所示

    "editor.fontFamily": "Droid Sans Mono, Droid Sans Fallback"

套件 git 未安裝

此錯誤可能在安裝期間出現，通常是套件管理器清單過期所致。請嘗試更新它們並重新安裝

# For .deb
sudo apt-get update

# For .rpm (Fedora 21 and below)
sudo yum check-update

# For .rpm (Fedora 22 and above)
sudo dnf check-update

在 Ubuntu 上，code bin 命令無法將視窗帶到前景

在 Ubuntu 上，當 VS Code 已在目前目錄中開啟時，執行 code . 將不會把 VS Code 帶到前景。這是作業系統的一項功能，可以使用 ccsm 停用。

# Install
sudo apt-get update
sudo apt-get install compizconfig-settings-manager

# Run
ccsm

在「**一般**」>「**一般選項**」>「**焦點與提升行為**」下，將「焦點預防等級」設定為「關閉」。請記住，這是作業系統層級的設定，將適用於所有應用程式，而不僅僅是 VS Code。

無法安裝 .deb 套件，因為「/etc/apt/sources.list.d/vscode.list: 沒有此檔案或目錄」

這可能發生在 sources.list.d 不存在或您沒有權限建立檔案時。要解決此問題，請嘗試手動建立資料夾和一個空的 vscode.list 檔案

sudo mkdir /etc/apt/sources.list.d
sudo touch /etc/apt/sources.list.d/vscode.list

在使用 X 轉發遠端視窗時，無法移動或調整視窗大小

如果您使用 X 轉發來遠端使用 VS Code，您將需要使用原生標題列以確保您可以正確操作視窗。您可以透過將 window.titleBarStyle 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定為 native 來切換使用它。

儲存庫更改了其原始值

如果您收到類似以下的錯誤

E: Repository '...' changed its 'Origin' value from '...' to '...'
N: This must be accepted explicitly before updates for this repository can be applied. See apt-secure(8) manpage for details.

請使用 apt 而不是 apt-get，系統會提示您接受原始值變更。

sudo apt update
4/8/2026
English 한국어 中文(简体) 中文(繁體)
© . This site is unofficial and not affiliated with Microsoft.