在IDE里折騰“Scratches and Consoles”這個(gè)功能最初我以為是給臨時(shí)筆記用的直到某次需要反復(fù)調(diào)試一個(gè)批處理腳本又不想在文件資源管理器和命令行窗口之間來(lái)回切換才認(rèn)真把這條鏈路完整跑了一遍。這個(gè)組合的實(shí)際價(jià)值遠(yuǎn)超它的名字它把“臨時(shí)文件存儲(chǔ)”和“命令執(zhí)行”兩件事無(wú)縫銜接在一起尤其適合Windows環(huán)境下日常維護(hù)、構(gòu)建輔助、數(shù)據(jù)整理這類(lèi)高頻、短小、需要反復(fù)改動(dòng)的自動(dòng)化腳本。如果你和曾經(jīng)的我一樣對(duì)IDE的印象還停留在“寫(xiě)代碼、跑測(cè)試、看報(bào)錯(cuò)”那這篇內(nèi)容能幫你打開(kāi)一個(gè)很順手的工作流。不需要安裝任何額外插件不需要切出IDE窗口只要三步把bat文件扔進(jìn)Scratches區(qū)把編碼和終端準(zhǔn)備好點(diǎn)一下運(yùn)行。整條操作鏈吃透之后你會(huì)發(fā)現(xiàn)手邊那些零零碎碎的批處理任務(wù)都變得清爽起來(lái)。1. 項(xiàng)目核心Scratches與批處理的天然契合點(diǎn)先拆一下這個(gè)標(biāo)題里最關(guān)鍵的詞——Scratches and Consoles。在主流IDE以IntelliJ家族為例里這一項(xiàng)常駐在左側(cè)工具窗的最底部看著像個(gè)不起眼的入口實(shí)際包含兩種不同性質(zhì)的能力Scratch Files臨時(shí)文件和Scratch Consoles臨時(shí)命令行交互頁(yè)。前者用于快速創(chuàng)建任意類(lèi)型的零散文件后者用于直接敲代碼片段、連接數(shù)據(jù)庫(kù)或執(zhí)行外部命令。而“IDE執(zhí)行bat文件”這半句點(diǎn)明的是一個(gè)具體操作場(chǎng)景Windows批處理腳本在IDE內(nèi)部直接運(yùn)行不借道外部CMD窗口。這兩個(gè)東西為什么會(huì)契合核心原因有三個(gè)第一批處理腳本本質(zhì)上是“短邏輯、高頻改”。它不像大型工程那樣需要長(zhǎng)期維護(hù)但經(jīng)常要針對(duì)不同路徑、不同參數(shù)調(diào)整內(nèi)容。Scratches恰好是不參與項(xiàng)目編譯、不污染版本庫(kù)的臨時(shí)區(qū)域腳本往里一放改完就跑跑完就丟心理負(fù)擔(dān)極小。第二IDE的控制臺(tái)輸出比CMD黑窗口強(qiáng)大得多。批處理命令在外部窗口中一旦滾動(dòng)起來(lái)想回看上一條輸出只能靠拖拽滾動(dòng)條。而在控制臺(tái)里字體、編碼、背景色全部可控錯(cuò)誤信息可以配置高亮甚至能直接在輸出區(qū)點(diǎn)擊文件路徑跳轉(zhuǎn)。對(duì)調(diào)試腳本的人來(lái)說(shuō)這一點(diǎn)體驗(yàn)提升是質(zhì)的。第三Scratches天然支持“多語(yǔ)言混跑”。有時(shí)候我們會(huì)寫(xiě)一個(gè)bat去調(diào)起Java程序或者用Python腳本去處理日志再交給bat繼續(xù)拷貝——這些跨語(yǔ)言協(xié)作如果放在項(xiàng)目管理器里會(huì)顯得結(jié)構(gòu)支離破碎但放在Scratches區(qū)就非常自然左邊存bat右邊存py控制臺(tái)統(tǒng)一輸出。所以這個(gè)項(xiàng)目表面上是“IDE里跑批處理”這么一件小事背后其實(shí)是圍繞“低摩擦操作”設(shè)計(jì)的一整套使用習(xí)慣。它的潛在需求非常明確把日常機(jī)械化、碎片化的系統(tǒng)操作收斂到一個(gè)已經(jīng)打開(kāi)了一整天的IDE環(huán)境里省掉窗口切換減少上下文斷裂。2. 實(shí)操前提創(chuàng)建Scratch文件并理解存儲(chǔ)機(jī)制很多人用了很久IDE也不知道Scratch文件存在哪里其實(shí)它的存儲(chǔ)機(jī)制分兩層對(duì)用戶(hù)不可見(jiàn)的是IDE的系統(tǒng)目錄下有一個(gè)虛擬空間它不屬于任何項(xiàng)目也不受項(xiàng)目目錄結(jié)構(gòu)約束可見(jiàn)操作上IDE會(huì)為你生成一個(gè)友好的樹(shù)形入口。2.1 創(chuàng)建入口菜單、快捷鍵、右鍵菜單三種姿勢(shì)新建Scratch文件有幾種途徑取決于你已經(jīng)打開(kāi)了什么其一通過(guò)頂部主菜單。在File \ New \ Scratch File里選擇語(yǔ)言類(lèi)型。這一步選類(lèi)型不等于綁定死文件擴(kuò)展名只是為IDE確定語(yǔ)法高亮和運(yùn)行方式。其二在Project工具窗中找到Scratches and Consoles節(jié)點(diǎn)右鍵新建Scratch File并在語(yǔ)言列表中選擇Bash、TXT或其他接近的類(lèi)型。注意這里有一個(gè)細(xì)節(jié)如果選擇BashIDE會(huì)把你視為在類(lèi)Unix環(huán)境或Git Bash環(huán)境下運(yùn)行如果選擇DOS/Windows Batch部分版本叫Windows Batch則會(huì)給予批處理語(yǔ)言的高亮和運(yùn)行入口。如果你的IDE版本列表里沒(méi)有Batch通常選TXT也能湊合只是缺少關(guān)鍵詞高亮。其三快捷鍵。在Windows/Linux上是CtrlAltShiftInsert在macOS上是CmdShiftInsert。直接彈出語(yǔ)言選擇器一步到位。2.2 Scratch文件存儲(chǔ)位置的底層邏輯Scratches的物理存儲(chǔ)路徑與“版本庫(kù)”無(wú)關(guān)。它們一般存放在IDE的配置目錄下常見(jiàn)的路徑模式是WindowsC:\\Users\\用戶(hù)名\\AppData\\Roaming\\JetBrains\\IDE版本\\scratchesmacOS~/Library/Application Support/JetBrains/IDE版本/scratches個(gè)人不推薦手動(dòng)去翻這些路徑因?yàn)镾cratch的價(jià)值恰恰在于“虛擬化”。它由IDE統(tǒng)一管理不跟隨項(xiàng)目的版本控制也不會(huì)因?yàn)轫?xiàng)目文件夾移動(dòng)而受影響。但了解這些路徑有實(shí)際意義當(dāng)你重裝IDE、遷移環(huán)境時(shí)把scratches目錄一起拷走就能把所有臨時(shí)腳印完整搬去新環(huán)境。我在一次環(huán)境重建時(shí)就用過(guò)這個(gè)辦法省去了重新敲十幾個(gè)小腳本的功夫。2.3 把bat文件“帶進(jìn)”Scratches的兩種策略這里要做一個(gè)重要區(qū)分新建一個(gè)bat文件和引用已有bat文件操作方式完全不同。新建簡(jiǎn)單按前述方式新建Scratch File后綴名手動(dòng)改成.bat或者直接在語(yǔ)言選擇器里選BatchIDE會(huì)識(shí)別并應(yīng)用腳本語(yǔ)義。引用已有的bat文件時(shí)建議不要用“復(fù)制粘貼內(nèi)容到新Scratch”這種方式。短腳本復(fù)制沒(méi)問(wèn)題長(zhǎng)腳本一旦涉及相對(duì)路徑、注釋編碼粘貼時(shí)會(huì)引入莫名其妙的亂碼和換行符坑。更穩(wěn)的辦法是直接在Scratch文件里書(shū)寫(xiě)一個(gè)“調(diào)用器”內(nèi)容只有一行call D:\\scripts\\build_utils\\deploy.bat然后用本文后面講到的執(zhí)行方式去運(yùn)行這個(gè)調(diào)用器。這樣既保留了源腳本的原始位置又享受了Scratch的統(tǒng)一入口。這是我在日常使用時(shí)收獲最大的一條經(jīng)驗(yàn)Scratch負(fù)責(zé)指揮真實(shí)腳本負(fù)責(zé)干活。2.4 文件類(lèi)型選擇對(duì)后續(xù)運(yùn)行的影響Scratch文件類(lèi)型的選擇直接影響運(yùn)行菜單。IDE會(huì)根據(jù)文件類(lèi)型動(dòng)態(tài)調(diào)整運(yùn)行按鈕的可用性如果文件是Java類(lèi)型運(yùn)行菜單就讓你顯式指定main方法和VM參數(shù)如果是Bash類(lèi)型就提供Bash解釋器配置如果是純TXT則根本沒(méi)有運(yùn)行入口。所以想在IDE里運(yùn)行bat文件有兩種可配置路線(xiàn)直接把Scratch文件類(lèi)型設(shè)為DOS/Windows Batch簡(jiǎn)單直觀IDE直接為腳本提供運(yùn)行入口把bat寫(xiě)成*.cmd并在類(lèi)型中識(shí)別為Batch效果基本一致。有些開(kāi)發(fā)者習(xí)慣把bat內(nèi)容放到Bash類(lèi)型的Scratch里再用cmd.exe /c去執(zhí)行這倒不是不行但失去了本機(jī)Windows批處理的高亮和單步調(diào)試體驗(yàn)?zāi)撤N程度是繞遠(yuǎn)路。建議按第一種方案來(lái)。3. 執(zhí)行真鏈路IDE里運(yùn)行bat文件的完整解法新建好Scratch文件并把bat內(nèi)容放進(jìn)去后接下來(lái)的核心就是執(zhí)行了。這個(gè)環(huán)節(jié)涉及IDE如何映射系統(tǒng)命令、如何設(shè)置工作目錄、如何傳遞參數(shù)以及最關(guān)鍵的編碼處理。3.1 前置準(zhǔn)備確認(rèn)操作系統(tǒng)與終端語(yǔ)義IDE執(zhí)行bat文件本質(zhì)上是在操作系統(tǒng)層面喚起一個(gè)進(jìn)程來(lái)跑腳本。在Windows上這個(gè)進(jìn)程通常是cmd.exe。IDE在運(yùn)行配置中需要知道三件事解釋器路徑、腳本路徑、工作目錄。解釋器路徑一般默認(rèn)為cmd.exeIDE能自動(dòng)探測(cè)到Windows命令行解釋器所在位置幾乎不用手動(dòng)填。腳本路徑是Scratch文件的虛擬路徑在控制臺(tái)運(yùn)行配置里自動(dòng)帶出。工作目錄則是個(gè)非常容易被忽視的變量它決定腳本內(nèi)所有相對(duì)路徑的起點(diǎn)。假設(shè)bat腳本里寫(xiě)的是copy file.txt D:\\backup\\而file.txt的實(shí)際位置是腳本所在路徑那么工作目錄就必須指向腳本所在目錄否則會(huì)在運(yùn)行時(shí)報(bào)找不到文件的錯(cuò)。3.2 首次運(yùn)行敲擊運(yùn)行按鈕前需要核對(duì)的三處配置右鍵Scratch文件選擇RunIDE會(huì)彈出運(yùn)行配置編輯窗。第一次運(yùn)行時(shí)建議先不要一頓操作猛如虎先核對(duì)這三項(xiàng)Interpreter確保是cmd.exe或C:\\Windows\\System32\\cmd.exeWorking directory如果不想在腳本里到處寫(xiě)絕對(duì)路徑就先把工作目錄設(shè)為腳本預(yù)期目錄Environment variables如腳本依賴(lài)某些自定義環(huán)境變量比如JAVA_HOME、PATH追加項(xiàng)在這個(gè)面板里補(bǔ)齊而不是依賴(lài)臨時(shí)性的shell狀態(tài)。這些配置雖然可以隨時(shí)改但初次核對(duì)能避免大量“為什么腳本在外部CMD跑得正常、在IDE里卻報(bào)錯(cuò)”的無(wú)效排查。3.3 正確書(shū)寫(xiě)bat在Scratch中避免額外的解釋器歧義在Scratch文件里寫(xiě)bat時(shí)要克制使用.sh或Bash語(yǔ)法。很多人上手后習(xí)慣性寫(xiě)#!/bin/bash或export這和批處理沖突。IDE雖然在Syntax Highlight上不會(huì)阻止你但執(zhí)行階段會(huì)直接拋錯(cuò)。批處理在Scratch里的正確書(shū)寫(xiě)與其他文本編輯器無(wú)差以echo off開(kāi)頭逐行執(zhí)行命令。但有一個(gè)小技巧因?yàn)镾cratch不強(qiáng)制規(guī)定文件擴(kuò)展名IDE在運(yùn)行時(shí)會(huì)對(duì)腳本內(nèi)容做一次隱式解釋修正。如果文件名結(jié)尾為.bat解釋器定在cmd.exe按原樣執(zhí)行如果文件名是純文本后綴解釋器可能識(shí)別為其他Shell。建議在創(chuàng)建Scratch文件時(shí)把文件名后綴明確寫(xiě)成.bat。3.4 參數(shù)傳遞的細(xì)節(jié)語(yǔ)義bat腳本往往需要接收外部參數(shù)。在IDE的運(yùn)行配置里Script parameters一欄就是干這個(gè)的。但這里有個(gè)特別容易踩的坑IDE會(huì)把你填的參數(shù)原樣拼接到命令尾部不會(huì)自動(dòng)加引號(hào)。如果腳本參數(shù)里含有空格路徑必須在配置里手動(dòng)加上雙引號(hào)。舉個(gè)例子假設(shè)腳本要求傳遞一個(gè)文件路徑參數(shù)C:\\Program Files\\SomeTool\\tool.exe你直接填進(jìn)參數(shù)欄cmd解析時(shí)會(huì)把C:\\Program當(dāng)成參數(shù)1、Files\\SomeTool\\tool.exe當(dāng)成參數(shù)2腳本的處理邏輯瞬間錯(cuò)亂。正確寫(xiě)法是在配置中填C:\\Program Files\\SomeTool\\tool.exe。3.5 通過(guò)外部工具方式執(zhí)行bat備選方案除了直接在Scratch文件上點(diǎn)RunIDE還支持通過(guò)Settings \ Tools \ External Tools配置一個(gè)外部工具把bat文件執(zhí)行定義為一個(gè)IDE全局菜單項(xiàng)。這個(gè)方案的優(yōu)勢(shì)是可以給它綁定快捷鍵并在任何項(xiàng)目環(huán)境下快速喚起。配置外部工具時(shí)Program填cmd.exeArguments填/c $FilePath$Working directory填$FileDir$$。這里$FilePath$和$FileDir$是IDE的宏變量會(huì)自動(dòng)替換為當(dāng)前文件的路徑和目錄。Scratch文件配合外部工具方案尤其好用因?yàn)镾cratch不依賴(lài)具體項(xiàng)目你可以在任何項(xiàng)目窗口里用同一套快捷鍵跑同一套腳本真正做到“一次配置全局復(fù)用”。3.6 控制臺(tái)查看輸出編碼問(wèn)題從這里分水嶺bat腳本跑起來(lái)后IDE底部會(huì)彈出Run工具窗口輸出流、錯(cuò)誤流、時(shí)間戳一應(yīng)俱全。看見(jiàn)輸出不是終點(diǎn)關(guān)鍵在于輸出是否可讀。這就回到了繞不開(kāi)的編碼問(wèn)題。Windows原生的cmd輸出默認(rèn)使用系統(tǒng)活動(dòng)代碼頁(yè)中文環(huán)境下通常為GBKcp936而IDE的控制臺(tái)默認(rèn)讀取UTF-8。這兩者不匹配時(shí)腳本里echo 中文會(huì)變成一堆亂碼java -version的提示信息也可能歪七扭八。解決辦法有兩個(gè)層面一是修改IDE控制臺(tái)編碼。在運(yùn)行配置的VM options或Environment variables中設(shè)置JAVA_TOOL_OPTIONS-Dfile.encodingGBK或者在Settings \ Editor \ File Encodings中把Console的默認(rèn)編碼臨時(shí)改成GBK。這種方式適合只解決眼前腳本的情況。二是從批處理內(nèi)部統(tǒng)一字符集。在腳本首行加一句echo off chcp 65001 nulchcp 65001將活動(dòng)代碼頁(yè)切換為UTF-8。這樣不僅IDE控制臺(tái)能正確顯示中文也兼顧腳本輸出的可移植性。我自己更推薦這一種因?yàn)樗丫幋a邏輯沉淀在腳本內(nèi)部IDE側(cè)不需要反復(fù)調(diào)整。4. 實(shí)操中會(huì)遇到的典型問(wèn)題與排查實(shí)錄做這整套鏈路一段時(shí)間后遇到最多的坑不是“功能不會(huì)用”而是“腳本沒(méi)跑成、輸出又看不懂”。這一節(jié)把高頻問(wèn)題集中整理一下每條都貼出排查思路。4.1 中文亂碼或輸出字符缺字現(xiàn)象腳本里echo 系統(tǒng)正常控制臺(tái)顯示緋葷姝父。排查順序先確認(rèn)是控制臺(tái)顯示問(wèn)題還是腳本文件本身亂碼。在IDE右下角看文件編碼Scratch文件若被識(shí)別為UTF-8而bat腳本內(nèi)保存時(shí)用了GBK那內(nèi)容在寫(xiě)入時(shí)就亂了。解決統(tǒng)一以UTF-8保存腳本首行加chcp 65001。再看IDE控制臺(tái)編碼。Settings \ Editor \ General \ Console中調(diào)整默認(rèn)編碼為UTF-8。最后檢查是否運(yùn)行在舊版Windows控制臺(tái)宿主部分環(huán)境對(duì)UTF-8支持不完美需要切換Windows Terminal或更新IDE。4.2 路徑帶空格導(dǎo)致命令被截?cái)喱F(xiàn)象腳本中寫(xiě)copy D:\\My Documents\\file.txt D:\\backup\\外部CMD沒(méi)問(wèn)題IDE里莫名報(bào)錯(cuò)。排查后往往不是腳本邏輯問(wèn)題而是IDE在傳遞工作目錄時(shí)對(duì)引號(hào)處理過(guò)于激進(jìn)。解決辦法不要依賴(lài)命令行引號(hào)兜底盡量在腳本變量中統(tǒng)一使用環(huán)境變量風(fēng)格加引號(hào)也可以在腳本開(kāi)頭cd /d %~dp0顯式切到腳本所在目錄然后再寫(xiě)后續(xù)路徑降低對(duì)運(yùn)行配置的依賴(lài)。4.3 執(zhí)行bat時(shí)控制臺(tái)沒(méi)有輸出卡在“Starting”現(xiàn)象點(diǎn)擊運(yùn)行后控制臺(tái)底部一直顯示“Starting ...”沒(méi)有任何命令輸出的跡象。這種狀態(tài)常見(jiàn)于bat腳本內(nèi)含pause命令。外部CMD窗口里pause會(huì)提示按任意鍵繼續(xù)IDE控制臺(tái)也能接收按鍵但如果你沒(méi)有將交互模式設(shè)為可輸入IDE可能會(huì)認(rèn)為進(jìn)程還在等待。解決辦法有兩條在腳本里去掉pause用于批量自動(dòng)化在運(yùn)行配置中將Emulate terminal in output console打開(kāi)讓IDE控制臺(tái)模擬終端交互能力。實(shí)際使用中我會(huì)更傾向于后者。因?yàn)橛行┑谌侥_本會(huì)自行調(diào)用pause我們無(wú)法一一修改。模擬終端后控制臺(tái)內(nèi)部可以直接敲鍵盤(pán)回應(yīng)不會(huì)再出現(xiàn)假死。4.4 腳本運(yùn)行了但行為與預(yù)期不符源頭竟是編碼換行符bat文件在Windows里應(yīng)當(dāng)使用CRLF換行。若Scratch內(nèi)部實(shí)際存儲(chǔ)的換行符是LF運(yùn)行到某些行時(shí)可能異常跳躍。IDE創(chuàng)建Scratch時(shí)默認(rèn)跟隨系統(tǒng)換行但如果文件是從Linux機(jī)器拷貝過(guò)來(lái)的這個(gè)問(wèn)題就很常見(jiàn)。排查方法Settings \ Editor \ Code Style \ Line separator確認(rèn)使用Windows (\r\n)并在目標(biāo)腳本內(nèi)全選替換換行符后再執(zhí)行。4.5 找不到打開(kāi)運(yùn)行的按鈕基本上只會(huì)在一種情況下出現(xiàn)Scratch文件后綴不是.bat或.cmdIDE未把它視為可執(zhí)行腳本。把文件重命名或調(diào)整Scratch文件類(lèi)型即可解決。有的IDE版本里Batch語(yǔ)言放在“Other”分類(lèi)別因?yàn)檎也坏健癇atch”清空整個(gè)功能。4.6 環(huán)境變量與外部CMD不一致現(xiàn)象同一個(gè)腳本在外部CMD窗口里完全正常在IDE里運(yùn)行就提示command not found或無(wú)法識(shí)別。原因通常是IDE子進(jìn)程繼承的環(huán)境變量少于終端窗口。排查步驟在運(yùn)行配置面板補(bǔ)全依賴(lài)的環(huán)境變量如果是Path變量缺失在全局環(huán)境變量中追加更穩(wěn)的辦法是在腳本首行動(dòng)態(tài)加載用戶(hù)環(huán)境變量call %SystemRoot%\\System32\\where.exe java這類(lèi)命令瞬間驗(yàn)證缺少什么再對(duì)應(yīng)處理。按個(gè)人經(jīng)驗(yàn)此類(lèi)問(wèn)題一多半是用戶(hù)環(huán)境變量沒(méi)被IDE啟動(dòng)進(jìn)程繼承引起的補(bǔ)一個(gè)PATH%PATH%;C:\\your\\dir就能解決。5. 把這項(xiàng)能力擴(kuò)展到日常工作中的幾個(gè)思路當(dāng)“Scratches bat IDE控制臺(tái)”這套組合熟練起來(lái)以后它的使用范圍遠(yuǎn)不只是“偶爾跑一次腳本”。這里分享幾個(gè)我自己已經(jīng)穩(wěn)定使用的場(chǎng)景。日常備份腳本的統(tǒng)一入口把備份數(shù)據(jù)庫(kù)、導(dǎo)出日志、壓縮歸檔這類(lèi)十幾個(gè)bash/bat命令全部整理成Scratch集中管理和手動(dòng)觸發(fā)替代記一堆快捷方式構(gòu)建輔助工具的臨時(shí)集散地每次接新項(xiàng)目時(shí)把環(huán)境檢查、依賴(lài)安裝、啟動(dòng)命令等寫(xiě)成一個(gè)bat存到Scratch區(qū)新環(huán)境搭好后就跑一次不用保留長(zhǎng)文文檔跨語(yǔ)言協(xié)作的臨時(shí)試驗(yàn)場(chǎng)寫(xiě)一個(gè)bat去調(diào)用Python腳本處理數(shù)據(jù)Python腳本本身放在旁邊作為另一個(gè)Scratch互相搭配調(diào)試形成了IDE內(nèi)完整的小型任務(wù)流水線(xiàn)。還有一個(gè)容易被人忽略的好處把重復(fù)性操作腳本化之后會(huì)極大地降低“不敢重啟電腦”的焦慮。以前所有臨時(shí)腳本分散在桌面、下載目錄、舊項(xiàng)目里重啟后找起來(lái)費(fèi)勁現(xiàn)在Scratch區(qū)統(tǒng)一收納IDE一啟動(dòng)全部在列隨時(shí)可以跑。如果你已經(jīng)在使用這個(gè)功能只是沒(méi)想過(guò)它還能調(diào)度bat建議最近就拿一個(gè)手頭最常見(jiàn)的重復(fù)操作試試。先在Scratch里寫(xiě)好第一版運(yùn)行配置調(diào)好編碼和參數(shù)執(zhí)行一次看看輸出再?zèng)Q定要不要進(jìn)一步自動(dòng)化。這通常是體驗(yàn)全面升級(jí)的開(kāi)始。一個(gè)放之各版本IDE皆準(zhǔn)的道理功能入口命名越“低調(diào)”背后能挖掘的效率越驚人。Scratches and Consoles這名字聽(tīng)起來(lái)像是給隨手涂鴉用的但把它和批處理執(zhí)行綁定之后它在本地自動(dòng)化這條路上的分量并不比那些重型構(gòu)建系統(tǒng)輕多少。