命令列介面 (CLI)
Visual Studio Code 具有強大的內建命令列介面，可讓您控制編輯器的啟動方式。您可以使用命令列選項 (參數) 開啟檔案、安裝擴充功能、變更顯示語言及輸出診斷資訊。
如果您正在尋找如何在 VS Code 內執行命令列工具，請參閱整合式終端機。
命令列說明
若要取得 VS Code 命令列介面的總覽，請開啟終端機或命令提示字元並輸入 code --help。您會看到版本、使用範例和命令列選項清單。
從命令列啟動
您可以從命令列啟動 VS Code，以快速開啟檔案、資料夾或專案。通常，您會在資料夾的內容中開啟 VS Code。若要執行此操作，請從開啟的終端機或命令提示字元中，導覽至您的專案資料夾並輸入 code .
注意： macOS 使用者必須先執行命令 (Shell Command: Install 'code' command in PATH)，將 VS Code 可執行檔新增至 PATH 環境變數。請閱讀 macOS 設定指南以取得協助。
Windows 和 Linux 安裝應將 VS Code 二進位檔位置新增至您的系統路徑。如果不是這種情況，您可以手動將位置新增至 Path 環境變數 (Linux 上的 $PATH)。例如，在 Windows 上，預設的 VS Code 二進位檔位置為 AppData\Local\Programs\Microsoft VS Code\bin。若要檢閱平台專屬的設定指示，請參閱設定。
Insiders： 如果您使用的是 VS Code Insiders 預覽版，您可以使用
code-insiders啟動您的 Insiders 建置。
核心 CLI 選項
以下是透過 code 在命令列啟動 VS Code 時可以使用的選用引數
| 引數 | 描述 |
|---|---|
-h 或 --help |
列印使用方式 |
-v 或 --version |
列印 VS Code 版本 (例如，1.22.2)、GitHub 提交 ID 和架構 (例如，x64)。 |
-n 或 --new-window |
開啟 VS Code 的新工作階段，而不是還原先前的工作階段 (預設)。 |
-r 或 --reuse-window |
強制在最後一個使用中的視窗中開啟檔案或資料夾。 |
-g 或 --goto |
與檔案:行{:字元}搭配使用時，會在特定行和選用字元位置開啟檔案。提供此引數是因為某些作業系統允許在檔案名稱中使用 :。 |
-d 或 --diff <file1> <file2> |
開啟檔案差異編輯器。需要兩個檔案路徑作為引數。 |
-m 或 --merge <path1> <path2> <base> <result> |
透過提供檔案的兩個修改版本的路徑、兩個修改版本的共同來源，以及儲存合併結果的輸出檔案，執行三向合併。 |
-w 或 --wait |
等候檔案關閉後再傳回。 |
--locale <locale> |
設定 VS Code 工作階段的顯示語言 (地區設定)。(例如，en-US 或 zh-TW) |
開啟檔案和資料夾
有時您會想要開啟或建立檔案。如果指定的檔案不存在，VS Code 會為您建立檔案，以及任何新的中繼資料夾
code index.html style.css documentation\readme.md
對於檔案和資料夾，您都可以使用絕對或相對路徑。相對路徑是相對於您執行 code 的命令提示字元的目前目錄。
如果您在命令列中指定多個檔案，VS Code 將只會開啟單一執行個體。
如果您在命令列中指定多個資料夾，VS Code 將建立一個多根目錄工作區，其中包含每個資料夾。
| 引數 | 描述 |
|---|---|
檔案 |
要開啟的檔案名稱。如果檔案不存在，將會建立檔案並標示為已編輯。您可以指定多個檔案，方法是以空格分隔每個檔案名稱。 |
檔案:行[:字元] |
與 -g 引數搭配使用。要在指定的行和選用字元位置開啟的檔案名稱。 |
資料夾 |
要開啟的資料夾名稱。您可以指定多個資料夾，並建立新的多根目錄工作區。 |
選取設定檔
您可以透過 --profile 命令列介面選項，使用特定的設定檔啟動 VS Code。您可以在 --profile 引數之後傳遞設定檔名稱，並使用該設定檔開啟資料夾或工作區。以下命令列會使用「Web 開發」設定檔開啟 web-sample 資料夾
code ~/projects/web-sample --profile "Web Development"
如果指定的設定檔不存在，則會建立具有指定名稱的新空白設定檔。
使用擴充功能
您可以從命令列安裝和管理 VS Code 擴充功能。
| 引數 | 描述 |
|---|---|
--install-extension <ext> |
安裝擴充功能。提供完整的擴充功能名稱 publisher.extension 作為引數。使用 --force 引數以避免提示。 |
--uninstall-extension <ext> |
解除安裝擴充功能。提供完整的擴充功能名稱 publisher.extension 作為引數。 |
--disable-extensions |
停用所有已安裝的擴充功能。擴充功能仍會顯示在「擴充功能」檢視的「已停用」區段中，但永遠不會啟用。 |
--list-extensions |
列出已安裝的擴充功能。 |
--show-versions |
使用 --list-extensions 時，顯示已安裝擴充功能的版本 |
--enable-proposed-api <ext> |
為擴充功能啟用建議的 API 功能。提供完整的擴充功能名稱 publisher.extension 作為引數。 |
--update-extensions |
更新已安裝的擴充功能並結束。 |
進階 CLI 選項
有幾個 CLI 選項可協助重現錯誤和進階設定。
| 引數 | 描述 |
|---|---|
--extensions-dir <dir> |
設定擴充功能的根路徑。 在可攜式模式中，會由 data 資料夾覆寫。 |
--user-data-dir <dir> |
指定使用者資料的儲存目錄，以在以根使用者身分執行時很有用。 在可攜式模式中，會由 data 資料夾覆寫。 |
-s, --status |
列印處理序使用量和診斷資訊。 |
-p, --performance |
啟動時啟用「開發人員：啟動效能」命令。 |
--disable-gpu |
停用 GPU 硬體加速。 |
--verbose |
列印詳細輸出 (表示 --wait)。 |
--prof-startup |
在啟動期間執行 CPU 分析工具。 |
--upload-logs |
將目前工作階段的記錄上傳至安全端點。 |
| 多根目錄 | |
--add <dir> |
將資料夾新增至多根目錄工作區的最後一個使用中視窗。 |
--remove <dir> |
從多根目錄工作區的最後一個使用中視窗中移除資料夾。 |
建立遠端通道
VS Code 與其他遠端環境整合，變得更加強大且彈性。我們的目標是提供一致的體驗，讓您可以從一個統一的 CLI 管理本機和遠端機器。
Visual Studio Code Remote - Tunnels 擴充功能可讓您透過安全通道連線到遠端機器，例如桌上型電腦或 VM。通道安全地將資料從一個網路傳輸到另一個網路。然後，您可以從任何地方安全地連線到該機器，而無需 SSH。
我們已在 code CLI 中建置功能，以在遠端機器上啟動通道。您可以執行
code tunnel
在您的遠端機器上建立通道。您可以透過 Web 或桌上型電腦 VS Code 用戶端連線到此機器。
您可以執行 code tunnel -help 來檢閱其他通道命令
由於您可能需要在無法安裝 VS Code Desktop 的遠端機器上執行 CLI，因此 CLI 也可在VS Code 下載頁面上進行獨立安裝。
如需遠端通道的詳細資訊，您可以檢閱遠端通道文件。
使用 URL 開啟 VS Code
您也可以使用平台的 URL 處理機制開啟專案和檔案。使用下列 URL 格式來
開啟專案
vscode://file/{full path to project}/
vscode://file/c:/myProject/
開啟檔案
vscode://file/{full path to file}
vscode://file/c:/myProject/package.json
開啟檔案至行和欄
vscode://file/{full path to file}:line:column
vscode://file/c:/myProject/package.json:5:10
開啟設定編輯器
vscode://settings/setting.name
vscode://settings/editor.wordWrap
您可以在瀏覽器或檔案總管等可以剖析和重新導向 URL 的應用程式中使用 URL。例如，在 Windows 上，您可以將 vscode:// URL 直接傳遞至 Windows 檔案總管或命令列，如 start vscode://{檔案的完整路徑}。
注意：如果您使用的是 VS Code Insiders 建置，則 URL 前置詞為
vscode-insiders://。
後續步驟
繼續閱讀以深入瞭解
常見問題
'code' 未被辨識為內部或外部命令
您的作業系統在其路徑中找不到 VS Code 二進位檔 code。VS Code Windows 和 Linux 安裝應已在您的路徑上安裝 VS Code。嘗試解除安裝並重新安裝 VS Code。如果仍然找不到 code，請參閱平台專屬的設定主題，以瞭解 Windows 和 Linux。
在 macOS 上，您需要手動執行 Shell Command: Install 'code' command in PATH 命令 (可透過命令面板 ⇧⌘P (Windows、Linux Ctrl+Shift+P) 取得)。請參閱 macOS 專屬設定主題以取得詳細資訊。
如何從 VS Code 內部取得命令列 (終端機) 的存取權？
VS Code 具有整合式終端機，您可以在其中從 VS Code 內部執行命令列工具。
我可以指定 VS Code 的設定位置，以便擁有可攜式版本嗎？
無法直接透過命令列指定，但 VS Code 具有可攜式模式，可讓您將設定和資料保留在與安裝位置相同的位置，例如 USB 磁碟機上。
我如何偵測 Shell 何時由 VS Code 啟動？
當 VS Code 啟動時，它可能會啟動 Shell 以取得「Shell 環境」來源，以協助設定工具。這將啟動互動式登入 Shell 並擷取其環境。根據您的 Shell 設定，這可能會導致問題。例如，Shell 以互動式工作階段啟動可能出乎意料，這是 VS Code 需要的，以便嘗試將 $PATH 與使用者建立的終端機中的確切值對齊。
每當 VS Code 啟動此初始 Shell 時，VS Code 會將變數 VSCODE_RESOLVING_ENVIRONMENT 設定為 1。如果您的 Shell 或使用者指令碼需要知道它們是否在此 Shell 的內容中執行，您可以檢查 VSCODE_RESOLVING_ENVIRONMENT 值。