VS Code調試配置藏了3個參數，90%開發者只會用1個

Python調試器的配置界面像個俄羅斯套娃——你以為點幾下就能跑，真到排查線上bug時才發現，launch.json里藏著一堆沒人教過的開關。Medium作者Anurag Chatterjee最近扒了一遍VS Code的調試配置，發現大部分人只填了name和program就交差，剩下的參數全靠運氣。

這種"半吊子配置"的后果很具體：環境變量沒加載導致本地能跑、測試機崩掉；工作目錄設錯讓相對路徑全亂；甚至調試終端和運行終端不是同一個，斷點死活進不去。Chatterjee的文章里列了5個核心參數，但真正讓人意外的是，這些參數的組合方式直接決定了AI生成代碼的可調試性——而AI寫代碼的速度正在指數級增長。

launch.json的隱藏語法：不是填表是編程

VS Code的調試配置本質上是一份聲明式腳本，只是披了JSON的皮。Chatterjee給出的示例配置長這樣：

"name": "Python: Debug FastAPI app",

"program": "${workspaceFolder}/app.py",

"console": "integratedTerminal",

"cwd": "${workspaceFolder}",

"envFile": "${workspaceFolder}/.env"

五個字段分工明確。name是你在調試面板看到的標簽，支持中文但建議用英文——團隊協作時中文亂碼的坑誰踩過誰知道。program指向入口文件，${workspaceFolder}是VS Code內置變量，代表當前打開的根目錄，硬編碼絕對路徑的配置文件注定進不了git。

console參數容易被忽略，它決定調試輸出的落點。integratedTerminal把調試會話綁死在VS Code內置終端，externalTerminal會喚起系統終端，而internalConsole是個沒有交互能力的輸出窗口。選錯的結果：你的input()語句在內置終端里卡成雕塑，或者需要看環境變量時找不到shell。

cwd和envFile：本地能跑的秘密

cwd（Current Working Directory）是很多bug的源頭。Python的相對路徑解析以cwd為錨點，不是以program所在目錄為錨點。如果你的項目結構是src/app.py和data/config.json，而launch.json放在.vscode里，不設置cwd的話，app.py里寫open("data/config.json")會直接報錯——因為cwd默認是.vscode的父目錄，也就是項目根目錄，但程序以為自己在src里。

envFile參數解決的是"環境變量去哪兒了"的永恒困惑。開發者的.env文件通常放在項目根目錄，里面塞滿數據庫密碼和API密鑰。launch.json里不寫這一行，調試時os.environ.get("DB_URL")返回None，你盯著代碼看半小時才發現是配置沒加載。Chatterjee特別強調：這個參數支持路徑變量，${workspaceFolder}/.env是標準寫法，但也有人習慣把環境配置按環境拆分，寫成.env.dev或.env.local。

AI寫代碼時代，調試配置變成基礎設施

Chatterjee在文章末尾提了一個正在發生的轉變：AI生成代碼的比例越高，調試能力就越重要。生成的代碼可能語法正確、邏輯自洽，但在特定環境下行為異常——比如假設了某個環境變量存在，或者隱式依賴了執行目錄的結構。這時候launch.json不再是"讓調試器跑起來"的工具，而是定義代碼運行環境的契約。

他的判斷很直接：以前調試配置是個人偏好，現在變成團隊資產。把launch.json提交到git倉庫，意味著所有成員用同一套環境假設排查問題。反過來，gitignore掉這個文件，等于默許"在我機器上能跑"的災難重復發生。

VS Code的調試配置文檔有超過50個可選參數，Chatterjee只覆蓋了最基礎的5個。但光是這5個的正確組合，就能過濾掉大部分"環境相關"的詭異bug。你的項目里，launch.json上次更新是什么時候？