改一行代碼，崩了三個(gè)模塊——這種事兒在祖?zhèn)鞔a庫(kù)里太常見了。問題往往不是代碼本身多爛，而是你根本不知道誰(shuí)在偷偷調(diào)用它。重構(gòu)前的第一步，永遠(yuǎn)是先畫一張依賴地圖。但這事兒手工做太費(fèi)人，AI能加速，也有它搞不定的死角。

靜態(tài)分析是最靠譜的起點(diǎn)。Python有內(nèi)置的ast模塊，能遍歷任何.py文件，把import語(yǔ)句全抽出來。一段幾十行的腳本就能跑遍整個(gè)代碼庫(kù)，生成"文件A引入了模塊B、C、D"這樣的基礎(chǔ)圖譜。JavaScript和TypeScript也有ESLint插件、madge這類工具做同樣的事。這層信息最淺，但也最穩(wěn)——機(jī)器不會(huì)騙你。

但import圖譜只告訴你模塊之間的"血緣關(guān)系"，不告訴你具體誰(shuí)調(diào)了誰(shuí)。模塊A引入了模塊B，但A里的哪個(gè)函數(shù)調(diào)了B的哪個(gè)函數(shù)？傳了什么參數(shù)？返回值怎么用？這些才是重構(gòu)時(shí)真正會(huì)踩雷的地方。

這里AI能派上用場(chǎng)。把兩個(gè)相關(guān)模塊的代碼丟給AI，讓它逐函數(shù)分析調(diào)用關(guān)系：調(diào)用方是誰(shuí)、被調(diào)用方是誰(shuí)、參數(shù)列表、返回值流向，甚至間接調(diào)用（比如通過變量或動(dòng)態(tài)分發(fā)）也要標(biāo)出來。這比人肉讀代碼快得多，尤其是當(dāng)你面對(duì)幾千行毫無注釋的"遺產(chǎn)"時(shí)。

不過AI的產(chǎn)出得打問號(hào)。它可能漏掉動(dòng)態(tài)調(diào)用，可能把同名函數(shù)搞混，可能在復(fù)雜的繼承鏈上斷片。你的prompt越具體，結(jié)果越可用；但再精細(xì)的prompt也替代不了人工抽查。把AI的輸出當(dāng)草稿，挑幾個(gè)關(guān)鍵調(diào)用鏈?zhǔn)止ず蓑?yàn)，是現(xiàn)階段最務(wù)實(shí)的做法。

依賴地圖的價(jià)值隨深度遞增：模塊級(jí)→函數(shù)級(jí)→數(shù)據(jù)流級(jí)。靜態(tài)工具搞定第一層，AI輔助第二層，第三層目前還得人機(jī)協(xié)作。別指望一鍵生成完美地圖，但用對(duì)工具組合，能把"不敢改"變成"改得明白"。