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