Windows 終端機中的一般設定檔設定

以下所列的設定專屬於各個唯一的設定檔。 如果您想將某項設定套用至您所有設定檔，可以將該設定新增至 settings.json 檔案 (英文) 中設定檔清單上方的 defaults 區段。

"defaults":
{
    // SETTINGS TO APPLY TO ALL PROFILES
},
"list":
[
    // PROFILE OBJECTS
]

名稱

這是將在下拉式功能表中顯示的設定檔名稱。 這個值也會當做「標題」使用，以便在啟動時傳遞至 Shell。 某些 Shell (例如 bash) 可能會選擇忽略此初始值，而其他 Shell (Command Prompt、PowerShell) 可能會在應用程式的存留期內使用此值。 您可以使用 tabTitle 來覆寫此「標題」行為。

屬性名稱:name

必要性：必要

接受：字串

---

命令列

這是在設定檔中使用的可執行檔。

屬性名稱:commandline

必要性: 選用

接受：字串形式的可執行檔名稱

預設值："cmd.exe"

---

啟動目錄

這是 Shell 在載入時啟動的目錄。

屬性名稱:startingDirectory

必要性: 選用

接受：字串形式的資料夾位置

預設值："%USERPROFILE%"

注意：如未定義啟動目錄，預設值會設為 "%USERPROFILE%" (相對於使用者設定的路徑，例如可能為 C:\Users\<your username>)。 不過，若啟動目錄明確設定為 null，您就會根據啟動終端機的位置得到不同結果。

範例：尋找 powershell.exe 設定檔並新增 "startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",，藉此啟動您 [Documents] 目錄內 [GitHubRepos] 資料夾中的 PowerShell 設定檔

WSL 的範例：為透過 WSL 安裝的 Linux 發行版本 (機器翻譯) 設定啟動目錄時，請使用以下格式："startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME"，以您發行版本的正確名稱取代預留位置。 例如： "startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1" 。 如果您並非使用 settings.json 檔案，而是使用 Windows 終端機設定 UI 宣告此路徑，可以使用 [瀏覽...] 按鈕選取啟動目錄，或輸入 WSL 路徑，如下所示：//wsl.localhost/DISTRO NAME/home/USERNAME。 例如： //wsl.localhost/Ubuntu-20.04/home/user1 。

預設行為：startingDirectory 值未指定時，您會根據啟動終端機的位置得到不同結果：

• 如果您從 [開始] 功能表 執行 Windows 終端機：%WINDIR%\System32
• 如果您從 [開始] 功能表 執行wt.exe：%WINDIR%\System32
• 如果您從 Win+R 執行wt.exe： %USERPROFILE%
• 如果您是透過總管網址列執行 wt.exe：您正在查看的任何資料夾。

注意

反斜線必須逸出， 例如 C:\Users\USERNAME\Documents 應該輸入為 C:\\Users\\USERNAME\\Documents。

---

圖示

用於設定在索引標籤、下拉式功能表、捷徑清單和索引標籤切換器中顯示的圖示。

屬性名稱:icon

必要性: 選用

接受：字串形式的檔案位置或 Emoji

範例：只要將圖示影像 ubuntu.ico 放在位於 %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState 的資料夾中，便可透過在 settings.json 內的設定檔新增 "icon": "ms-appdata:///roaming/ubuntu.ico" 這一行來顯示圖示。

___

Tab title

如果設定，這會將 name 取代為要在啟動時傳遞至 Shell 的標題。 某些 Shell (例如 bash) 可能會選擇忽略此初始值，而其他 Shell (Command Prompt、PowerShell) 可能會在應用程式的存留期內使用此值。 如果您想要了解如何讓 Shell 設定您的標題，請造訪索引標籤標題教學課程。

屬性名稱:tabTitle

必要性: 選用

接受：字串

___

自動以系統管理員身分執行

設定本項目後，根據預設，此設定檔會自動在「已提升權限」的視窗中開啟 (以系統管理員的身分執行)。 如果您在未提升權限的視窗中執行此設定檔，系統會建立新的已提升權限終端機視窗來裝載此設定檔。 如果您在已提升權限的視窗中啟動此設定檔，則會在新的索引標籤中開啟。

若將這項屬性設定為 false，在已提升權限的視窗中開啟此設定檔時，便不會啟動用於裝載此設定檔的「未提升權限」視窗， 設定檔只會在已提升權限的視窗中開啟，並以系統管理員身分執行。

若您在 profiles.defaults 中設定這項屬性，則「所有」設定檔都會預設為以系統管理員身分啟動，除非您特地將這個項目設定為 false，將其覆寫。

這項屬性可在 newTab (機器翻譯) 與 splitPane (機器翻譯) 動作中以 elevate 屬性覆寫。

終端機視窗中不能同時有已提升權限和未提升權限的索引標籤。 如需詳細資訊，請參閱常見問題 (機器翻譯)。

屬性名稱:elevate

必要性: 選用

接受:true、false

預設值：false

___

從下拉式清單隱藏設定檔

如果 hidden 設定為 true，設定檔就不會出現在設定檔清單中。 這可以用來隱藏預設設定檔和動態產生的設定檔，同時將其保留在您的設定檔案中。 若要深入了解動態設定檔，請造訪動態設定檔頁面。

屬性名稱:hidden

必要性: 選用

接受:true、false

預設值：false