Visual Studio Code 終端機高級功能使用說明

Visual Studio Code 可存取的視圖

Visual Studio Code 可存取的視圖是一種輔助性視圖，該視圖預設位於 Visual Studio Code 的上方區域，其內容來自於命令列應用的緩沖區。可存取的視圖提供了更加便利的文字操作，可以輕松的選取並複製命令或命令的輸出結果。

{
	// 執行命令時顯示可存取的視圖並使其獲得焦點
	"terminal.integrated.accessibleViewFocusOnCommandExecution": true,
}

{
	// 保留遊標在可存取的視圖中的位置
	"terminal.integrated.accessibleViewPreserveCursorPosition": true,
}

自動回應 Visual Studio Code 終端機傳送的訊息

在命令執行的過程中，命令列應用可能會與使用者產生互動，輸出一些訊息並要求使用者輸入某些內容，比如，輸入Y來確認對檔案的刪除。

通過 Visual Studio Code 的設定項terminal.integrated.autoReplies，可以自動回應命令列應用輸出的訊息，該設定項是一個物件，物件的屬性名稱用於比對命令列輸出的訊息（輸出訊息需要包含屬性名稱，不需要完全相符），物件的屬性的值是自動回應的內容，他可以是null（表示無任何回應）或一個支援進行逸出的字串，可使用\r來表示Enter鍵。

如果修改設定項terminal.integrated.autoReplies之後未達到預期效果，可以嘗試重新啟動 Visual Studio Code。

{
	// 自動回應
	"terminal.integrated.autoReplies": {
		"package name:": "auto\r",
		"version:": "0.0.0\r",
		"(yes)": "no\r",
	},
}

npm init
package name: (…) auto
version: (1.0.0) 0.0.0
…
Is this OK? (yes) no
Aborted.

@echo off
for /l %%i in (1, 1, 10) do (
	set /p name=Enter Name:
	set /p age=Enter Age:
)

{
	// 自動回應
	"terminal.integrated.autoReplies": {
		// …
		"Enter Name": "someone\r",
		"Enter Age": "10\r",
	},
}

將繫結的按鍵傳送至 Visual Studio Code 而非終端機

在預設情況下，一些命令所繫結的按鍵將被傳送至 Visual Studio Code，而不是 Visual Studio Code 終端機所啟動的命令列應用，比如，與命令workbench.action.quickOpen繫結的按鍵Ctrl+P，按下Ctrl+P將由 Visual Studio Code 顯示一組檔案以便快速開啟他們。通過設定項terminal.integrated.commandsToSkipShell，你可以新增某個命令，使其具有上述效果，或使用-首碼新增某個命令，使其失去上述效果。

{
	// 與命令相關的按鍵將被傳送至 VSCode 而非命令列，除非使用 -
	"terminal.integrated.commandsToSkipShell": [
		// 以下命令的相關按鍵將被傳送至命令列
		"-workbench.action.quickOpen",
		"-workbench.action.terminal.focusFind",
	],
}

通過將 Visual Studio Code 設定項terminal.integrated.sendKeybindingsToShell設定為true（預設值為false），多數命令所繫結的按鍵將被傳送至命令列應用而不是 Visual Studio Code，這意味著設定項terminal.integrated.commandsToSkipShell將被覆蓋。

{
	// 將多數命令的相關按鍵傳送至 VSCode
	"terminal.integrated.sendKeybindingsToShell": true,
}

{
	// 組合按鍵將被傳送至命令列
	"terminal.integrated.allowChords": false,
}

{
	// 允許使用助記鍵開啟功能表欄
	"terminal.integrated.allowMnemonics": true,
}

在 Visual Studio Code 終端機中顯示影像

如果 Visual Studio Code 設定項terminal.integrated.gpuAcceleration不為off，WebGL 加速可用，設定項terminal.integrated.enableImages被設定為true（預設值為false），那麽 Visual Studio Code 終端機所啟動的命令列應用將支援顯示影像。

需要指出，由於 Visual Studio Code 命令列中的影像無法被序列化，因此，重新開啟的命令列應用無法顯示之前的影像。

{
	// 在命令列中顯示影像
	"terminal.integrated.enableImages": true,
}

在 Visual Studio Code 終端機中使用自黏捲動覆蓋層

在預設情況下，Visual Studio Code 終端機所啟動的命令列應用沒有自黏捲動覆蓋區，可以將設定項terminal.integrated.stickyScroll.enabled設定為true（預設值為false）來啟用自黏捲動覆蓋區，該覆蓋區通常會顯示被執行的命令。

{
	// 啟用命令列的自黏捲動覆蓋區
	"terminal.integrated.stickyScroll.enabled": true,
	// 自黏捲動覆蓋區的最大行數為 10
	"terminal.integrated.stickyScroll.maxLineCount": 10,
}

在遠端工作區的 Visual Studio Code 終端機中使用本機回應

如果 Visual Studio Code 開啟了遠端工作區，那麽使用者在本機的輸入（比如某一個字元）會被傳遞至遠端伺服器的命令列應用，其處理結果將傳回並顯示在 Visual Studio Code 終端機中。當本機與遠端伺服器存在較大網路延遲時，這會帶來不好的使用者體驗，而通過設定項terminal.integrated.localEchoEnabled啟用本機回應功能，可使使用者的輸入快速顯示在 Visual Studio Code 終端機中，無需等待遠端伺服器的處理，該設定項擁有以下取值。

