在 Linux 上安裝 Visual Studio Code
Visual Studio Code 在 Linux 上提供官方的 Debian、RPM 和 Snap 套件。Arch Linux 和 Nix 也提供社群維護的套件。
在 Linux 上安裝 VS Code
請選擇符合您 Linux 發行版本的套件安裝方式。
Debian 與基於 Ubuntu 的發行版本
-
下載 .deb 套件。
-
使用圖形化軟體中心安裝此套件,或透過命令列進行安裝
sudo apt install ./<file>.deb # On older Linux distributions, run these commands instead: # sudo dpkg -i <file>.deb # sudo apt-get install -f # Install dependencies注意其他二進位檔可以在 VS Code 下載頁面取得。
.deb 套件會提示安裝 apt 套件庫與簽署金鑰,這可讓系統透過套件管理員進行自動更新。
若要進行非互動式安裝,請在安裝 .deb 套件之前執行此命令,以自動安裝 apt 套件庫和簽署金鑰
echo "code code/add-microsoft-repo boolean true" | sudo debconf-set-selections
手動安裝 apt 套件庫
-
安裝簽署金鑰
sudo apt install wget gpg && wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg -
建立包含以下內容的
/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 -
更新套件快取並安裝套件
sudo apt update && sudo apt install code # or code-insiders
由於手動簽署程序與發布系統的關係,Debian 套件庫可能會延遲最多三小時,無法立即包含最新版本的 VS Code。
RHEL、Fedora 與基於 CentOS 的發行版本
Microsoft 在 yum 套件庫中為 RHEL、Fedora 與基於 CentOS 的發行版本提供穩定的 64 位元 VS Code 套件。
-
安裝金鑰與 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 -
在 Fedora 22 及更新版本上,使用
dnf更新套件快取並安裝套件dnf check-update && sudo dnf install code # or code-insiders在較舊的版本上,請使用
yumyum check-update && sudo yum install code # or code-insiders
由於手動簽署程序與發布系統的關係,yum 套件庫可能會延遲最多三小時,無法立即包含最新版本的 VS Code。
Snap 套件
VS Code 以 Snap 套件的形式正式發布於 Snap 商店。
使用此命令安裝 Snap 套件
sudo snap install --classic code # or code-insiders
安裝完成後,Snap 常駐程式會在背景自動更新 VS Code。每當有新更新可用時,VS Code 會顯示產品內的更新通知。
如果您的 Linux 發行版本中沒有 snap,請參閱 安裝 snapd 指南。
從 Snap 官方說明文件深入了解 snap。
openSUSE 與基於 SLE 的發行版本
來自 RHEL、Fedora 與 CentOS 面板的 yum 套件庫也適用於 openSUSE 和基於 SLE 的系統。
-
安裝金鑰與 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 -
更新套件快取並安裝套件
sudo zypper install code
Arch Linux AUR 套件
VS Code 的 Arch User Repository 套件是由社群維護的。
有關安裝的詳細資料,請參閱 Arch Linux 維基百科關於安裝 AUR 套件的文章。
Nix 套件
nixpkgs 套件庫中的 VS Code Nix 套件是由社群維護的。
若要使用 Nix 安裝 VS Code
-
在您的
config.nix中將allowUnfree選項設定為 true。 -
執行此命令
nix-env -i vscode
手動 RPM 套件
當無法進行套件庫安裝時,請手動下載並安裝 VS Code .rpm 套件。除非已安裝套件庫,否則自動更新將無法運作。
使用您的套件管理員安裝已下載的 .rpm 套件,例如使用 dnf
sudo dnf install <file>.rpm
其他二進位檔可以在 VS Code 下載頁面取得。
更新
VS Code 每週發布新版本。如果正確安裝了 VS Code 套件庫,系統套件管理員處理自動更新的方式會與處理系統上其他套件的方式相同。
對於 Snap 套件而言,更新是自動的並會在背景執行。
將 VS Code 設定為預設文字編輯器
xdg-open
將 VS Code 設定為 xdg-open 所使用的文字檔(text/plain)之預設文字編輯器
xdg-mime default code.desktop text/plain
Debian 替代方案系統
基於 Debian 的發行版本支援透過 Debian 替代方案系統設定預設的 editor,而無需考量 MIME 類型。使用此命令將 VS Code 設定為預設編輯器
sudo update-alternatives --set editor /usr/bin/code
如果 VS Code 是透過 Snap 套件安裝的,請改用此命令
sudo update-alternatives --set editor /snap/bin/code
如果 VS Code 沒有顯示為預設 editor 的替代方案,請將其註冊
sudo update-alternatives --install /usr/bin/editor editor $(which code) 10
使用自訂標題列
自訂標題列透過鍵盤導覽與螢幕報讀程式提供佈景主題支援與更好的無障礙功能。由於桌面環境與視窗管理員各不相同,這些優點在 Linux 上可能無法總是完美呈現。因此,在 Linux 上預設不會啟用自訂標題列。
為了在使用螢幕報讀程式時改善無障礙功能,請在無障礙模式下執行時啟用自訂標題列。
使用 Window: Title Bar Style ( window.titleBarStyle ) 設定來設定標題列
custom:使用自訂標題列。native:使用作業系統標題列。
使用 WSL 在 Linux 上進行開發
使用 VS Code 進行 Linux 開發的另一種選擇是使用安裝了 Windows Subsystem for Linux (WSL) 的 Windows 電腦。
透過 WSL,您可以在 Windows 上安裝並執行 Linux 發行版本,以便在 Windows 電腦上進行本地作業的同時,在 Linux 上開發與測試原始程式碼。WSL 支援從 Microsoft Store 取得的 Linux 發行版本,例如 Ubuntu、Debian、SUSE 和 Alpine。
當搭配 WSL 擴充功能使用時,VS Code 可在 WSL 上的 Linux 發行版本環境中執行,同時提供編輯與偵錯支援。
請參閱在 WSL 中開發說明文件以深入了解,或試用在 WSL 中工作入門教學課程。
安裝之後
安裝 VS Code 後,請完成開發工作流程的設定
- 安裝額外元件,包括 Git、Node.js、TypeScript、語言執行時期與命令列工具。
- 從 Visual Studio Marketplace 安裝擴充功能,以新增佈景主題、格式化工具、偵錯工具與語言支援。
- 設定 GitHub Copilot 以在 VS Code 中使用 AI 功能。
- 啟動 VS Code 教學課程,以進行使用者介面與關鍵功能的動手導覽。
常見問題
未安裝 git 套件
當套件管理員的清單過期時,安裝過程中可能會出現此錯誤。請更新套件管理員並重新安裝
# For .deb
sudo apt-get update
# For .rpm on Fedora 21 and earlier
sudo yum check-update
# For .rpm on Fedora 22 and later
sudo dnf check-update
與來自其他套件庫的 VS Code 套件發生衝突
某些發行版本(例如 Pop!_OS)提供了它們自己的 code 套件。為了確保使用官方的 VS Code 套件庫,請建立一個名為 /etc/apt/preferences.d/code 的檔案,其內容如下
Package: code
Pin: origin "packages.microsoft.com"
Pin-Priority: 9999
Debian 與將檔案移至垃圾桶
如果在 Debian 上從 VS Code 檔案總管刪除檔案失敗,可能是缺少了 VS Code 所使用的垃圾桶實作。
執行此命令以安裝缺少的套件
sudo apt-get install gvfs libglib2.0-bin
「Visual Studio Code 無法監視此大型工作區中的檔案變更」(錯誤 ENOSPC)
此通知表示 VS Code 檔案監視器的檔案控制代碼即將耗盡。這通常在開啟包含大量檔案的工作區時發生。在調整平台限制之前,請將大型資料夾(例如 Python .venv)新增至 files.watcherExclude 設定中。其他執行中的應用程式也可能會消耗檔案控制代碼,因此關閉其他應用程式可能會有所幫助。
透過執行以下命令來檢視目前限制
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
每個檔案監視 佔用 1,080 位元組。如果消耗了全部 524,288 個監視,上限大約是 540 MiB。在記憶體受限的環境中,請選擇較低的值。
另一種選擇是使用 files.watcherExclude 設定,將特定的工作區目錄從 VS Code 檔案監視器中排除。預設的 files.watcherExclude 值會排除 node_modules 和 .git 下的一些資料夾。請新增其他不應由 VS Code 追蹤的目錄。
"files.watcherExclude": {
"**/.git/objects/**": true,
"**/.git/subtree-cache/**": true,
"**/node_modules/*/**": true
}
我在 Ubuntu 中看不到中文字元
開啟應用程式選單,然後選擇 檔案 (File) > 偏好設定 (Preferences) > 設定 (Settings)。在 文字編輯器 (Text Editor) > 字型 (Font) 區段中,將 字型家族 (Font Family) 設定為 Droid Sans Mono, Droid Sans Fallback。
若要直接編輯 settings.json 檔案,請設定 editor.fontFamily
"editor.fontFamily": "Droid Sans Mono, Droid Sans Fallback"
在 Ubuntu 上,code bin 命令無法將視窗帶到前景
當 VS Code 已經在目前目錄中開啟時,在 Ubuntu 上執行 code . 不會將 VS Code 帶到前景。這是作業系統的行為,可以使用 ccsm 來變更。
# Install
sudo apt-get update
sudo apt-get install compizconfig-settings-manager
# Run
ccsm
在 一般 (General) > 一般選項 (General Options) > 焦點與提高行為 (Focus & Raise Behavior) 下,將 防止焦點轉移層級 (Focus Prevention Level) 設定為 關閉 (Off)。此作業系統設定適用於所有應用程式,不僅限於 VS Code。
由於 "/etc/apt/sources.list.d/vscode.list: No such file or directory" 而無法安裝 .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
