我一直覺得Chrome 控制臺Console是前端開發(fā)里最值得花時間摸透的工具。很多人對它的印象停留在“看報錯、點一下元素、跑兩行小腳本”但如果你把它當成一個完整的調(diào)試命令行來用會發(fā)現(xiàn)里面藏著一整套 API 和快捷命令從選擇元素、監(jiān)聽函數(shù)、查看事件綁定到性能計時和斷點設(shè)置幾乎能覆蓋日常排查的絕大部分需求。這篇文章可以當作一份通用版的 Console 命令速查文檔適合前端開發(fā)者、爬蟲調(diào)試人員以及對瀏覽器工具感興趣的產(chǎn)品和技術(shù)同學(xué)。我盡量把每條命令的用法、適用場景和容易踩的坑一起寫進去爭取讓新手看完能直接上手老手也能翻到一些平時沒注意到的細節(jié)。1. 打開控制臺之前先搞清 Console 對象與命令行 API 的關(guān)系1.1 三種打開方式和最容易被忽略的兩個設(shè)置打開控制臺這件事聽起來沒什么好講的但不同場景下效率差異很大。Windows 和 Linux 下可以用 CtrlShiftJ 直接進入 Console 面板macOS 上是 CommandOptionJ按 F12 打開開發(fā)者工具后再切到 Console 也完全沒問題。我個人習(xí)慣用快捷鍵直達因為調(diào)試時往往要反復(fù)切換 Elements、Sources、Network 面板每次都拿鼠標點一遍真的很浪費時間。進入控制臺之后有兩處設(shè)置建議根據(jù)場景調(diào)整。第一處是日志級別過濾Console 默認會把 Verbose詳細級別的日志折疊起來如果你想看console.debug()的輸出需要把日志級別切到 Verbose否則大概率會以為自己的打印語句沒生效。第二處是“Selected context only”如果你的頁面里有 iframe、擴展腳本或者 service worker 在輸出日志Consonle 會很吵勾選這個選項可以只看當前執(zhí)行上下文的內(nèi)容排查問題的時候干凈很多。1.2 Console 對象與命令行 API 的邊界這是很多人搞混的第一個點。console.log()、console.table()、console.time()這一系列屬于 Console API本質(zhì)是console對象上的方法寫在頁面代碼里一樣能執(zhí)行。而$_、$0、debug()、monitor()、copy()這些屬于命令行 API它們是 DevTools 注入到當前執(zhí)行環(huán)境里的工具函數(shù)只存在于控制臺交互上下文頁面腳本里訪問不到。理解這個區(qū)別很重要。比如你在控制臺里輸入$0能拿到 Elements 面板當前選中的元素但你不能把$0寫進項目代碼里上線之后ReferenceError直接砸臉。反過來console對象上的方法可以被代碼覆蓋和改寫而命令行 API 通常不太容易受頁面腳本影響。調(diào)試的時候遇到“為什么這個函數(shù)在頁面上沒定義、在控制臺里卻能執(zhí)行”這類問題十有八九就是觸到了這個邊界。另一個容易被忽略的點是控制臺本質(zhì)上是一個 REPL 環(huán)境你輸入的每一行都會先被 JavaScript 引擎執(zhí)行然后再把結(jié)果格式化輸出。所以像document.querySelector這種表達式會顯示函數(shù)源碼而如果直接輸入document控制臺會把整個文檔對象折疊成一個可點擊的樹形結(jié)構(gòu)。這個“先執(zhí)行、再格式化”的機制是所有控制臺命令行為的基礎(chǔ)后面的很多命令都是在這個邏輯上展開的。2. 高頻命令速查從 $_ 到 $0-$4再到 $() 與 $$()2.1 $_重復(fù)使用上一個計算結(jié)果$_是控制臺里非常實用的快捷變量它永遠保存著上一個表達式的執(zhí)行結(jié)果。比如你在控制臺輸入1 2回車后得到 3此時輸入$_ * 4控制臺會直接返回 12。在計算嵌套數(shù)據(jù)、臨時修改某個值時這個變量能省掉很多重復(fù)輸入的功夫。實際用的時候有幾個細節(jié)要注意。$_保存的是最近一次表達式的結(jié)果如果你中間執(zhí)行了某個返回undefined的語句$_就被覆蓋成undefined了。另外在監(jiān)聽器里用$_還可能踩到坑比如你先執(zhí)行了一個異步操作然后又去讀$_拿到的不一定是預(yù)期的中間值。所以我的習(xí)慣是$_適合臨時交互不適合寫多步驟腳本復(fù)雜的中間值老老實實賦給自定義變量更穩(wěn)。2.2 $0-$4直接引用 Elements 面板選中的元素$0到$4是一組歷史引用$0返回 Elements 面板里當前選中的元素$1返回上一次選中的元素依此類推總共保留最近五次選擇記錄。這個功能配合 Elements 面板使用堪稱神器先在頁面上右鍵“檢查”選中一個按鈕然后切到 Console 輸入$0.textContent馬上就能看到按鈕里的文案輸入$0.offsetParent能快速判斷它被哪個父級定位容器約束。我經(jīng)常用$0做“先選中、后操作”的調(diào)試流程。比如懷疑某個元素的樣式不對先在 Elements 里選中它再到 Console 里執(zhí)行$0.style.outline 2px solid red瞬間畫出邊框確認邊界。如果發(fā)現(xiàn)改錯了還能從$1、$2里找回之前選過的元素不需要跳回面板重新點選。唯一要注意的是這些引用只在當前 DevTools 會話內(nèi)有效刷新頁面之后引用鏈會清空$0會變成undefined。2.3 $() 與 $$()選擇器函數(shù)的便捷替代$()是document.querySelector()的簡寫$$()是document.querySelectorAll()的簡寫但$$()返回的是數(shù)組不是 NodeList所以可以直接用map()、filter()、forEach()這些數(shù)組方法。舉個例子我想快速拿到頁面里所有外鏈的域名輸入$$(a[href^http]).map(a new URL(a.href).hostname)回車之后立刻能看到去重的域名列表。這在爬蟲調(diào)試和頁面結(jié)構(gòu)分析場景里特別順手不需要打開一個臨時編輯器寫循環(huán)、再粘貼回控制臺執(zhí)行。這里有一個經(jīng)典沖突如果頁面本身引入了 jQuery$這個標識符會被 jQuery 占用控制臺里的$()可能就變成 jQuery 的選擇器了。遇到這種情況可以直接用document.querySelector()來兜底或者把函數(shù)重命名一下再使用比如const $ document.querySelector.bind(document)不過要注意在某些版本的 DevTools 里內(nèi)置$()和頁面全局$是會互相覆蓋的具體行為跟 DevTools 版本和頁面加載時機有關(guān)。我建議在團隊項目里統(tǒng)一約定調(diào)試時優(yōu)先用$$()和document.querySelector避免被頁面環(huán)境干擾。2.4 高頻命令速查小抄為了方便日常翻閱我匯總了一張速查表覆蓋本文后面會展開講的一部分核心命令命令作用示例$_引用上一個表達式的結(jié)果$_$0引用 Elements 面板當前選中的元素$0.style.color #f60$()querySelector的簡寫$(.nav).innerHTML$$()querySelectorAll的數(shù)組版簡寫$$(img).length$x()用 XPath 選擇元素$x(//div[classitem])copy()把內(nèi)容復(fù)制到剪貼板copy(document.title)clear()清空控制臺輸出clear()這里面$x()在 XPath 場景下很有用尤其是嵌套層級深的頁面結(jié)構(gòu)用 XPath 比 CSS 選擇器更靈活。但日常調(diào)試用 CSS 選擇器居多XPath 當成補充工具記住就可以了。3. console.* 家族從 log 到 table 的完整用法3.1 log、info、warn、error、debug 的分級輸出console.log()是最基礎(chǔ)的輸出方法但實際項目里我很少單獨用log。更合理的做法是讓不同類型的消息走不同的級別普通信息用console.info()警告用console.warn()錯誤用console.error()調(diào)試細節(jié)用console.debug()。這樣做的直接好處是控制臺自帶濾鏡可以把日志按級別過濾線上環(huán)境里warn和error會高亮顯示一眼就能抓到重點。你可能會問console.info()和console.log()的輸出樣式看起來幾乎一樣有必要區(qū)分嗎有。DevTools 的日志級別不僅僅影響顯示樣式還會影響性能監(jiān)控、錯誤上報工具的過濾邏輯。很多團隊的錯誤監(jiān)控腳本會自動捕獲console.error()的輸出如果你所有日志都一律用log后續(xù)想按級別篩數(shù)據(jù)就無從下手了。一個小坑console.debug()輸出在默認情況下是不顯示的必須把日志級別切到 Verbose 才能看到。如果你在調(diào)試時“明明寫了debug卻找不到輸出”先別查代碼檢查一下控制臺的日志級別下拉菜單很大概率就是被過濾掉了。3.2 格式化輸出與 %c 樣式魔法console.log()支持類似 C 語言的格式化占位符常用的有%s字符串、%d整數(shù)、%o對象可展開的 DOM 對象、%O對象普通 JS 對象。比如console.log(%s %d %s, 訂單編號, 1024, 已支付)這個寫法的優(yōu)勢在于打印結(jié)構(gòu)復(fù)雜的字符串時不需要做一堆變量拼接讀起來也干凈。不過我想重點說的是%c占位符它后面的字符串會被當成 CSS 樣式應(yīng)用到整條日志上console.log(%c訂單創(chuàng)建失敗, color: #fff; background: #e74c3c; padding: 4px 8px; border-radius: 4px; font-size: 14px;)這條日志打印出來是白字紅底的徽章樣式在大量日志輸出里極其醒目。我在團隊的調(diào)試規(guī)范里推薦過這種做法錯誤統(tǒng)一用紅底白字%c前綴警告用黃底黑字普通日志不加樣式。配合日志級別過濾基本上不用盯著屏幕找半天。3.3 console.table 與 console.dir從對象到表格console.table()是我最常用的輸出工具之一。當你有一組結(jié)構(gòu)相似的對象時用table打印出來是一個可排序的表格視覺上比一堆折起來的大對象清晰太多。比如console.table([ { name: 張三, age: 24, city: 上海 }, { name: 李四, age: 30, city: 北京 } ])如果對象里有大量不需要展示的字段還可以傳第二個參數(shù)指定列console.table(list, [name, age])console.dir()則是把對象以樹形結(jié)構(gòu)展開顯示。最常見的用法是打印 DOM 元素console.log(document.body)顯示的是 HTML 標簽結(jié)構(gòu)而console.dir(document.body)顯示的是這個元素的屬性和方法列表包括clientWidth、scrollHeight、dataset這些你需要的信息。想快速了解一個 DOM 節(jié)點有什么屬性時dir遠比log好用。3.4 計時、分組、計數(shù)、斷言與堆棧這幾個方法比較“小而美”但每個都有明確的使用場景。console.time()和console.timeEnd()是一對計時器括號里的標簽是同一個字符串時才會正確結(jié)束并打印耗時。比如console.time(數(shù)組排序耗時) arr.sort() console.timeEnd(數(shù)組排序耗時)要注意time和timeEnd的標簽必須完全一致拼寫錯一點就會得到一條警告信息而無法正常輸出。標簽重復(fù)使用時timeEnd會結(jié)束上一次未結(jié)束的同名計時器所以嵌套場景下盡量用語義化標簽。console.count()用來統(tǒng)計同一段代碼的執(zhí)行次數(shù)適合確認事件回調(diào)有沒有觸發(fā)、觸發(fā)了多少次。配合countReset()可以清零重新計數(shù)。console.group()和console.groupEnd()可以把一組日志折疊起來。業(yè)務(wù)邏輯比較復(fù)雜時把不同模塊的輸出歸組控制臺會清爽很多。groupCollapsed()則是默認折疊的版本想看細節(jié)再點展開大型項目里實測很好用。console.assert()會在條件為假時打印一條錯誤日志相當于“斷言”。我調(diào)試接口數(shù)據(jù)時經(jīng)常用它console.assert(user.age 18, 用戶年齡必須大于18當前值, user.age)條件滿足時什么都不打印條件不滿足時直接紅字報錯寫臨時校驗邏輯很方便。最后是console.trace()它會在控制臺打印當前的調(diào)用堆棧。排查“這個函數(shù)到底是被誰調(diào)進來的”這類問題時在可疑函數(shù)里加一行console.trace()就能看到完整的調(diào)用鏈路不用去 Sources 面板手動打斷點。4. 命令行 API 里容易被人忽略的老牌工具debug、monitor、getEventListeners4.1 debug 與 monitor給第三方函數(shù)“插樁”debug()命令可以在指定函數(shù)上自動設(shè)置一個斷點函數(shù)執(zhí)行時就會停在入口處。用法是傳入函數(shù)本身或函數(shù)名比如debug(fetch)這樣頁面任何代碼調(diào)用fetch時都會在fetch入口斷住你可以在 Sources 面板里一步步看參數(shù)、走邏輯。不想繼續(xù)就執(zhí)行undebug(fetch)移除斷點。這個功能最妙的地方在于不管目標函數(shù)是你自己寫的還是第三方庫里的只要能在全局作用域訪問到就能直接插樁。我曾經(jīng)用debug(HTMLElement.prototype.click)來排查一個“明明調(diào)用了 click 卻沒有觸發(fā)點擊事件”的問題斷住之后直接看到調(diào)用方傳進來的上下文問題根源立刻就清楚了。monitor()和debug()類似但它是打印函數(shù)的每次調(diào)用參數(shù)和返回值而不是中斷執(zhí)行monitor(document.querySelector)之后每執(zhí)行一次document.querySelector(...)控制臺就會輸出一條記錄包含參數(shù)和返回結(jié)果。這種監(jiān)聽方式對確認“某個函數(shù)有沒有被調(diào)用、被調(diào)用了幾次、每次都傳了什么”非常有幫助尤其適合定位“某個接口被無限重復(fù)請求”這類性能問題。用unmonitor()取消監(jiān)聽。4.2 getEventListeners查看元素綁了哪些事件getEventListeners()返回指定元素上注冊的所有事件監(jiān)聽器對象。比如選中一個按鈕后getEventListeners($0)輸出結(jié)果會按事件類型分組click字段下的數(shù)組里就是該事件注冊的所有處理函數(shù)。每個監(jiān)聽器對象里還能看到useCapture、passive等屬性排查事件是冒泡觸發(fā)還是捕獲觸發(fā)時非常直觀。這個命令的典型使用場景是“頁面有個按鈕點了沒反應(yīng)”。很多新人會直接去代碼里搜addEventListener但如果你用的是第三方組件庫事件綁定可能發(fā)生在庫的內(nèi)部搜半天搜不到。直接在控制臺getEventListeners($0).click看一下數(shù)組里到底有幾個處理函數(shù)每個函數(shù)的源碼是什么一下子就鎖定了范圍。如果監(jiān)聽器返回空對象說明這個元素根本沒有綁定對應(yīng)事件問題很可能出在事件委托或者別的元素上排查方向立刻就能調(diào)整。4.3 keys、values、copy、inspect、clear輔助操作一把梭keys()和values()分別返回對象的所有鍵名和鍵值數(shù)組。它們看起來和Object.keys()重復(fù)但妙處在于可以用在任意控制臺表達式上配合$_使用非常流暢const obj { name: test, level: 2 } keys(obj) values(obj)copy()會把內(nèi)容復(fù)制到系統(tǒng)剪貼板這個命令我要單獨夸一下。平時想把接口返回的大 JSON 復(fù)制到編輯器里手動選中復(fù)制不僅費勁還可能漏掉縮進。直接copy(JSON.stringify(data, null, 2))然后去編輯器里粘貼格式完整、絕不丟內(nèi)容。配合fetch在控制臺里先獲取接口數(shù)據(jù)再用copy導(dǎo)出來整個鏈路不到五秒鐘。inspect()會跳轉(zhuǎn)到 Elements 面板并選中傳入的 DOM 元素。比如從一堆匹配div中篩選出第一個想看看它在頁面上的實際位置inspect($(div))clear()清空控制臺輸出。需要注意它和console.clear()的區(qū)別console.clear()是 Console API可以在代碼里調(diào)用clear()是命令行 API只能在控制臺交互里執(zhí)行。兩者效果一樣但頁面代碼里沒有clear()這個函數(shù)用錯了會報錯。5. 幾個真實的調(diào)試場景從找事件到查性能瓶頸5.1 場景按鈕點擊沒反應(yīng)先查監(jiān)聽器再決定是否打斷點有次接到一個反饋說頁面上某個“提交訂單”按鈕點擊沒有任何反應(yīng)。這種問題大多數(shù)時候不是按鈕沒綁定事件而是事件綁定了但執(zhí)行出錯或者被某個外層元素攔截了。我的排查鏈路是先在 Elements 面板選中按鈕切到 Console 執(zhí)行g(shù)etEventListeners($0)如果click數(shù)組是空的說明按鈕自身沒有綁定事件可能事件在父級委托或者按鈕被一層遮罩蓋住、壓根點不到。如果click數(shù)組里有多個處理函數(shù)逐個看函數(shù)源碼找到可疑的那一個然后debug($0.__clickHandler)這樣我就能在點擊按鈕時停在對應(yīng)函數(shù)入口按步執(zhí)行看哪一行拋異常。整套流程下來從發(fā)現(xiàn)問題到鎖定根因通常不會超過三分鐘。5.2 場景用一個函數(shù)找出頁面里的重復(fù)事件綁定有次排查一個性能問題發(fā)現(xiàn)某個列表項的點擊事件執(zhí)行次數(shù)成倍增長懷疑是事件被重復(fù)綁定了。直接在控制臺里寫一個小函數(shù)遍歷關(guān)鍵節(jié)點$$(.list-item).map(item ({ text: item.textContent.slice(0, 10), listeners: getEventListeners(item).click?.length || 0 }))$$()拿到所有列表項getEventListeners()統(tǒng)計每個項綁定的 click 監(jiān)聽器數(shù)量。輸出的表格一眼就能看出哪些項綁定了多個監(jiān)聽器順著那段代碼去找重復(fù)綁定的地方就非?？炝?。這種組合拳是控制臺命令的真正價值單個命令只能幫你做一件事組合起來能幫你快速做結(jié)構(gòu)化排查。5.3 場景監(jiān)控異步函數(shù)的調(diào)用頻率和參數(shù)另一個常見需求是“某個接口好像被頻繁調(diào)用每次參數(shù)都不一樣”。直接打斷點太煩因為接口每秒可能調(diào)用幾十次。這時候monitor()就派上用場了monitor(fetch)然后什么都不用做正常操作頁面控制臺會持續(xù)輸出每次fetch的調(diào)用參數(shù)和返回值。打開控制臺觀察輸出頻率馬上就能判斷接口是不是在循環(huán)里被調(diào)用。如果是某個特定函數(shù)導(dǎo)致的可以換成monitor(axios.post)或者直接監(jiān)聽自定義業(yè)務(wù)函數(shù)。這種方法不侵入代碼、不打斷運行流程非常適合線上環(huán)境的即時排查。5.4 場景計算一段渲染邏輯的實際耗時性能優(yōu)化時console.time()是最直接的計時手段。但要注意在控制臺里使用它和在代碼里使用有一點區(qū)別控制臺本身是異步執(zhí)行的可能無法捕捉到瀏覽器渲染管線之后的完整時間。如果需要更精確的數(shù)據(jù)建議配合performance.now()const start performance.now() // 在控制臺手動觸發(fā)一段邏輯 console.log(耗時, performance.now() - start, ms)這種原始的時間戳方式更適合控制臺交互場景因為它不依賴console.time()內(nèi)部的事件循環(huán)機制結(jié)果更可靠。特別是在對比“兩種寫法哪種更快”的時候直接在控制臺跑幾輪、算平均值效果比憑感覺判斷好得多。6. 團隊項目里關(guān)于 console 的幾個實踐問題6.1 把 console.log 從臨時工具變成團隊規(guī)范很多項目里的console.log是臨時調(diào)試隨手寫的上線時要么忘記刪要么全刪掉下一次排查問題時又到處亂加。我見過比較成熟的團隊會定一套簡單的打印規(guī)范業(yè)務(wù)入口和出口用console.info異常用console.error性能耗時統(tǒng)一用performance的標記然后配合console.group把同一模塊的日志歸組。這樣開發(fā)環(huán)境和線上排查都舒服很多。另外我強烈建議在團隊調(diào)試規(guī)范里引入%c樣式前綴。比如所有組件庫內(nèi)部調(diào)試日志統(tǒng)一用藍色前綴[Lib]業(yè)務(wù)日志用綠色前綴[Biz]錯誤日志用紅底白字。這樣混合輸出的時候掃一眼顏色就能判斷日志屬于哪個體系不用每條都展開看。成本極低收益非常直接。6.2 生產(chǎn)環(huán)境還能不能留著 console 輸出這是團隊項目里繞不開的問題。我的觀點是不是所有console都要刪而是要看輸出的內(nèi)容是否涉及敏感數(shù)據(jù)。像接口請求參數(shù)、用戶信息、內(nèi)部錯誤對象這些在任何環(huán)境下都不應(yīng)該打印。對于無害的結(jié)構(gòu)化日志如果開發(fā)環(huán)境已經(jīng)夠用線上可以保留但要控制級別和數(shù)量避免日志量大到影響性能。如果公司項目里希望構(gòu)建產(chǎn)物完全去掉console可以借助構(gòu)建工具的配置。比如在打包壓縮階段把 console 相關(guān)語句移除配置思路是按環(huán)境區(qū)分只有生產(chǎn)環(huán)境才開啟移除。需要注意移除console不僅僅是刪幾行代碼的問題如果代碼里存在依賴console返回值或者把console傳給其他函數(shù)的寫法暴力移除可能導(dǎo)致運行時報錯。所以在做全局清理前先檢索一下項目里的console用法確認都是獨立調(diào)用再去配置清理規(guī)則。6.3 用控制臺給前端函數(shù)做“單測”和渲染驗證最后分享一個日常工作里的小玩法在控制臺里臨時粘貼一個函數(shù)定義然后立刻調(diào)用驗證。比如我急著確認某個時間格式化函數(shù)在不同邊界下是否正常function formatTime(t) { return t 10 ? 0 t : String(t) } [0, 5, 9, 10, 23].map(formatTime)控制臺直接輸出結(jié)果比反復(fù)刷新頁面、點擊操作要快得多。如果驗證的是組件渲染邏輯可以先在控制臺改一個元素的關(guān)鍵樣式或文本再決定是不是要落代碼。這種“用小函數(shù)快速驗證邏輯、再遷移到項目里”的做法能明顯減少提交代碼后發(fā)現(xiàn)低級 bug 的頻率?？刂婆_本質(zhì)上是瀏覽器自帶的一個 JavaScript 運行時用來做臨時實驗、邊界值測試、數(shù)據(jù)篩選體驗完全不輸給本地寫腳本跑一遍。