auto

auto表示為 Visual Studio Code 遠端工作區終端機啟用本機回應。

on

on表示始終啟用 Visual Studio Code 終端機本機回應，無論是否為遠端工作區。

off

off表示始終停用 Visual Studio Code 終端機本機回應，無論是否為遠端工作區。

{
	// 始終開啟本機回應
	"terminal.integrated.localEchoEnabled": "on",
}

{
	// 立即進行本機回應
	"terminal.integrated.localEchoLatencyThreshold": 0,
}

{
	// 本機回應文字的色彩為紅色
	"terminal.integrated.localEchoStyle": "#ff0000",
}

{
	// 命令列的相關資訊包含以下某個關鍵字，則本機回應將被停用
	"terminal.integrated.localEchoExcludePrograms": [
		"powershell",
		"cmd",
	],
}

設定是否需要在關閉 Visual Studio Code 視窗時確認

如果你希望設定是否需要在關閉（結束） Visual Studio Code 且擁有尚未終止的命令列應用時確認關閉，那麽可以使用設定項terminal.integrated.confirmOnExit，該設定項擁有以下有效取值。

always

always表示始終需要在關閉 Visual Studio Code 時確認，如果擁有尚未終止的命令列應用。

hasChildProcesses

hasChildProcesses表示需要在關閉 Visual Studio Code 時確認，如果任意命令列應用擁有子處理序，比如，啟動了 Python 互動模式的 PowerShell。

never

never（預設值）表示直接關閉 Visual Studio Code，即便擁有尚未終止的命令列應用。

{
	// 如果任意命令列擁有子處理序，則需要在關閉 VSCode 時確認
	"terminal.integrated.confirmOnExit": "hasChildProcesses",
}

設定是否需要在終止 Visual Studio Code 終端機時確認

如果你希望設定是否需要在終止擁有子處理序的 Visual Studio Code 命令列應用時確認終止，那麽可以使用設定項terminal.integrated.confirmOnKill，該設定項擁有以下有效取值。

always

always表示始終需要在終止擁有子處理序的 Visual Studio Code 命令列應用時確認，無論該命令列位於終端機面板還是編輯器區域。

editor

editor（預設值）表示需要在終止擁有子處理序的 Visual Studio Code 命令列應用時確認，如果該命令列位於編輯器區域。

panel

panel表示需要在終止擁有子處理序的 Visual Studio Code 命令列應用時確認，如果該命令列位於終端機面板。

never

never表示直接關閉 Visual Studio Code 命令列應用，即便該命令列擁有子處理序。

{
	// 如果命令列擁有子處理序，則需要在終止時確認
	"terminal.integrated.confirmOnKill": "always",
}

設定是否為 Visual Studio Code 終端機的非零結束代碼顯示警示

如果 Visual Studio Code 終端機所啟動的命令列應用在終止時傳回的結束代碼不為0，那麽 Visual Studio Code 將顯示警示“終端機處理序 … 已終止，結束代碼：…”，將設定項terminal.integrated.showExitAlert設定為false，可停用該功能。

{
	// 不顯示警示，即便命令列的結束代碼不為 0
	"terminal.integrated.showExitAlert": false,
}

# 命令提示字元
exit 100

設定是否為 Visual Studio Code 終端機啟用命令修飾

在 Visual Studio Code 終端機所啟動的命令列應用中，命令修飾可以為已執行的命令提供操作功能表，通過 Visual Studio Code 設定項terminal.integrated.shellIntegration.decorationsEnabled可以設定是否為命令列應用啟用命令修飾，他擁有以下有效取值。

both

both（預設值）表示在 Visual Studio Code 命令列應用的裝訂邊中顯示命令修飾，並將在概述標尺中標記命令修飾的位置。

gutter

gutter表示在 Visual Studio Code 命令列應用的裝訂邊中顯示命令修飾。

overviewRuler

overviewRuler表示僅在 Visual Studio Code 命令列應用的概述標尺中標記命令修飾的位置，但不會在裝訂邊中顯示命令修飾。

never

never表示不顯示命令修飾，也不標記其位置。

{
	// 將命令修飾顯示在裝訂邊中
	"terminal.integrated.shellIntegration.decorationsEnabled": "gutter",
}

設定是否顯示 Visual Studio Code 終端機的命令指南

在 Visual Studio Code 終端機所啟動的命令列應用中，命令指南預設顯示在已執行命令和輸出結果的左邊裝訂邊中，當滑鼠暫留時。如果將 Visual Studio Code 設定項terminal.integrated.shellIntegration.showCommandGuide設定為false（預設為true），那麽命令列中的命令指南將不再顯示。

{
	// 不再顯示命令指南
	"terminal.integrated.shellIntegration.showCommandGuide": false,
}

設定是否為 Visual Studio Code 終端機註入腳本

一些特定的功能，比如自黏捲動覆蓋區，需要 Visual Studio Code 在命令列應用啟動時向其註入腳本，如果 Visual Studio Code 的設定項terminal.integrated.shellIntegration.enabled為false（預設為true），那麽相關腳本不會被註入，這表示某些功能將消失。

{
	// 允許腳本註入
	"terminal.integrated.shellIntegration.enabled": true,
}

程式碼

src/zh-hant/terminal/advanced·codebeatme/vscode·GitHub