Linux 上的 Visual Studio Code

安裝

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

   注意

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

2. 安裝其他元件

   安裝 Git、Node.js、TypeScript、語言執行階段等。

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

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

4. 設定 GitHub Copilot 的 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 > packages.microsoft.gpg
      sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg
      echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" |sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null
      rm -f packages.microsoft.gpg
      

   2. 然後更新套件快取並使用下列命令安裝套件

      sudo apt install apt-transport-https
      sudo apt update
      sudo apt install code # or code-insiders
      

以 RHEL、Fedora 和 CentOS 為基礎的發行版

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

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
   

Snap

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

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

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

安裝完成後，Snap daemon 會負責在背景自動更新 VS Code。每當有新更新可用時，您都會收到產品內更新通知。

從官方 Snap 文件深入瞭解快照。

以 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 設定為預設文字編輯器

xdg-open

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

xdg-mime default code.desktop text/plain

Debian alternatives system

以 Debian 為基礎的發行版允許使用 Debian alternatives system 設定預設編輯器，而無需擔心 MIME 類型。您可以執行下列命令並選取 code 來設定此項

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

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

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

使用自訂標題列

自訂標題列提供許多優點，包括絕佳的佈景主題支援，以及透過鍵盤導覽和螢幕閱讀器獲得更好的協助工具。這些優點可能不總是能很好地轉移到 Linux 平台。Linux 有各種桌面環境和視窗管理員，可能會讓 VS Code 佈景主題對使用者來說顯得很陌生。因此，預設情況下未在 Linux 上啟用自訂標題列。

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

您可以使用視窗：標題列樣式 (window.titleBarStyle) 設定手動設定標題列

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

Windows 作為 Linux 開發人員機器

使用 VS Code 進行 Linux 開發的另一個選項是使用具有Linux 的 Windows 子系統 (WSL) 的 Windows 機器。

適用於 Linux 的 Windows 子系統

透過 WSL，您可以在 Windows 上安裝和執行 Linux 發行版，以在 Linux 上開發和測試您的原始程式碼，同時仍然在本機 Windows 機器上工作。WSL 支援 Microsoft Store 提供的 Linux 發行版，例如 Ubuntu、Debian、SUSE 和 Alpine。

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

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

後續步驟

安裝 VS Code 後，下列主題將協助您瞭解更多相關資訊

• VS Code 教學課程 - 快速動手操作 VS Code 主要功能的導覽。
• 提示與技巧 - 適用於使用 VS Code 的生產力提示集合。
• AI 輔助編碼 - 瞭解如何在 VS Code 中使用 GitHub Copilot 來協助您更快地編寫程式碼。

常見問題

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 使用。在這種情況下，關閉這些其他應用程式可能會有所幫助。

目前的限制可以透過執行下列命令來檢視

cat /proc/sys/fs/inotify/max_user_watches

可以透過編輯 /etc/sysctl.conf (Arch Linux 除外，請參閱下方) 並將此行新增至檔案結尾，將限制增加到其最大值

fs.inotify.max_user_watches=524288

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

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

以 Arch 為基礎的發行版 (包括 Manjaro) 要求您變更不同的檔案；請改為依照這些步驟操作。

另一個選項是使用 files.watcherExclude 設定，從 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

    "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

code bin 命令不會將視窗帶到 Ubuntu 的前景

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

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

# Run
ccsm

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

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

當 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 設定為 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