Freemarker導(dǎo)出復(fù)雜Excel這件事剛聽上去有點(diǎn)像用菜刀開罐頭——不是不能但總覺得應(yīng)該用POI。直到我手頭那個報表系統(tǒng)連續(xù)改了四五版表頭每次都要重新對著POI代碼調(diào)樣式、挪合并單元格、試列寬我才認(rèn)真把模板生成Excel這條路完整走了一遍。走完之后我的結(jié)論是如果你的報表特征是“表頭復(fù)雜、樣式固定、數(shù)據(jù)按模板填充”Freemarker模板導(dǎo)出Excel的性價比高到離譜。這篇文章不聊什么高深架構(gòu)就把我自己在項目中怎么選型、怎么做模板、怎么踩坑、怎么回頭的完整過程寫出來給那些正在被復(fù)雜Excel導(dǎo)出折磨的人一個能直接上手的方向。先把這個方案的邊界說清楚Freemarker本身是個模板引擎它不生成xlsx二進(jìn)制文件而是生成一個“Excel能識別”的文本文件。目前最靠譜的玩法有兩種一種是XML Spreadsheet 2003格式另一種是HTML表格偽裝成xls。我的項目里最終選了前者后面我會解釋為什么。如果你做的是那種表頭三四層、帶合并單元格、帶公式、帶多個sheet的月度報表這篇文章應(yīng)該能幫你省掉至少一個星期的返工時間。1. 一個讓我重新考慮導(dǎo)出方案的真實場景1.1 最初用POI寫排班表導(dǎo)出的痛點(diǎn)我接手過一個排班表導(dǎo)出功能。表頭左邊是人員信息列中間是31天日期列最上面還要插一個“本月匯總”的大合并行每個人員一行按班組動態(tài)分組。最初用POI寫的寫了兩千多行Java代碼。光是設(shè)置表頭樣式就寫了三個方法合并單元格的時候還要自己維護(hù)一個CellRangeAddress列表防止合并區(qū)域重疊。每次業(yè)務(wù)方提需求說“表頭第三個層級加一列備注”“匯總行改一下底色”我就要重新定位代碼里那一段改完還得肉眼對著一堆setCellStyle排查有沒有漏掉。更惡心的是排班表里列寬會隨內(nèi)容變化POI里不同列要單獨(dú)setColumnWidth一旦數(shù)據(jù)量大了打開文件還容易出現(xiàn)“已修復(fù)部分內(nèi)容”的提示。后來我冷靜想了想這個功能本質(zhì)上是什么是“把固定的視覺模板和動態(tài)數(shù)據(jù)拼在一起”。這不就是模板引擎最擅長的事嗎我為什么非要用代碼去一行行畫格子1.2 Freemarker導(dǎo)出Excel適合解決什么問題Freemarker導(dǎo)出Excel的真正適用場景一句話總結(jié)“Excel外觀幾乎不變變的只有里面填的數(shù)據(jù)和行數(shù)”。比如銷售報表、排班表、對賬單、固定資產(chǎn)臺賬這些表有共同特點(diǎn)表頭設(shè)計極其復(fù)雜但一旦定下來幾個月甚至幾年都不動數(shù)據(jù)是按日/按月刷新的樣式要求高要跟企業(yè)現(xiàn)有表格保持一致偶爾還需要公式自動算合計。這種場景下你用XWPF那套思路去硬編碼是災(zāi)難。你改的不是一處代碼而是所有涉及樣式、合并、邊框、字號的散點(diǎn)代碼。但如果你把Excel本身當(dāng)成模板用Freemarker往里面填數(shù)據(jù)業(yè)務(wù)方改樣式只需要改Excel模板文件Java代碼一行都不用動。1.3 模板導(dǎo)出與POI的邊界劃分不要二極管。我這里不是說POI沒用而是說兩種方案各有邊界。POI/SXSSF適合需要動態(tài)創(chuàng)建圖表、透視表、圖片嵌入、幾十萬行數(shù)據(jù)流式導(dǎo)出、需要程序生成全新結(jié)構(gòu)的文件。Freemarker模板適合結(jié)構(gòu)相對穩(wěn)定、樣式要求高、多sheet、合并單元格多、依賴公式、數(shù)據(jù)量在幾萬行以內(nèi)。我當(dāng)時那個排班表樣式固定、行數(shù)最多幾千完全在模板方案的安全區(qū)內(nèi)。選型選對了后面開發(fā)量是斷崖式下降。2. 為什么Excel能打開“Freemarker生成的文件”兩種模板格式的選型2.1 關(guān)鍵前提XML Spreadsheet 2003和HTML表格都能被Excel識別先說原理不然你后面連錯都不知道錯在哪。Excel并不是只認(rèn)xls/xlsx兩種二進(jìn)制格式它內(nèi)置支持一種叫XML Spreadsheet 2003的純XML交換格式。這種格式的文件擴(kuò)展名可以直接寫成.xls文件開頭有一個特殊的處理指令?xml version1.0 encodingUTF-8? ?mso-application progidExcel.Sheet?這個?mso-application progidExcel.Sheet?就是關(guān)鍵標(biāo)識Windows和Excel看到它就知道這是Excel文檔雙擊就能直接打開。另外Excel也支持直接打開HTML格式的文件只要HTML里包含table結(jié)構(gòu)并且聲明了office的excel命名空間同樣可以偽裝成.xls。這就是很多老項目用Freemarker拼HTML表格導(dǎo)出Excel的原理。這兩種格式Freemarker都能生成但實戰(zhàn)中的體驗差距很大下面分開講。2.2 XML Spreadsheet 2003的文件骨架與命名空間我最后選的就是這個格式。它的核心結(jié)構(gòu)是Workbook - Worksheet - Table - Row - Cell所有標(biāo)簽都有嚴(yán)格的命名空間urn:schemas-microsoft-com:office:spreadsheet縮寫通常寫作ss。一個最簡單的骨架長這樣?xml version1.0 encodingUTF-8? ?mso-application progidExcel.Sheet? Workbook xmlnsurn:schemas-microsoft-com:office:spreadsheet xmlns:ourn:schemas-microsoft-com:office:office xmlns:xurn:schemas-microsoft-com:office:excel xmlns:ssurn:schemas-microsoft-com:office:spreadsheet Styles Style ss:IDsHeader Alignment ss:HorizontalCenter ss:VerticalCenter/ Font ss:FontName微軟雅黑 ss:Size10 ss:Bold1/ Interior ss:Color#4472C4 ss:PatternSolid/ /Style /Styles Worksheet ss:NameSheet1 Table Column ss:Width90/ Row Cell ss:StyleIDsHeaderData ss:TypeString姓名/Data/Cell /Row /Table /Worksheet /Workbook注意兩點(diǎn)第一Data標(biāo)簽的ss:Type必須寫對字符串是String數(shù)字是Number日期是DateTime寫錯了Excel打開會報錯或者類型錯亂第二Cell里的ss:StyleID引用的是Styles里定義的ss:ID樣式復(fù)用能力很強(qiáng)一個表頭樣式可以在幾十個單元格上共用。2.3 HTML Table偽裝xls的妥協(xié)方案再來說說另一種思路Freemarker直接輸出一個帶table的HTML頁面響應(yīng)頭設(shè)置成application/vnd.ms-excel后綴為.xls。Excel打開后確實能顯示表格但它對HTML表格的支持屬于“盡力而為”多sheet支持很別扭公式不會被執(zhí)行列寬、打印分頁、合并單元格的控制能力都遠(yuǎn)不如XML Spreadsheet。我在一個老項目里見過這種方案最典型的問題是WPS打開會彈“文件格式與擴(kuò)展名不匹配”的警告用戶每次都以為文件壞了。而且一旦某個單元格數(shù)據(jù)里包含了類似td的字符串整個表格布局都可能被沖亂。所以我的選型結(jié)論很簡單要長期維護(hù)、公式多、樣式嚴(yán)的報表直接用XML Spreadsheet 2003只是臨時導(dǎo)個列表給用戶看HTML偽裝xls可以用但別指望它能扛住復(fù)雜需求。3. 動手做一個真實可用的Freemarker Excel模板3.1 用Excel另存為XML拿到初始模板手寫整個XML骨架太容易出錯正確做法是先讓Excel幫你生成一個“標(biāo)準(zhǔn)答案”。具體操作先用Excel/WPS把報表的靜態(tài)樣式全部做好包括表頭合并、邊框、底色、列寬、數(shù)字格式然后另存為“XML 電子表格 2003”格式得到一個.xml文件。這個文件就是天然模板底稿。這時候不要急著改先做三件事用文本編輯器打開確認(rèn)編碼格式建議UTF-8。檢查?mso-application progidExcel.Sheet?是否存在沒有就手動補(bǔ)上。看一眼Styles里面的ss:ID后面改數(shù)據(jù)時大量引用這些ID。我通常會把文件名改成report.xml.ftl然后全局搜索需要動態(tài)化的地方把靜態(tài)值替換成Freemarker表達(dá)式。3.2 把靜態(tài)單元格改造成Freemarker占位與循環(huán)假設(shè)報表主表是一個訂單明細(xì)行數(shù)不固定。模板里最核心的改動是把一條靜態(tài)Row放進(jìn)#list循環(huán)里#list orderList as order Row Cell ss:StyleIDsTextData ss:TypeString${order.orderNo}/Data/Cell Cell ss:StyleIDsNumData ss:TypeNumber${order.amount}/Data/Cell Cell ss:StyleIDsDateData ss:TypeDateTime${order.orderTime}/Data/Cell /Row /#list這里有兩個細(xì)節(jié)會影響成敗第一#list標(biāo)簽和Row標(biāo)簽盡量寫在同一行或者標(biāo)簽之間不要有額外的空白文本節(jié)點(diǎn)。雖然XML里的空白文本不會導(dǎo)致Excel打不開但我在實際測試?yán)镉龅竭^個別sheet出現(xiàn)多余換行的情況字體小的時候根本看不出來打印時多出一頁空白。第二所有動態(tài)插值都必須考慮轉(zhuǎn)義。XML里、、是結(jié)構(gòu)字符如果業(yè)務(wù)數(shù)據(jù)里出現(xiàn)“AB公司”這種字符串不轉(zhuǎn)義會直接破壞XML結(jié)構(gòu)Excel打開就報錯。Freemarker里最穩(wěn)妥的做法是統(tǒng)一用?xmlCell ss:StyleIDsTextData ss:TypeString${order.companyName?xml}/Data/Cell如果單元格樣式ID也是動態(tài)的屬性值也要轉(zhuǎn)義ss:StyleID${cell.styleId?xml}。這一步?jīng)]做好后期排查會讓你懷疑人生。3.3 Java端的三行核心調(diào)用與輸出流處理模板做好了Java端其實就三步創(chuàng)建Configuration、獲取Template、把數(shù)據(jù)模型和Writer交給process方法。Configuration cfg new Configuration(Configuration.VERSION_2_3_32); cfg.setDefaultEncoding(UTF-8); cfg.setClassForTemplateLoading(getClass(), /templates/excel); Template template cfg.getTemplate(report.xml.ftl); MapString, Object root new HashMap(); root.put(orderList, orderService.queryTodayOrders()); // 直接往響應(yīng)流寫不要先拼字符串再轉(zhuǎn) response.setContentType(application/vnd.ms-excel;charsetUTF-8); String fileName 訂單明細(xì)_ LocalDate.now() .xls; response.setHeader(Content-Disposition, attachment; filename URLEncoder.encode(fileName, UTF-8).replace(, %20)); Writer out new BufferedWriter(new OutputStreamWriter(response.getOutputStream(), UTF-8)); template.process(root, out); out.flush();為什么強(qiáng)調(diào)“直接往響應(yīng)流寫”因為Freemarker的process本身是流式的模板渲染一行就寫一行。如果你改成StringWriter先把整份XML拼到內(nèi)存里再一次性輸出幾萬行數(shù)據(jù)時內(nèi)存會成倍上漲后面第5章我會講我實測的GC教訓(xùn)。3.4 下載接口的響應(yīng)頭與文件名細(xì)節(jié)響應(yīng)頭是坑最多的地方。我一共踩過三個Content-Type設(shè)成text/html時文件能被打開但瀏覽器/ Office會把它當(dāng)網(wǎng)頁處理導(dǎo)致“文件格式與擴(kuò)展名不匹配”。中文文件名直接拼進(jìn)Content-Disposition會亂碼必須URLEncoder.encode且要把編碼后產(chǎn)生的替換成%20否則某些瀏覽器下載的文件名空格會變成加號。如果用application/octet-stream兜底部分WPS版本彈安全警告。標(biāo)準(zhǔn)做法就是我上面代碼里寫的application/vnd.ms-excel;charsetUTF-8 URLEncode后的文件名。這里的charsetUTF-8、XML聲明里的encodingUTF-8、模板文件保存的編碼、OutputStreamWriter指定的編碼四處必須一致任何一處不一致都可能在亂碼上翻車。4. 處理復(fù)雜報表的五個硬場景合并、分組、公式、多Sheet、圖片4.1 合并單元格Ref行號會隨動態(tài)數(shù)據(jù)漂移XML Spreadsheet 2003的合并單元格長這樣MergeCells Count1 MergeCell RefR1C1:R1C4/ /MergeCellsR1C1:R1C4表示從第1行第1列到第1行第4列合并。問題在于你模板里寫死的Ref是固定行號一旦上面插入動態(tài)行下面所有區(qū)域的行號全錯位。處理思路分兩檔合并區(qū)域完全在固定表頭區(qū)域不隨數(shù)據(jù)變化那么直接寫死Ref沒問題。合并區(qū)域跨動態(tài)行范圍比如“每個分組自動合并第一列”就不能寫死。我建議在數(shù)據(jù)模型里預(yù)先把每個分組的起始行和結(jié)束行算好模板里直接輸出#list groupList as g Row.../Row ... MergeCell RefR${g.startRow}C1:R${g.endRow}C1/ /#list初始行號怎么算一般規(guī)則是固定表頭占幾行從第表頭行數(shù)1行開始算數(shù)據(jù)每行Row占一行。我在項目里專門寫了一個小工具類專門根據(jù)“表頭占位行數(shù) 每組數(shù)據(jù)量”計算合并起點(diǎn)避免在模板里做復(fù)雜算術(shù)。4.2 分組行嵌套循環(huán)時行號錯位怎么防再復(fù)雜一點(diǎn)分組嵌套循環(huán)每組有一個大標(biāo)題行下面若干明細(xì)行。這種場景最容易出的問題不是語法錯誤而是明明模板沒寫錯合并行號卻忽前忽后。我的經(jīng)驗是不要在模板里現(xiàn)算行號交給Java端做預(yù)處理。數(shù)據(jù)模型提前構(gòu)造成類似這樣ListGroupData groups; class GroupData { String groupName; ListRowData rows; int startRow; int endRow; }模板里循環(huán)輸出組標(biāo)題行和明細(xì)行然后單獨(dú)輸出MergeCell時直接引用group.startRow。這樣模板保持簡單復(fù)雜的行號計算全部收進(jìn)Java代碼出問題也好調(diào)試。4.3 公式的渲染方式與打開后不自動計算問題模板方式當(dāng)然支持公式在Data后面放Formula標(biāo)簽即可。比如訂單表里金額列、稅額列都有了要一列合計金額Cell ss:StyleIDsNum Data ss:TypeNumber0/Data FormulaRC[-2]RC[-1]/Formula /Cell這里RC[-2]和RC[-1]是相對引用代表當(dāng)前行往左數(shù)第2列、第1列。這個語法是從Excel本身的RC引用風(fēng)格來的比起拼A1、B1地址在動態(tài)行列場景下不容易算錯?？釉谀腅xcel打開文件時是否重新計算公式取決于文件的CalcMode設(shè)置和用戶本機(jī)Excel的計算選項。我遇到過文件打開后公式位置是空白的排查半天發(fā)現(xiàn)模板里少了Excel的Workbook配置節(jié)。你最好在Workbook根節(jié)點(diǎn)下保留這段x:ExcelWorkbook x:CalcModeAuto/x:CalcMode /x:ExcelWorkbook另外有一種更穩(wěn)妥的兜底公式依賴的原始數(shù)據(jù)在Java端都有你可以在導(dǎo)出時把公式結(jié)果直接算好填進(jìn)Data公式再放進(jìn)Formula。這樣即使Excel出于性能配置沒重新計算用戶看到的也有值F9手動重算后又能驗證公式本身是對的。4.4 動態(tài)多Sheet模板的循環(huán)輸出多sheet的場景我用一個排班月報舉過例每個月一個sheet或者每個班組一個sheet。模板里不需要復(fù)制多個Worksheet直接用#list循環(huán)生成即可#list sheetList as sheet Worksheet ss:Name${sheet.name} Table ss:ExpandedRowCount${sheet.rowCount} ss:ExpandedColumnCount${sheet.colCount} ... /Table /Worksheet /#listss:ExpandedRowCount和ss:ExpandedColumnCount這兩個屬性容易被忽略。如果你不聲明Excel會按模板里的實際行數(shù)列數(shù)推斷動態(tài)渲染后一旦數(shù)據(jù)行數(shù)超過模板里的靜態(tài)Row數(shù)量可能出現(xiàn)列寬丟失、全選區(qū)域變小的情況。我在做動態(tài)多sheet時吃過這個虧最后是固定給Table補(bǔ)上這兩個屬性解決的。4.5 圖片和批注這個方案能做的邊界必須說清楚Freemarker模板方案對圖片的支持非常弱。XML Spreadsheet 2003里嵌入圖片要寫OLEObject、VML對象結(jié)構(gòu)復(fù)雜且不同Excel版本兼容性不穩(wěn)定。我的建議是如果圖片只是“附件說明”性質(zhì)單元格里放圖片URL最省事導(dǎo)出后用戶點(diǎn)擊鏈接打開。如果是產(chǎn)品圖片、簽名圖片必須嵌入單元格內(nèi)就別用模板方案硬剛了老老實實用POI的Picture API。批注同理XML Spreadsheet 2003里批注是用Comment 關(guān)聯(lián)作者配置實現(xiàn)的手工維護(hù)成本高。我記得有一次為了復(fù)現(xiàn)一條批注光VML路徑的坐標(biāo)就調(diào)了半小時。模板方案的核心價值在單元格數(shù)據(jù)和樣式不要拿它去跟POI拼“全能”。5. 我在項目中實際踩過的坑清單5.1 下載后提示“文件格式與擴(kuò)展名不匹配”這是模板導(dǎo)出最常見的翻車點(diǎn)我見過團(tuán)隊排查了整整一個下午最后發(fā)現(xiàn)是響應(yīng)頭寫錯了。完整的排查鏈路應(yīng)該是這樣先確認(rèn)Content-Type是不是application/vnd.ms-excel不是就改。再確認(rèn)文件流里第一行是不是?xml version1.0 encodingUTF-8?第二行是不是?mso-application progidExcel.Sheet?progid丟了Excel就會認(rèn)為這只是一個普通XML文本。接著確認(rèn)根節(jié)點(diǎn)Workbook的命名空間xmlns:ssurn:schemas-microsoft-com:office:spreadsheet存在沒有這個命名空間里面所有ss:Type、ss:StyleID屬性都會被忽略。最后在本地寫個測試controller直接用瀏覽器訪問把響應(yīng)體保存成.xls跟模板文件對比看是不是被框架層的攔截器改寫了響應(yīng)頭。那次我們卡在第3步用Freemarker拼模板時不小心把根節(jié)點(diǎn)的一行xmlns:ss漏掉了結(jié)果Excel打開后能顯示文件名但雙擊就報格式錯誤。5.2 長數(shù)字變成科學(xué)計數(shù)法日期變成一串?dāng)?shù)字訂單號、身份證號這類長數(shù)字在Excel里動不動就變成1.23457E11。很多人第一反應(yīng)是改模板里單元格的數(shù)據(jù)類型但真正的原因可能是Excel的顯示格式。兩種解決方式我都用過第一種單元格數(shù)據(jù)類型保持Number但在Style里加數(shù)字格式NumberFormat ss:Format0/這樣Excel會按普通數(shù)字顯示不轉(zhuǎn)科學(xué)計數(shù)法。但超過15位時仍然有精度問題。第二種更徹底既然這類編號本來就不參與計算不如直接按字符串輸出。Cell ss:StyleIDsTextData ss:TypeString${order.cardNo}/Data/Cell如果數(shù)據(jù)模型里是數(shù)字類型記得先toString或者模板里用${order.cardNo?string(0)}轉(zhuǎn)成無科學(xué)計數(shù)法的字符串再輸出。日期變成一串?dāng)?shù)字原因通常是把DateTime類型寫成了String。XML Spreadsheet 2003里日期要用DateTimeData ss:TypeDateTime2025-01-15T09:30:00.000/Data同時樣式里配套NumberFormat ss:Formatyyyy-mm-dd hh:mm:ss/能顯示成正常日期。5.3 用戶輸入的符號把XML結(jié)構(gòu)炸了這是一條線上事故教訓(xùn)。某個備注字段用戶填了“研發(fā)測試”導(dǎo)出時沒做轉(zhuǎn)義生成的文件里出現(xiàn)了裸XML解析直接失敗所有用戶同一時間導(dǎo)不出報表。排查鏈路也很清晰先下載文件用文本編輯器打開看到靠近報錯位置的XML片段里出現(xiàn)了孤立的再定位到是哪個數(shù)據(jù)字段最后給所有動態(tài)輸出統(tǒng)一加上?xml轉(zhuǎn)義。給所有動態(tài)輸出統(tǒng)一加上?xml轉(zhuǎn)義。后來我在數(shù)據(jù)模型里加了一個escapeXml的統(tǒng)一出口所有進(jìn)入模板的字符串在Java端先轉(zhuǎn)義一遍模板里即使有人忘了寫?xml兜底邏輯也還在。雙保險之后這個坑再沒出現(xiàn)。5.4 幾萬行數(shù)據(jù)導(dǎo)出時內(nèi)存和GC的教訓(xùn)有一版我圖省事用了StringWriter先把整個XML拼出來再一次性轉(zhuǎn)成byte[]寫回響應(yīng)。導(dǎo)出一張6萬行的對賬單時應(yīng)用程序的堆內(nèi)存直接從正常水平飆到接近上限連續(xù)幾次導(dǎo)出直接觸發(fā)頻繁Full GC。那次排查引向一個結(jié)論Freemarker的process方法是流式寫出的你不該把它拼成完整字符串。改成直接把OutputStreamWriter傳給process后內(nèi)存占用降了一個數(shù)量級。還有個容易被忽略的點(diǎn)模板里的#list內(nèi)盡量少調(diào)用復(fù)雜的自定義函數(shù)Freemarker每行數(shù)據(jù)都會重新解析表達(dá)式函數(shù)太重時單行渲染時間會飆升數(shù)據(jù)量一大性能就崩。提前把能算好的值全放進(jìn)數(shù)據(jù)模型模板保持“傻白甜”狀態(tài)性能最穩(wěn)。5.5 模板改了不生效Freemarker緩存問題項目里同事改完模板刷新頁面發(fā)現(xiàn)還是舊樣式第一反應(yīng)是瀏覽器緩存實際上Freemarker自己會緩存模板。Debug階段建議關(guān)掉緩存或者把更新延遲設(shè)成0cfg.setTemplateUpdateDelayMilliseconds(0);生產(chǎn)環(huán)境再改回默認(rèn)緩存策略或者干脆只在發(fā)版時更新模板。這個機(jī)制平時是好事能少很多模板解析開銷但也正是因為它“太方便”容易讓人在開發(fā)期誤以為模板沒保存成功。6. 我的個人建議什么時候繼續(xù)用模板什么時候回頭用POI6.1 模板目錄的權(quán)限與控制模板文件一定要放在項目資源目錄或者獨(dú)立配置目錄里不要散落在業(yè)務(wù)代碼中。我習(xí)慣建一個templates/excel目錄每個模板單獨(dú)一個.ftl文件命名跟業(yè)務(wù)報表一一對應(yīng)。生產(chǎn)環(huán)境模板目錄只給運(yùn)維和核心開發(fā)寫權(quán)限防止業(yè)務(wù)方直接改了線上文件卻沒人知道。版本管理里模板和代碼一樣走審批別小看這一步模板出錯造成的線上事故一點(diǎn)都不比代碼少。6.2 分工方式Excel模板由誰維護(hù)這套方案最大的隱性收益是“樣式需求不再全壓在開發(fā)頭上”。業(yè)務(wù)方想要換個表頭底色、加一列、調(diào)列寬只要給到調(diào)好的Excel模板開發(fā)人員另存為XML后替換占位符即可。實際操作中我不建議完全交給業(yè)務(wù)方做畢竟另存為XML并改造占位符還是需要一點(diǎn)基本功的但至少他們可以先把樣式調(diào)到滿意開發(fā)只做數(shù)據(jù)接入。6.3 一套判斷標(biāo)準(zhǔn)最后給一張我在項目里用的簡表直接對照著選需求特征推薦方案原因表頭復(fù)雜、樣式固定Freemarker XML Spreadsheet 2003樣式復(fù)用集中改樣式不動代碼行數(shù)動態(tài)、分組動態(tài)Freemarker Java端預(yù)處理行號模板保持簡單復(fù)雜計算收進(jìn)Java需要內(nèi)置公式自動匯總Freemarker Formula CalcMode Auto天然支持相對引用多個Sheet固定模板Freemarker Worksheet循環(huán)一次渲染多表需要嵌入圖片、圖表POI模板方案對圖片支持太弱幾十萬行大數(shù)據(jù)量POI SXSSF流式寫盤避免內(nèi)存暴漲需要生成全新未知結(jié)構(gòu)POI模板無法窮舉所有結(jié)構(gòu)文本導(dǎo)出的思路聽起來“不夠原生”但只要你看透它背后是Excel官方支持的交換格式就會明白這不是歪門邪道而是一條被低估的工程捷徑。我個人在實際項目里的體會是把復(fù)雜Excel導(dǎo)出的需求拆成“樣式”和“數(shù)據(jù)”兩半樣式的職責(zé)歸模板數(shù)據(jù)的職責(zé)歸Java兩者通過Freemarker匯合后續(xù)改動成本能壓縮到非常小。如果你的項目正好卡在“表頭改一次我就得改一次代碼”的循環(huán)里不妨找個周末拿一個真實報表把這條鏈路完整跑一遍。