按下 Ctrl 想跑一條命令蹦出來卻是 PowerShell想在 Windows 上切到 Git Bash 執(zhí)行 shell 腳本還得每次手動點終端面板右側(cè)的下拉箭頭。這類場景我在技術(shù)群里見過太多次了。VS Code 的默認(rèn)終端并不是寫死的它完全可以通過配置改成 CMD、Git Bash、WSL 的 Ubuntu甚至是自定義路徑的第三方終端。這篇內(nèi)容針對 Windows、macOS、Linux 三個平臺梳理了 4 種修改默認(rèn)終端的方案從純鼠標(biāo)操作到直接改 JSON 都覆蓋。適合剛上手 VS Code 的新手也適合需要在多臺機(jī)器間同步配置的開發(fā)者。我會把背后的 Profile 機(jī)制、配置項的優(yōu)先級、以及幾個改了不生效的典型原因一起講清楚。1. 先搞清楚默認(rèn)終端在 VS Code 里到底由誰控制1.1 終端 Profile、Default Profile 和 Profiles 配置塊要改默認(rèn)終端不能只在設(shè)置界面里瞎找。VS Code 的集成終端體系里有三個基本概念。第一個是終端配置文件Terminal Profile。它描述終端面板里可啟動的某一種 shell包含可執(zhí)行文件路徑、啟動參數(shù) args、圖標(biāo) icon 等內(nèi)容。簡單說一個 Profile 就是一款終端程序 它啟動時附帶的參數(shù)。第二個是默認(rèn)配置文件Default Profile也就是你在按 Ctrl或點擊終端面板加號按鈕時VS Code 默認(rèn)加載的那一個 Profile。第三個是 Profiles 配置塊也就是 settings.json 里的terminal.integrated.profiles.windows、.osx、.linux 這些節(jié)點它們負(fù)責(zé)定義當(dāng)前平臺上有哪些可用的 Profile。用生活場景類比Profile 就像一排飲料機(jī)的按鈕可樂、氣泡水、無糖茶Default Profile 就是你隨手按默認(rèn)飲品鍵時掉出來的那瓶。你真正要改的是默認(rèn)掉出來的是什么。1.2 平臺鍵名別搞混VS Code 在不同操作系統(tǒng)的 settings.json 中使用不同的鍵名這是新手最容易翻車的地方。Windows 對應(yīng)的配置鍵是terminal.integrated.defaultProfile.windowsmacOS 的鍵名是terminal.integrated.defaultProfile.osxLinux 的鍵名是terminal.integrated.defaultProfile.linux注意 macOS 這里雖然設(shè)置界面里顯示的是 Terminal ? Integrated ? Default Profile: macOS但 JSON 內(nèi)部實際的鍵是osx而不是macos。很多人在這里寫錯導(dǎo)致配置完全不生效。在 Profiles 定義塊里同樣要對應(yīng)用profiles.windows、profiles.osx、profiles.linux?？缙脚_配置時建議三個鍵都寫上避免換機(jī)器后某一平臺沒有默認(rèn)值。1.3 常見終端 Profile 及其顯示名默認(rèn)情況下VS Code 會根據(jù)操作系統(tǒng)自動發(fā)現(xiàn)本機(jī)已安裝、且能被識別到的終端程序自動在終端下拉列表里列出這些 Profile。下面這張表列出了常見平臺的 Profile 顯示名方便后續(xù)對照配置平臺常見 Profile 顯示名說明WindowsPowerShellWindows 自帶 PowerShell 5.1注意大小寫WindowsCommand Promptcmd.exeWindowsGit Bash安裝了 Git for Windows 才會出現(xiàn)WindowsUbuntu (WSL) / Debian (WSL)裝了 WSL 發(fā)行版后出現(xiàn)macOSzsh新版系統(tǒng)默認(rèn) shellmacOSbash舊版系統(tǒng)默認(rèn) shellLinuxbash / sh / zsh / fish取決于系統(tǒng)已安裝的 shell這些顯示名其實對應(yīng) profile 的name字段或 JSON key。你不需要背這些名字只要在終端面板的下拉列表里看到什么settings.json 里就用什么。唯一要注意的是 PowerShell 的大小寫自動發(fā)現(xiàn)的 Windows PowerShell 顯示名通常是PowerShell不是powershell。寫錯大小寫在部分版本中不會報錯但會靜默回退到默認(rèn)終端。2. 方法一用命令面板一條命令搞定2.1 三步完成設(shè)置命令面板是 VS Code 里被嚴(yán)重低估的入口。它提供了一個很直接的命令來切換默認(rèn)終端。操作步驟按 CtrlShiftPmacOS 使用 CmdShiftP打開命令面板。輸入Terminal: Select Default Profile回車。在列出的終端列表中選擇要設(shè)為默認(rèn)的那一項回車即可。完成之后關(guān)閉當(dāng)前終端面板再重新打開默認(rèn)啟動的終端就變成你選的 Profile 了。2.2 為什么我建議你先用這個方法首先是快。不需要進(jìn)入設(shè)置頁、不需要記憶 JSON 鍵名兩秒鐘結(jié)束。其次這個方法天然避免了拼寫錯誤——你直接選擇 VS Code 掃描到的 Profile 名稱而不是自己手敲。對于大部分只需要在現(xiàn)有終端里挑一個的用戶這已經(jīng)足夠了。我在幫同事排查改了 settings.json 不起作用的問題時至少有一半情況是 JSON 里的 Profile 名稱和實際顯示名不一致。用命令面板反而不會出現(xiàn)這種問題。2.3 命令面板解決不了的場景命令面板只能選擇現(xiàn)有 Profile不能創(chuàng)建新 Profile。如果你的 Git Bash 沒被自動發(fā)現(xiàn)、或者你想自定義 cmd.exe 的啟動參數(shù)這個方法沒法完成。另外命令面板修改的默認(rèn)配置會寫到用戶級設(shè)置User Settings中它只能影響當(dāng)前用戶、無法跟進(jìn)項目配置。如果你需要為某個項目單獨指定默認(rèn)終端還是要靠后面的工作區(qū)配置方案。3. 方法二設(shè)置界面可視化修改3.1 找到“Default Profile”配置項打開 VS Code 設(shè)置Windows/Linux 下按 Ctrl,macOS 下按 Cmd,。然后在設(shè)置搜索框里輸入default profile很快就能看到 Terminal Integrated Default Profile: Windows 或者 Default Profile: macOS 之類的下拉框。點開下拉框選中你想要的終端保存后關(guān)閉面板。這個操作和命令面板選擇默認(rèn) Profile 的效果本質(zhì)相同——最終都是寫入用戶級 settings.json 中的defaultProfile字段。3.2 為什么還要保留設(shè)置界面入口有讀者可能會問既然命令面板能設(shè)置默認(rèn)終端為什么設(shè)置界面里還要再配一遍實際上兩者背后改的是同一個配置項只是入口不同。命令面板適合已經(jīng)明確知道自己要什么的人設(shè)置界面則能讓不熟悉命令面板的用戶通過搜索聯(lián)想慢慢摸到配置含義。在實際工作中我更傾向于把設(shè)置界面當(dāng)查看當(dāng)前配置的窗口來用因為它的下拉框里會顯示當(dāng)前生效的 Profile 值。排查改了不生效的問題時打開這一頁一眼就能確認(rèn)最終值是什么比翻 JSON 更直觀。3.3 設(shè)置界面下拉列表為空或沒有想要的終端在 Windows 上最常見的抱怨是下拉列表里只有 PowerShell 和 Command Prompt沒有 Git Bash 也沒有 WSL。這是因為 VS Code 自動發(fā)現(xiàn)終端時依賴 PATH 環(huán)境變量和默認(rèn)安裝目錄。如果你安裝 Git 時沒有勾選 Add to PATH或者 WSL 發(fā)行版未被正確初始化自動發(fā)現(xiàn)就會漏掉它們。此時不用著急可以直接跳到方法三在 settings.json 中手動聲明 Profile。聲明成功后這個 Profile 會出現(xiàn)在下拉列表中之后你仍然可以用設(shè)置界面繼續(xù)維護(hù)默認(rèn)項。4. 方法三直接編輯 settings.json一勞永逸4.1 打開 JSON 配置文件的兩種姿勢第一種按 CtrlShiftP 輸入Preferences: Open User Settings (JSON)回車。第二種先打開設(shè)置界面點擊右上角的打開設(shè)置(JSON)圖標(biāo)。兩種方式打開的都是用戶級 settings.json。如果你只是給自己換終端改這個文件就好如果想讓整個項目共用統(tǒng)一終端配置則要打開項目根目錄下的.vscode/settings.json也就是方法四的內(nèi)容。4.2 Windows 下最常用的配置示例先給一個最簡單、只改默認(rèn)項的版本。假設(shè) VS Code 能正常識別 Git Bash只需要把默認(rèn)終端改成它{ terminal.integrated.defaultProfile.windows: Git Bash }如果 VS Code 沒能自動識別 Git Bash就要同時補(bǔ)上 Profiles 定義{ terminal.integrated.profiles.windows: { Git Bash: { path: C:\\Program Files\\Git\\bin\\bash.exe } }, terminal.integrated.defaultProfile.windows: Git Bash }這里有兩個細(xì)節(jié)需要注意。第一path 里的反斜杠在 JSON 中必須寫成雙反斜杠\\寫成單反斜杠\會導(dǎo)致 JSON 解析失敗或者路徑被轉(zhuǎn)義成錯誤值。不想寫雙反斜杠的話也可以統(tǒng)一用正斜杠C:/Program Files/Git/bin/bash.exeVS Code 能正常識別。第二如果 Git 安裝到了別的盤或自定義目錄需要把路徑改寫成實際位置。不確定路徑時打開 Git Bash 輸入which bash或echo $PATH找一下。如果你更想用 PowerShell 7pwsh.exe替代系統(tǒng)自帶的 Windows PowerShell 5.1配置如下{ terminal.integrated.profiles.windows: { PowerShell 7: { path: C:\\Program Files\\PowerShell\\7\\pwsh.exe } }, terminal.integrated.defaultProfile.windows: PowerShell 7 }如果想把默認(rèn)終端切到 WSL 里的某個發(fā)行版假設(shè)發(fā)行版名是 Ubuntu{ terminal.integrated.profiles.windows: { Ubuntu (WSL): { path: C:\\Windows\\System32\\wsl.exe, args: [-d, Ubuntu] } }, terminal.integrated.defaultProfile.windows: Ubuntu (WSL) }args數(shù)組里的-d表示指定發(fā)行版名稱。如果你的 WSL 只有一個發(fā)行版甚至可以省略 argsVS Code 會自動使用默認(rèn)的 WSL 發(fā)行版。這里順便提一句很多人在 VS Code 里配置 C/C 編譯環(huán)境時也喜歡把默認(rèn)終端切到 Git Bash 或 WSL因為make、gcc、arm-none-eabi-gcc這類工具鏈在 bash 環(huán)境下更好用。配置方式和上面完全一樣不需要額外折騰編譯器插件問題終端環(huán)境統(tǒng)一了編譯流程自然順暢。4.3 macOS 和 Linux 的簡版配置macOS 默認(rèn)終端換成 zsh新版系統(tǒng)默認(rèn)就是 zsh可以這樣寫{ terminal.integrated.defaultProfile.osx: zsh }Linux 換成 bash 或 zsh 同理{ terminal.integrated.defaultProfile.linux: bash }如果你裝了 fish想把它設(shè)為默認(rèn)需要先定義 profile{ terminal.integrated.profiles.linux: { fish: { path: /usr/bin/fish } }, terminal.integrated.defaultProfile.linux: fish }如果你不確定 shell 的可執(zhí)行路徑可以在系統(tǒng)終端里執(zhí)行which fish、which zsh命令返回的路徑直接填進(jìn)去即可。4.4 避坑Profile 的 key、name 和 defaultProfile 匹配關(guān)系這是設(shè)置默認(rèn)終端最重要的知識點。終端下拉列表顯示的名稱來自 profile 配置塊的字段。如果在 profile 配置里只寫了 key比如Git Bash那么下拉列表顯示的就是Git BashdefaultProfile 里也寫Git Bash。但如果配置里帶了name字段{ terminal.integrated.profiles.windows: { gitbash: { name: 自定義 Git Bash, path: C:\\Program Files\\Git\\bin\\bash.exe } } }此時下拉列表顯示的是自定義 Git BashdefaultProfile 也應(yīng)該寫成自定義 Git Bash而不是gitbash。VS Code 匹配 defaultProfile 時優(yōu)先使用name字段其次才是 JSON key。實踐中最穩(wěn)妥的策略是不要給 key 和 name 設(shè)置不同的值除非你非常清楚自己在做什么。否則很容易出現(xiàn)我明明配了 gitbash下拉列表里也叫 gitbash可就是不生效的怪問題。4.5 給 cmd.exe 附加啟動參數(shù)有些老項目需要 cmd.exe 一啟動就切換到 UTF-8 代碼頁或者執(zhí)行一段初始化腳本。這時候可以在 Profile 里加 args{ terminal.integrated.profiles.windows: { CMD (UTF-8): { path: C:\\Windows\\System32\\cmd.exe, args: [/k, chcp 65001] } }, terminal.integrated.defaultProfile.windows: CMD (UTF-8) }/k表示執(zhí)行完命令后保持窗口不關(guān)閉。這個技巧在跑中文路徑或處理各種編碼異常時非常管用很多埋著頭改代碼的亂碼問題其實根子在終端代碼頁。5. 方法四工作區(qū)級配置讓不同項目用不同終端5.1 什么時候需要工作區(qū)級配置如果你只在自己電腦上開發(fā)方法一到方法三已經(jīng)夠用。但對協(xié)作項目來說工作區(qū)配置的價值就出來了。例如項目 A 的構(gòu)建腳本是 shell 腳本統(tǒng)一讓團(tuán)隊都用 Git Bash 或 WSL 跑項目 B 需要特定 PowerShell 模塊默認(rèn)終端固定為 pwsh 7。如果靠每個人各自改用戶配置換個環(huán)境就崩。把默認(rèn)終端寫進(jìn)項目的.vscode/settings.json團(tuán)隊克隆下來后不用額外設(shè)置VS Code 就會用項目自己的默認(rèn)終端工作。5.2 配置方法與示例在 VS Code 里打開項目根目錄新建或編輯.vscode/settings.json寫入配置。寫法與用戶級配置完全一樣只是作用范圍不同。比如{ terminal.integrated.defaultProfile.windows: Git Bash, terminal.integrated.profiles.windows: { Git Bash: { path: C:\\Program Files\\Git\\bin\\bash.exe } } }這里有個很實際的建議把類似path這種依賴本機(jī)目錄的配置放到用戶級把不依賴環(huán)境的配置如defaultProfile名稱放到工作區(qū)級能最大程度保證換機(jī)器時可復(fù)用。如果團(tuán)隊統(tǒng)一約定環(huán)境且目錄一致直接把 path 寫進(jìn).vscode/settings.json也沒有問題只是記得在 README 里注明。5.3 配置的優(yōu)先級Remote Workspace User涉及多個配置來源時VS Code 有一套優(yōu)先級規(guī)則默認(rèn)內(nèi)置值優(yōu)先級最低用戶設(shè)置User Settings覆蓋默認(rèn)值工作區(qū)設(shè)置Workspace Settings覆蓋用戶設(shè)置遠(yuǎn)程設(shè)置Remote Settings比如 Remote-SSH 窗口中的設(shè)置優(yōu)先級最高。換句話說當(dāng)項目里已經(jīng)寫了defaultProfile.windows時你就算把用戶級設(shè)置改成別的當(dāng)前項目中打開的終端也不會聽你的。排查改了不生效的問題時第一件事就是確認(rèn)是不是被更高優(yōu)先級的配置蓋住了。6. 常見問題與排查技巧實錄6.1 改了默認(rèn)終端但重新打開還是老樣子這是出現(xiàn)頻率最高的一個問題。排查順序建議如下。第一區(qū)分已經(jīng)打開的終端和新建的終端。默認(rèn)終端配置只對新打開的終端生效已經(jīng)停留在面板里的舊終端不會切換。關(guān)閉舊終端重新按 Ctrl 或點擊加號新建一個終端再看效果。第二檢查配置層級。工作區(qū)設(shè)置會覆蓋用戶設(shè)置。如果項目根目錄.vscode/settings.json里已經(jīng)寫了默認(rèn)終端你在用戶設(shè)置里改多少遍都沒用必須改工作區(qū)設(shè)置或刪除該配置。第三確認(rèn)平臺鍵名。在 Windows 上要寫windows在 macOS 上寫osx而不是macos在 Linux 上寫linux。寫錯鍵名并不會報錯只會靜默失效。第四檢查 Profile 名稱的匹配關(guān)系。defaultProfile 里填的名稱必須與 Profiles 配置塊的可展示名稱一致若有name字段則使用name否則使用 key。名稱不匹配時 VS Code 會回退到自動發(fā)現(xiàn)的第一個 Profile看起來就像改了沒生效。6.2 終端下拉列表里找不到 Git Bash / WSL / pwsh優(yōu)先確認(rèn)是否安裝并成功加入 PATH。Git for Windows 安裝時有一個選項 Use Git from the Windows Command Prompt如果沒勾選bash.exe 不會被放進(jìn) PATHVS Code 自然掃描不到。此時最簡單的做法是重裝 Git 并在安裝向?qū)Ю锕催x該項然后重啟 VS Code。不想重裝的也可以在 settings.json 中手動聲明 profile指定 bash.exe 完整路徑。WSL 發(fā)行版未被識別的原因通常是發(fā)行版未完成初始化需要至少運行過一次 wsl.exe 并設(shè)置 Linux 用戶名/密碼或者 VS Code 尚未觸發(fā) WSL 掃描。讓發(fā)行版正常啟動一次重啟 VS Code 后再看下拉列表。PowerShell 7 如果安裝在非標(biāo)準(zhǔn)目錄自動發(fā)現(xiàn)也可能失敗手動聲明 profile 永遠(yuǎn)是兜底方案。6.3 我只想臨時用一次別的終端不想改默認(rèn)完全沒必要改默認(rèn)。終端面板右上角的下拉箭頭或加號圖標(biāo)旁的下拉箭頭打開后可以直接選擇任意 Profile 開會話。另一個常用做法是給某個 Profile 綁定專屬快捷鍵在 keybindings.json 中為新建終端的 profile 指定 keybind。比如我習(xí)慣用 Git Bash 跑自動化腳本但默認(rèn)終端繼續(xù)用 PowerShell就單獨給 Git Bash 新建終端 綁了一個鍵。順手說一句在終端里跑 claude code 或 cc switch 這類交互型 CLI 工具時我傾向于鎖定在一個固定 Profile避免因為 shell 環(huán)境不同導(dǎo)致 PATH 不一致裝好的工具換個 shell 就找不到。6.4 遠(yuǎn)程開發(fā)Remote-SSH場景下的終端坑如果你通過 Remote-SSH 連到一臺 Linux 服務(wù)器在本地 Windows 設(shè)置里配置defaultProfile.windows是管不到遠(yuǎn)程終端的。因為遠(yuǎn)程窗口加載的是遠(yuǎn)程機(jī)器上的設(shè)置。常見表現(xiàn)是本地已經(jīng)改成 Git Bash連上遠(yuǎn)程開發(fā)窗口后終端還是 bash。正確處理方式是在遠(yuǎn)程窗口中打開命令面板執(zhí)行Preferences: Open Remote Settings設(shè)置terminal.integrated.defaultProfile.linux或在遠(yuǎn)程工作區(qū)的.vscode/settings.json里寫入。如果出現(xiàn)正在使用 scp 將 VS Code Server 復(fù)制到主機(jī)后長時間卡住或提示無法下載 VS Code Serverfailed to fetch那是遠(yuǎn)程環(huán)境連接問題和默認(rèn)終端沒有直接關(guān)系。排查時需要分別檢查本地網(wǎng)絡(luò)、遠(yuǎn)程機(jī)器的外網(wǎng)連通性以及遠(yuǎn)程機(jī)器上是否有足夠權(quán)限寫入 VS Code Server 緩存目錄。評論區(qū)經(jīng)常把這類遠(yuǎn)程問題混在終端設(shè)置話題里問本質(zhì)上不是同一個問題。6.5 舊配置項 terminal.integrated.shell.windows 為什么不生效搜索如何修改 VS Code 默認(rèn)終端時還會看到大量舊博客教人配置terminal.integrated.shell.windows或shellArgs.windows。這兩個配置項在新版 VS Code 中已經(jīng)被棄用不再生效。在 1.60 版本之后終端配置全面遷移到 profiles 體系用terminal.integrated.profiles.windows加terminal.integrated.defaultProfile.windows替代。如果你正在使用 2023 年以后更新的 VS Code看到舊資料里的 shell 配置可以直接忽略。遷移時只需要把原來的 shell 路徑寫進(jìn) profiles 塊的path原 shellArgs 寫進(jìn)args數(shù)組即可。6.6 關(guān)于“把默認(rèn)終端開關(guān)用在系統(tǒng)文件關(guān)聯(lián)上”的提醒有些用戶看到默認(rèn)終端會聯(lián)想到雙擊 .bat 文件時用哪個終端打開。這兩者不是一回事。VS Code 集成終端的默認(rèn)配置只影響 VS Code 內(nèi)部的終端會話Windows 系統(tǒng)里雙擊 .bat 文件默認(rèn)使用的打開程序是由系統(tǒng)文件關(guān)聯(lián)控制的需要去設(shè)置 → 應(yīng)用 → 默認(rèn)應(yīng)用或右鍵 → 打開方式里自行選擇。在 VS Code 里把默認(rèn)終端改成 CMD 或 PowerShell并不會讓系統(tǒng)雙擊 .bat 的行為發(fā)生變化。這個邊界搞清楚能省掉很多不必要的嘗試。個人經(jīng)驗里最順手的一套做法是日常用命令面板選默認(rèn) Profile遇到特殊項目就補(bǔ)一個工作區(qū)級配置真正需要自定義啟動參數(shù)時才直接寫 settings.json。另外有個小技巧終端面板加號旁邊有個小箭頭下拉里會列出所有 Profile彈出的菜單里還掛著默認(rèn)配置文件的入口點進(jìn)去可以快速跳轉(zhuǎn)。最后提醒一句——改完配置記得關(guān)掉舊終端再重開不然很容易誤以為沒生效。