Excel的完整指南)
簡(jiǎn)介針對(duì) Delphi 12.3 開(kāi)發(fā)環(huán)境的 XLSReadWriteII v6.01.17 控件包面向需要在桌面程序中實(shí)現(xiàn) Excel 文件讀寫(xiě)、報(bào)表生成與數(shù)據(jù)導(dǎo)出的中高級(jí) Delphi 開(kāi)發(fā)者。整套資源共 499 個(gè)文件壓縮后約 2.15MB以 pas 源碼為核心配套 dfm 表單、dpr 工程及 html 說(shuō)明文檔便于閱讀控件實(shí)現(xiàn)、查看界面布局與運(yùn)行示例項(xiàng)目。壓縮包內(nèi)還包含 dproj、inc、res 等工程配置文件以及少量 gif、jpg 插圖與示例用 fmx、cds 文件適合在 Delphi 12.3 環(huán)境下快速安裝引用并對(duì)照學(xué)習(xí)。已有 65 人瀏覽學(xué)習(xí)。通過(guò)該控件包可獲得完整的單元源碼、豐富的示例工程如網(wǎng)格、篩選、透視表、自動(dòng)過(guò)濾等場(chǎng)景以及相關(guān)的配置文件。對(duì)于需要處理復(fù)雜 Excel 模板、批量生成報(bào)表或集成表格交互的開(kāi)發(fā)者來(lái)說(shuō)這套資料能直接提供可編譯運(yùn)行的參考框架節(jié)省從底層協(xié)議開(kāi)始摸索的時(shí)間同時(shí)幫助熟悉 XLSReadWriteII 的常用對(duì)象模型與設(shè)計(jì)思路。1. 一個(gè) rar 包解決的 Delphi 12.3 讀寫(xiě) Excel 問(wèn)題拿到Delphi 12.3控件之XLSReadWriteII v6.01.17 D12.rar你先要理解它解決的核心矛盾Delphi 程序要導(dǎo)出帶格式的 xls/xlsx、要解析用戶(hù)丟過(guò)來(lái)的 Excel 報(bào)表但你又不想在服務(wù)器上裝 Office、不想跟 COM 的 Excel 進(jìn)程糾纏。XLSReadWriteII 是 Delphi 生態(tài)里專(zhuān)門(mén)做這件事的第三方控件D12后綴表示它跟隨 Delphi 12含 12.3 更新的編譯環(huán)境v6.01.17是它的版本號(hào)。適合做 ERP 報(bào)表、工業(yè)數(shù)據(jù)導(dǎo)出、批量導(dǎo)入落庫(kù)這類(lèi)活兒的 Delphi 開(kāi)發(fā)者。接下來(lái)的內(nèi)容我按解壓安裝、最小讀寫(xiě)、格式與多 Sheet、踩坑排查的順序把這個(gè)包從裝到用完整拆一遍。2. 裝進(jìn) Delphi 12.3包編譯、庫(kù)路徑與控件安裝驗(yàn)證2.1 先分清源碼包和編譯包別把它當(dāng) ActiveX 控件裝XLSReadWriteII 的發(fā)布 rar 解壓后常見(jiàn)布局是 Bin 放編譯好的 bpl/dcpSource 放 .pas 源碼Packages 里放對(duì)應(yīng)各版本 Delphi 的 .dpk/.dproj 工程文件旁邊一般還有 Docs 和 Demo 目錄。v6.01.17 D12這種發(fā)布包通常源碼和編譯產(chǎn)物都齊但我一般建議你直接走源碼編譯不要貪圖省事去拖 Bin 里現(xiàn)成的 bpl——Delphi 12.3 的 RTL 和編譯器版本比 11、比 12.0 都有更新別人機(jī)器上編出來(lái)的二進(jìn)制包放到你這里輕則點(diǎn)安裝沒(méi)反應(yīng)重則 IDE 直接報(bào)“模塊版本不匹配”。這里有個(gè)容易翻車(chē)的認(rèn)知XLSReadWriteII 是 VCL 原生控件包不是 ActiveX。所以別照搬那些用regsvr32注冊(cè) dll 的流程也不存在 PageOffice、LODOP 那種瀏覽器控件“安裝后依然提示讓安裝”的注冊(cè)表問(wèn)題更不用像遠(yuǎn)程桌面 ActiveX 那樣去系統(tǒng)路徑里找 rdclientax.dll。它在 Delphi 里的安裝路徑只有一條配置 Library Path → 編譯 .dpk → Install 設(shè)計(jì)時(shí)包。2.2 配置 Library Path讓 IDE 找得到源文件解壓后第一件事是把 Source 目錄加進(jìn) IDE 的庫(kù)路徑。打開(kāi) Tools Options Delphi Options Library在 Library Path 里追加一行。Delphi 12.3 里會(huì)同時(shí)存在 32 位和 64 位平臺(tái)配置Source 目錄是平臺(tái)無(wú)關(guān)的純 Pascal 源碼所以?xún)蓚€(gè)平臺(tái)的庫(kù)路徑都要加別只改了 Win32 就以為完事。D:\Components\XLSReadWriteII\Source D:\Components\XLSReadWriteII\Packages\D12第一行是單元文件所在第二行是包工程所在。加完點(diǎn) Save 后最簡(jiǎn)單驗(yàn)證方式是按 CtrlF12 打開(kāi) Project Manager或直接搜索單元名如果能在列表里看到 XLSReadWriteII2.pas 之類(lèi)的單元說(shuō)明路徑生效。注意 rar 解壓時(shí)如果帶了很深的子目錄比如Source\XLSReadWriteII\你要加的是包含 .pas 的那一層不是只加到Source就停否則編譯包時(shí)照樣報(bào)Unit not found。2.3 編譯并安裝設(shè)計(jì)時(shí)包建議在 Packages\D12 目錄里找 .dproj 工程文件Delphi 12.3 可以直接雙擊 dproj 打開(kāi)然后在 Project Manager 里對(duì)包工程右鍵選 Build。這一步會(huì)生成 .bpl 和 .dcp。對(duì)于命令行習(xí)慣的人用 msbuild 更可控cd /d D:\Components\XLSReadWriteII\Packages\D12 msbuild XLSReadWriteII.dproj /t:Build /p:ConfigRelease /p:PlatformWin64這里把文件名換成包里的實(shí)際 dproj。Delphi 12 的 IDE 是 64 位進(jìn)程設(shè)計(jì)時(shí)包必須按 Win64 編譯否則組件面板加載不到如果運(yùn)行時(shí)的目標(biāo)平臺(tái)是 Win32那你項(xiàng)目的編譯器和運(yùn)行庫(kù)要另外按 Win32 處理但 IDE 里裝的設(shè)計(jì)時(shí)包必須是 Win64。Build 成功后菜單 Component Install Packages點(diǎn) Add選中剛生成的 .bpl 文件確認(rèn)后工具面板會(huì)多出一個(gè) XLSReadWriteII 頁(yè)簽。2.4 裝完先跑一個(gè)最小工程驗(yàn)證新建一個(gè) VCL Application把 XLSReadWriteII 組件拖到窗體上放一個(gè) Button寫(xiě)一段最基礎(chǔ)的導(dǎo)出代碼運(yùn)行看能否正常生成文件。這一步能篩掉八成安裝問(wèn)題不要跳過(guò)。procedure TForm1.Button1Click(Sender: TObject); begin XLSReadWriteII1.Filename : D:\temp\demo.xlsx; XLSReadWriteII1.Sheets[0].AsString[1, 1] : Hello from Delphi 12.3; XLSReadWriteII1.Write; end;邏輯說(shuō)明Filename不只決定存到哪里還決定寫(xiě)出文件格式Sheets[0]是默認(rèn)第一張工作表AsString[行, 列]是控件最常用的單元格寫(xiě)入接口坐標(biāo)從 1 開(kāi)始計(jì)數(shù)。如果運(yùn)行后 D:\temp 下出現(xiàn)了 demo.xlsx 且用 Excel 能打開(kāi)看到字符串安裝鏈路就通了。如果運(yùn)行報(bào)File not found先回 2.2 檢查 Library Path 是否真的包含源碼目錄再把包重新 Build 一次。3. 最小讀寫(xiě)流程Sheet、單元格與數(shù)據(jù)類(lèi)型的調(diào)用模型3.1 為什么是 Sheet Cells 這套對(duì)象模型XLSReadWriteII 內(nèi)部把一本工作簿拆成 Sheets 集合Sheet 是操作的核心單元格讀寫(xiě)都掛在 Sheet 上。這套模型的好處是貼合 Excel 本身的結(jié)構(gòu)不像早期的一些控件拿二維數(shù)組硬套遇到合并單元格、多 Sheet 聯(lián)動(dòng)就露怯。讀 Excel 時(shí)它把整個(gè)文件解析進(jìn)內(nèi)存寫(xiě) Excel 時(shí)它是按 BIFF 或 OOXML 規(guī)范直接生成文件全程不啟動(dòng) Excel 進(jìn)程所以能用在服務(wù)端無(wú)人值守的導(dǎo)出任務(wù)里。3.2 寫(xiě)出多行數(shù)據(jù)AsFloat、AsDateTime 與自動(dòng)類(lèi)型只寫(xiě)字符串不夠用實(shí)際導(dǎo)出通常是混合類(lèi)型?？催@個(gè)示例var LSheet: TXLSSheet; begin LSheet : XLSReadWriteII1.Sheets[0]; LSheet.AsString[1, 1] : 訂單號(hào); LSheet.AsInteger[1, 2] : 10023; LSheet.AsDateTime[1, 3] : Now; LSheet.AsFloat[1, 4] : 1999.99; XLSReadWriteII1.Filename : order.xlsx; XLSReadWriteII1.Write; end;邏輯說(shuō)明AsInteger寫(xiě)整數(shù)AsDateTime寫(xiě)日期時(shí)間AsFloat寫(xiě)小數(shù)。特別提醒AsDateTimeExcel 里的日期本質(zhì)是序列號(hào)如果你用AsString去寫(xiě)日期值寫(xiě)出來(lái)的是“44835.5”這種數(shù)字文本用戶(hù)打開(kāi)表格看到一串小數(shù)會(huì)以為導(dǎo)出程序壞了。參數(shù)說(shuō)明日期寫(xiě)入前確認(rèn)Now的時(shí)區(qū)信息是否需要轉(zhuǎn)換為本地時(shí)區(qū)服務(wù)端生成報(bào)表尤其要注意 UTC 和本地時(shí)間的差異最好在寫(xiě)入前統(tǒng)一var轉(zhuǎn)換。3.3 讀回?cái)?shù)據(jù)到界面把握 LastRow 和 LastCol讀操作是重點(diǎn)場(chǎng)景用戶(hù)表格可能有空行、有合并單元格但多數(shù)情況我們要的是規(guī)整的矩形區(qū)域。下面這段把內(nèi)容讀進(jìn) Memo注意邊界判定var LRow, LCol: Integer; LSheet: TXLSSheet; LLine: string; begin XLSReadWriteII1.Filename : input.xlsx; XLSReadWriteII1.Read; LSheet : XLSReadWriteII1.Sheets[0]; for LRow : 1 to LSheet.LastRow do begin LLine : ; for LCol : 1 to LSheet.LastCol do LLine : LLine LSheet.AsString[LRow, LCol] #9; Memo1.Lines.Add(LLine); end; end;邏輯說(shuō)明LastRow和LastCol返回的是 Sheet 實(shí)際有內(nèi)容的最后行和最后列用它做循環(huán)上限不會(huì)越界。參數(shù)說(shuō)明AsString讀取時(shí)會(huì)把其他類(lèi)型自動(dòng)轉(zhuǎn)成字符串但AsFloat取出來(lái)的小數(shù)位數(shù)受單元格格式影響格式化時(shí)最好用Format(%.2f, [...])固定精度。這個(gè)讀法適合中小文件幾十 MB 以?xún)?nèi)的 Excel 直接全量讀入內(nèi)存問(wèn)題不大超過(guò)這個(gè)量級(jí)建議在 Excel 里先做預(yù)處理或換用流式方案后面第六章會(huì)聊。3.4 單元格是否為空Type 判斷和 IsEmpty 的坑讀用戶(hù)傳上來(lái)的 Excel最麻煩的是混著空格和真空值。一行里某列既有公式算出空串又有物理空單元格統(tǒng)一讀出來(lái)都是空字符串。var LCell: TXLSCell; begin LCell : XLSReadWriteII1.Sheets[0].Cells[3, 2]; if LCell.IsEmpty then ShowMessage(這個(gè)單元格什么也沒(méi)有) else if LCell.DataType xlsString then ShowMessage(字符串 LCell.AsString); end;邏輯說(shuō)明Cells[Row, Col]返回單元格對(duì)象IsEmpty判斷物理上是否沒(méi)有任何值DataType返回類(lèi)型枚舉。這個(gè)判斷比直接比對(duì)AsString 可靠因?yàn)楣接?jì)算出的空結(jié)果和真空值在后續(xù)落庫(kù)時(shí)語(yǔ)義完全不同。參數(shù)說(shuō)明不同小版本里IsEmpty的命名可能略有差異有的版本叫Empty如果你編譯時(shí)提示找不到到隨包 CHM 幫助里搜“IsEmpty”看準(zhǔn)確名稱(chēng)不影響整體邏輯。4. 讓表能看格式、公式、列寬與多 Sheet 組合報(bào)表4.1 單元格格式字體、背景與邊框的調(diào)用路徑導(dǎo)出 Excel 不只是把數(shù)據(jù)塞進(jìn)去客戶(hù)的報(bào)表講究標(biāo)題行加粗、表頭有底色、金額列加千分位。XLSReadWriteII 沒(méi)有把格式攤平到每個(gè)單元格上屬性而是集中在 CellFormat 對(duì)象里這是一個(gè)值得適應(yīng)的設(shè)計(jì)先取到單元格的格式對(duì)象再逐項(xiàng)改屬性。var LFmt: TXLSCellFormat; begin LSheet : XLSReadWriteII1.Sheets[0]; LFmt : LSheet.CellFormat[1, 1]; LFmt.Font.Name : 微軟雅黑; LFmt.Font.Size : 11; LFmt.Font.Style : [fsBold]; LFmt.BackgroundColor : $00FDE9D9; LFmt.HorAlign : haCenter; end;邏輯說(shuō)明CellFormat[Row, Col]返回該單元格格式對(duì)象改動(dòng)立即生效Font.Style是集合類(lèi)型fsBold加粗BackgroundColor是 BGR 格式的 COLORREF$00FDE9D9是淺米黃色。參數(shù)說(shuō)明HorAlign的枚舉名不同版本有差別常見(jiàn)是haCenter或xlHAlignCenter編譯報(bào)錯(cuò)就按 CtrlClick 跳轉(zhuǎn)到枚舉定義里抄一個(gè)這不是什么丟人的事。一個(gè)容易被忽略的性能點(diǎn)如果整張表幾千行都要統(tǒng)一字體不要一行一行去設(shè) CellFormat而是先拿到行的默認(rèn)格式對(duì)象統(tǒng)一設(shè)置再只對(duì)個(gè)別單元格做覆蓋寫(xiě)入速度能差一個(gè)數(shù)量級(jí)。4.2 表格三件套列寬、行高與凍結(jié)窗格報(bào)表頭三樣列寬撐開(kāi)、表頭行加高、首列或首行凍結(jié)。XLSReadWriteII 的 Sheet 對(duì)象上直接提供了這幾個(gè)入口。XLSReadWriteII1.Sheets[0].Columns[1].Width : 18; XLSReadWriteII1.Sheets[0].Rows[1].Height : 28; XLSReadWriteII1.Sheets[0].FreezePanes : 1;邏輯說(shuō)明Columns[N].Width是第 N 列的寬度單位是字符寬度18 差不多能放下 18 個(gè)半角字符Rows[N].Height是行高單位是磅FreezePanes設(shè)置凍結(jié)區(qū)域填 1 表示凍結(jié)首行填 2 表示凍結(jié)前兩行這是導(dǎo)出報(bào)表時(shí)的慣用設(shè)置。參數(shù)說(shuō)明列寬給太小中文表頭會(huì)被撐成“自動(dòng)換行”的亂象一般中文表頭列給到 14 以上行高 28 是表頭常見(jiàn)值正文行高保持默認(rèn)即可不要全局統(tǒng)一改行高否則長(zhǎng)數(shù)字會(huì)顯示成#Excel 的列寬不足提示用戶(hù)會(huì)誤以為數(shù)據(jù)壞了。4.3 多 Sheet 操作新增、改名與順序調(diào)整多 Sheet 是 ERP 報(bào)表的常態(tài)一個(gè)匯總頁(yè)加一個(gè)明細(xì)頁(yè)或者按月份分 Sheet。XLSReadWriteII 的 Sheets 集合提供了與 Excel 操作一致的方法。var LNewSheet: TXLSSheet; begin LNewSheet : XLSReadWriteII1.Sheets.Add(明細(xì)); LNewSheet.AsString[1, 1] : 2026-01-01; XLSReadWriteII1.Sheets[1].Name : 匯總-2026; XLSReadWriteII1.Write; end;邏輯說(shuō)明Sheets.Add(明細(xì))在末尾新增 Sheet返回新 Sheet 對(duì)象Name直接改工作表名注意工作表名不能超過(guò) 31 個(gè)字符不能包含冒號(hào)、斜杠、問(wèn)號(hào)等 Excel 保留字符這也是常見(jiàn)報(bào)錯(cuò)來(lái)源。參數(shù)說(shuō)明Sheets[0]是默認(rèn)第一個(gè) Sheet新增后它在末尾要把它移動(dòng)到前面可以用Move方法具體名字以幫助為準(zhǔn)如果要從另一個(gè) Sheet 復(fù)制整塊區(qū)域直接兩層循環(huán)讀 A 寫(xiě) B 最穩(wěn)別指望一次調(diào)用搞定。4.4 公式導(dǎo)出保存公式還是保存計(jì)算結(jié)果寫(xiě)帶公式的 Excel 有兩種路線一是把公式字符串寫(xiě)進(jìn)去讓 Excel 打開(kāi)時(shí)自動(dòng)算二是把程序里已經(jīng)算好的值寫(xiě)進(jìn)去。XLSReadWriteII 兩者都支持但用法不同。// 方式一寫(xiě)公式主體 XLSReadWriteII1.Sheets[0].Cells[5, 4].Formula : SUM(B2:B4); // 方式二寫(xiě)入以等號(hào)開(kāi)頭的公式字符串 XLSReadWriteII1.Sheets[0].AsString[5, 4] : SUM(B2:B4);邏輯說(shuō)明Formula屬性是結(jié)構(gòu)化公式接口寫(xiě)入時(shí)不帶等號(hào)AsString寫(xiě)SUM(...)這種整串帶等號(hào)的文本打開(kāi)文件后會(huì)被 Excel 識(shí)別為公式。區(qū)別在于Formula接口更嚴(yán)格非法公式會(huì)在寫(xiě)入前報(bào)錯(cuò)AsString更寬容寫(xiě)錯(cuò)了也只是在 Excel 里顯示#NAME?。參數(shù)說(shuō)明如果你希望用戶(hù)打開(kāi)文件就能看到計(jì)算結(jié)果公式里引用的單元格必須在同一工作表或用完整跨表引用格式明細(xì)!B2如果程序里已經(jīng)有現(xiàn)成的計(jì)算結(jié)果我的建議是直接寫(xiě)數(shù)值而不是寫(xiě)公式一是文件體積小二是避免用戶(hù)誤改公式導(dǎo)致報(bào)表錯(cuò)誤。5. 避坑安裝、編譯與運(yùn)行期的高頻問(wèn)題排查5.1 組件面板里沒(méi)有 XLSReadWriteII 頁(yè)簽現(xiàn)象按 2.3 的步驟走完Components 面板里找不到對(duì)應(yīng)的頁(yè)或組件。原因最常見(jiàn)的是只 Build 了運(yùn)行時(shí)包沒(méi)有執(zhí)行 Install或者安裝時(shí)選的 bpl 是 32 位編譯產(chǎn)物而 Delphi 12 的 IDE 是 64 位進(jìn)程加載不了。解決回到包工程在 Project Manager 里確認(rèn)活動(dòng)配置是 Win64 Release重新 Build再到 Component Install Packages 里 Add 新生成的 bpl。裝完后如果頁(yè)簽還是沒(méi)出現(xiàn)關(guān)掉 IDE 重開(kāi)一次——設(shè)計(jì)時(shí)包注冊(cè)偶爾需要重啟 IDE 刷新工具面板這不是玄學(xué)是包緩存沒(méi)刷新。5.2 拖控件到窗體報(bào) Class Not Found 或 EReadError現(xiàn)象新建工程沒(méi)問(wèn)題但打開(kāi)一個(gè)老工程、把控件拖到窗體時(shí)IDE 報(bào)“類(lèi)不存在”窗體 DFM 加載失敗。原因這個(gè) erar 里的版本和工程里記錄的類(lèi)名/版本不一致。常見(jiàn)于你之前裝過(guò)另一個(gè)版本的 XLSReadWriteIIDFM 文件里存的是舊類(lèi)名新包沒(méi)有這個(gè)類(lèi)。解決先把舊版本包卸載干凈Component Install Packages 里移除舊 bpl再裝新版老工程打開(kāi)前用文本方式右鍵 DFM 選 Open As Text檢查一下記錄的控件類(lèi)名如果確實(shí)找不到對(duì)應(yīng)類(lèi)手動(dòng)刪除這一行再轉(zhuǎn)回窗體視圖。這一步要小心操作改 DFM 前先備份文件免得把工程改廢了。5.3 編譯程序報(bào)內(nèi)存錯(cuò)誤或 IDE 直接崩潰現(xiàn)象平時(shí)編譯正常引用 XLSReadWriteII 后一編譯就報(bào) Out of Memory 或 IDE 閃退。原因bpl/dcp 版本殘留IDE 加載了兩套同名單元的編譯緩存構(gòu)建時(shí)符號(hào)表沖突另外 Delphi 12.3 如果開(kāi)了殺毒軟件實(shí)時(shí)掃描構(gòu)建目錄大量讀寫(xiě)臨時(shí)文件也可能觸發(fā)異常。解決先在項(xiàng)目里刪掉所有 .dcu、.dcp 緩存實(shí)際處理是進(jìn)到 Packages\D12 目錄刪除編譯產(chǎn)物重新 Build 一次把 Delphi 的緩存目錄默認(rèn)是C:\Users\用戶(hù)名\AppData\Local\Embarcadero\BDS\xx.0\cache加進(jìn)殺毒軟件白名單。還不行就把 bpl 從系統(tǒng)目錄比如 System32里也清一遍有些安裝腳本會(huì)把 32 位 bpl 丟進(jìn) System32Delphi 12 的 64 位 IDE 去加載時(shí)對(duì)不上就崩。這個(gè)排查順序我踩過(guò)兩次基本都是緩存問(wèn)題不是控件本身的鍋。5.4 生成的 xlsx 打開(kāi)提示格式不匹配或 WPS 打不開(kāi)現(xiàn)象代碼運(yùn)行正常文件也生成了但用戶(hù)反饋 Excel 彈“文件格式和擴(kuò)展名不匹配”或者 WPS 直接打不開(kāi)。原因控件內(nèi)部統(tǒng)一按 BIFF 格式寫(xiě)文件文件后綴卻叫 .xlsx或者反過(guò)來(lái)設(shè)置了 xlsx 格式但Filename后綴是 .xls。解決在寫(xiě)文件前顯式指定格式版本不要只靠后綴推斷。到幫助文件里搜 FileVersion 或文件類(lèi)型枚舉按版本設(shè)置對(duì)應(yīng)的 xlsx 常量如果不糾結(jié) xlsx最省事的是把Filename后綴統(tǒng)一改成 .xls老格式兼容性反而更穩(wěn)。還有個(gè)小坑Excel 對(duì)“內(nèi)容含公式但文件后綴是 xlsx、格式版本還是 xls”的組合特別敏感描述就是這條。修法只有一個(gè)格式版本和后綴保持一致沒(méi)有捷徑。5.5 Read 大文件時(shí)內(nèi)存飆升現(xiàn)象Read 一個(gè) 100MB 以上的 xlsx程序內(nèi)存占用到 1GB界面卡死。原因控件默認(rèn)把整個(gè)工作簿解析到內(nèi)存包括每個(gè)單元格的格式對(duì)象。帶大量樣式的大文件內(nèi)存會(huì)被放大好幾倍。解決文件能拆就先拆在源端就把單 Sheet 控制在一個(gè)合理行數(shù)控件文檔里搜優(yōu)化相關(guān)選項(xiàng)開(kāi)啟低內(nèi)存寫(xiě)入模式后生成側(cè)的內(nèi)存占用能明顯降下來(lái)。讀側(cè)如果沒(méi)有優(yōu)化開(kāi)關(guān)務(wù)實(shí)做法是在 Excel 里另存為 CSV 再讓 Delphi 解析文本速度快且內(nèi)存可控。CSV 丟格式但你要的核心是數(shù)據(jù)格式本來(lái)也不該由導(dǎo)入端來(lái)保證。6. 一個(gè)值得養(yǎng)成的習(xí)慣用內(nèi)存流讀寫(xiě)并做寫(xiě)入后自校驗(yàn)批量導(dǎo)出報(bào)表的常見(jiàn)翻車(chē)現(xiàn)場(chǎng)是多個(gè)任務(wù)并發(fā)寫(xiě)同一個(gè)目錄下的文件互相把對(duì)方的文件鎖擠掉或者寫(xiě)到一半進(jìn)程被 kill 留下半個(gè)文件的臟數(shù)據(jù)。避免這些問(wèn)題我的做法是讓控件不碰文件系統(tǒng)直接用內(nèi)存流打交道寫(xiě)完立刻把流讀回來(lái)自校驗(yàn)一遍。var LStream: TMemoryStream; begin LStream : TMemoryStream.Create; try XLSReadWriteII1.Filename : report.xlsx; XLSReadWriteII1.Sheets[0].AsString[2, 2] : 2026-09-01; XLSReadWriteII1.SaveToStream(LStream); LStream.Position : 0; XLSReadWriteII1.LoadFromStream(LStream); Assert(XLSReadWriteII1.Sheets[0].AsString[2, 2] 2026-09-01, 寫(xiě)入后自校驗(yàn)失敗); finally LStream.Free; end; end;邏輯說(shuō)明SaveToStream把當(dāng)前工作簿寫(xiě)到流里這里不落盤(pán)LoadFromStream從流重建工作簿重建后讀回剛才寫(xiě)的單元格做斷言。Assert失敗說(shuō)明控件內(nèi)部生成的 xlsx 數(shù)據(jù)有問(wèn)題多數(shù)是格式版本不對(duì)導(dǎo)致寫(xiě)壞。參數(shù)說(shuō)明流操作后必須手動(dòng)Position : 0回卷否則 LoadFromStream 從末尾開(kāi)始讀讀出來(lái)的內(nèi)容是空的如果你是多線程生成報(bào)表每個(gè)線程有自己的 XLSReadWriteII 實(shí)例和流對(duì)象不要共享控件內(nèi)部有全局狀態(tài)跨線程共享實(shí)例會(huì)隨機(jī)崩潰。這套“內(nèi)存流 自校驗(yàn)”的習(xí)慣是從一次血淚教訓(xùn)里長(zhǎng)出來(lái)的。那次是服務(wù)器上定時(shí)任務(wù)生成幾十份報(bào)表直接寫(xiě)盤(pán)結(jié)果某天文件鎖沖突用戶(hù)拿到一份半截報(bào)表誤以為是系統(tǒng)算錯(cuò)了數(shù)據(jù)。后來(lái)所有報(bào)表統(tǒng)一改成流模式寫(xiě)完先把關(guān)鍵單元格讀回來(lái)核一遍再統(tǒng)一落到磁盤(pán)和備份目錄。合同數(shù)據(jù)、財(cái)務(wù)對(duì)賬這類(lèi)場(chǎng)景寧可多花幾十毫秒校驗(yàn)也不能把壞文件發(fā)出去。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取 Delphi 12.3中XLSReadWriteII控件讀寫(xiě)Excel的完整指南
簡(jiǎn)介針對(duì) Delphi 12.3 開(kāi)發(fā)環(huán)境的 XLSReadWriteII v6.01.17 控件包面向需要在桌面程序中實(shí)現(xiàn) Excel 文件讀寫(xiě)、報(bào)表生成與數(shù)據(jù)導(dǎo)出的中高級(jí) Delphi 開(kāi)發(fā)者。整套資源共 499 個(gè)文件壓縮后約 2.15MB以 pas 源碼為核心配套 dfm 表單、dpr 工程及 html 說(shuō)明文檔便于閱讀控件實(shí)現(xiàn)、查看界面布局與運(yùn)行示例項(xiàng)目。壓縮包內(nèi)還包含 dproj、inc、res 等工程配置文件以及少量 gif、jpg 插圖與示例用 fmx、cds 文件適合在 Delphi 12.3 環(huán)境下快速安裝引用并對(duì)照學(xué)習(xí)。已有 65 人瀏覽學(xué)習(xí)。通過(guò)該控件包可獲得完整的單元源碼、豐富的示例工程如網(wǎng)格、篩選、透視表、自動(dòng)過(guò)濾等場(chǎng)景以及相關(guān)的配置文件。對(duì)于需要處理復(fù)雜 Excel 模板、批量生成報(bào)表或集成表格交互的開(kāi)發(fā)者來(lái)說(shuō)這套資料能直接提供可編譯運(yùn)行的參考框架節(jié)省從底層協(xié)議開(kāi)始摸索的時(shí)間同時(shí)幫助熟悉 XLSReadWriteII 的常用對(duì)象模型與設(shè)計(jì)思路。1. 一個(gè) rar 包解決的 Delphi 12.3 讀寫(xiě) Excel 問(wèn)題拿到Delphi 12.3控件之XLSReadWriteII v6.01.17 D12.rar你先要理解它解決的核心矛盾Delphi 程序要導(dǎo)出帶格式的 xls/xlsx、要解析用戶(hù)丟過(guò)來(lái)的 Excel 報(bào)表但你又不想在服務(wù)器上裝 Office、不想跟 COM 的 Excel 進(jìn)程糾纏。XLSReadWriteII 是 Delphi 生態(tài)里專(zhuān)門(mén)做這件事的第三方控件D12后綴表示它跟隨 Delphi 12含 12.3 更新的編譯環(huán)境v6.01.17是它的版本號(hào)。適合做 ERP 報(bào)表、工業(yè)數(shù)據(jù)導(dǎo)出、批量導(dǎo)入落庫(kù)這類(lèi)活兒的 Delphi 開(kāi)發(fā)者。接下來(lái)的內(nèi)容我按解壓安裝、最小讀寫(xiě)、格式與多 Sheet、踩坑排查的順序把這個(gè)包從裝到用完整拆一遍。2. 裝進(jìn) Delphi 12.3包編譯、庫(kù)路徑與控件安裝驗(yàn)證2.1 先分清源碼包和編譯包別把它當(dāng) ActiveX 控件裝XLSReadWriteII 的發(fā)布 rar 解壓后常見(jiàn)布局是 Bin 放編譯好的 bpl/dcpSource 放 .pas 源碼Packages 里放對(duì)應(yīng)各版本 Delphi 的 .dpk/.dproj 工程文件旁邊一般還有 Docs 和 Demo 目錄。v6.01.17 D12這種發(fā)布包通常源碼和編譯產(chǎn)物都齊但我一般建議你直接走源碼編譯不要貪圖省事去拖 Bin 里現(xiàn)成的 bpl——Delphi 12.3 的 RTL 和編譯器版本比 11、比 12.0 都有更新別人機(jī)器上編出來(lái)的二進(jìn)制包放到你這里輕則點(diǎn)安裝沒(méi)反應(yīng)重則 IDE 直接報(bào)“模塊版本不匹配”。這里有個(gè)容易翻車(chē)的認(rèn)知XLSReadWriteII 是 VCL 原生控件包不是 ActiveX。所以別照搬那些用regsvr32注冊(cè) dll 的流程也不存在 PageOffice、LODOP 那種瀏覽器控件“安裝后依然提示讓安裝”的注冊(cè)表問(wèn)題更不用像遠(yuǎn)程桌面 ActiveX 那樣去系統(tǒng)路徑里找 rdclientax.dll。它在 Delphi 里的安裝路徑只有一條配置 Library Path → 編譯 .dpk → Install 設(shè)計(jì)時(shí)包。2.2 配置 Library Path讓 IDE 找得到源文件解壓后第一件事是把 Source 目錄加進(jìn) IDE 的庫(kù)路徑。打開(kāi) Tools Options Delphi Options Library在 Library Path 里追加一行。Delphi 12.3 里會(huì)同時(shí)存在 32 位和 64 位平臺(tái)配置Source 目錄是平臺(tái)無(wú)關(guān)的純 Pascal 源碼所以?xún)蓚€(gè)平臺(tái)的庫(kù)路徑都要加別只改了 Win32 就以為完事。D:\Components\XLSReadWriteII\Source D:\Components\XLSReadWriteII\Packages\D12第一行是單元文件所在第二行是包工程所在。加完點(diǎn) Save 后最簡(jiǎn)單驗(yàn)證方式是按 CtrlF12 打開(kāi) Project Manager或直接搜索單元名如果能在列表里看到 XLSReadWriteII2.pas 之類(lèi)的單元說(shuō)明路徑生效。注意 rar 解壓時(shí)如果帶了很深的子目錄比如Source\XLSReadWriteII\你要加的是包含 .pas 的那一層不是只加到Source就停否則編譯包時(shí)照樣報(bào)Unit not found。2.3 編譯并安裝設(shè)計(jì)時(shí)包建議在 Packages\D12 目錄里找 .dproj 工程文件Delphi 12.3 可以直接雙擊 dproj 打開(kāi)然后在 Project Manager 里對(duì)包工程右鍵選 Build。這一步會(huì)生成 .bpl 和 .dcp。對(duì)于命令行習(xí)慣的人用 msbuild 更可控cd /d D:\Components\XLSReadWriteII\Packages\D12 msbuild XLSReadWriteII.dproj /t:Build /p:ConfigRelease /p:PlatformWin64這里把文件名換成包里的實(shí)際 dproj。Delphi 12 的 IDE 是 64 位進(jìn)程設(shè)計(jì)時(shí)包必須按 Win64 編譯否則組件面板加載不到如果運(yùn)行時(shí)的目標(biāo)平臺(tái)是 Win32那你項(xiàng)目的編譯器和運(yùn)行庫(kù)要另外按 Win32 處理但 IDE 里裝的設(shè)計(jì)時(shí)包必須是 Win64。Build 成功后菜單 Component Install Packages點(diǎn) Add選中剛生成的 .bpl 文件確認(rèn)后工具面板會(huì)多出一個(gè) XLSReadWriteII 頁(yè)簽。2.4 裝完先跑一個(gè)最小工程驗(yàn)證新建一個(gè) VCL Application把 XLSReadWriteII 組件拖到窗體上放一個(gè) Button寫(xiě)一段最基礎(chǔ)的導(dǎo)出代碼運(yùn)行看能否正常生成文件。這一步能篩掉八成安裝問(wèn)題不要跳過(guò)。procedure TForm1.Button1Click(Sender: TObject); begin XLSReadWriteII1.Filename : D:\temp\demo.xlsx; XLSReadWriteII1.Sheets[0].AsString[1, 1] : Hello from Delphi 12.3; XLSReadWriteII1.Write; end;邏輯說(shuō)明Filename不只決定存到哪里還決定寫(xiě)出文件格式Sheets[0]是默認(rèn)第一張工作表AsString[行, 列]是控件最常用的單元格寫(xiě)入接口坐標(biāo)從 1 開(kāi)始計(jì)數(shù)。如果運(yùn)行后 D:\temp 下出現(xiàn)了 demo.xlsx 且用 Excel 能打開(kāi)看到字符串安裝鏈路就通了。如果運(yùn)行報(bào)File not found先回 2.2 檢查 Library Path 是否真的包含源碼目錄再把包重新 Build 一次。3. 最小讀寫(xiě)流程Sheet、單元格與數(shù)據(jù)類(lèi)型的調(diào)用模型3.1 為什么是 Sheet Cells 這套對(duì)象模型XLSReadWriteII 內(nèi)部把一本工作簿拆成 Sheets 集合Sheet 是操作的核心單元格讀寫(xiě)都掛在 Sheet 上。這套模型的好處是貼合 Excel 本身的結(jié)構(gòu)不像早期的一些控件拿二維數(shù)組硬套遇到合并單元格、多 Sheet 聯(lián)動(dòng)就露怯。讀 Excel 時(shí)它把整個(gè)文件解析進(jìn)內(nèi)存寫(xiě) Excel 時(shí)它是按 BIFF 或 OOXML 規(guī)范直接生成文件全程不啟動(dòng) Excel 進(jìn)程所以能用在服務(wù)端無(wú)人值守的導(dǎo)出任務(wù)里。3.2 寫(xiě)出多行數(shù)據(jù)AsFloat、AsDateTime 與自動(dòng)類(lèi)型只寫(xiě)字符串不夠用實(shí)際導(dǎo)出通常是混合類(lèi)型?？催@個(gè)示例var LSheet: TXLSSheet; begin LSheet : XLSReadWriteII1.Sheets[0]; LSheet.AsString[1, 1] : 訂單號(hào); LSheet.AsInteger[1, 2] : 10023; LSheet.AsDateTime[1, 3] : Now; LSheet.AsFloat[1, 4] : 1999.99; XLSReadWriteII1.Filename : order.xlsx; XLSReadWriteII1.Write; end;邏輯說(shuō)明AsInteger寫(xiě)整數(shù)AsDateTime寫(xiě)日期時(shí)間AsFloat寫(xiě)小數(shù)。特別提醒AsDateTimeExcel 里的日期本質(zhì)是序列號(hào)如果你用AsString去寫(xiě)日期值寫(xiě)出來(lái)的是“44835.5”這種數(shù)字文本用戶(hù)打開(kāi)表格看到一串小數(shù)會(huì)以為導(dǎo)出程序壞了。參數(shù)說(shuō)明日期寫(xiě)入前確認(rèn)Now的時(shí)區(qū)信息是否需要轉(zhuǎn)換為本地時(shí)區(qū)服務(wù)端生成報(bào)表尤其要注意 UTC 和本地時(shí)間的差異最好在寫(xiě)入前統(tǒng)一var轉(zhuǎn)換。3.3 讀回?cái)?shù)據(jù)到界面把握 LastRow 和 LastCol讀操作是重點(diǎn)場(chǎng)景用戶(hù)表格可能有空行、有合并單元格但多數(shù)情況我們要的是規(guī)整的矩形區(qū)域。下面這段把內(nèi)容讀進(jìn) Memo注意邊界判定var LRow, LCol: Integer; LSheet: TXLSSheet; LLine: string; begin XLSReadWriteII1.Filename : input.xlsx; XLSReadWriteII1.Read; LSheet : XLSReadWriteII1.Sheets[0]; for LRow : 1 to LSheet.LastRow do begin LLine : ; for LCol : 1 to LSheet.LastCol do LLine : LLine LSheet.AsString[LRow, LCol] #9; Memo1.Lines.Add(LLine); end; end;邏輯說(shuō)明LastRow和LastCol返回的是 Sheet 實(shí)際有內(nèi)容的最后行和最后列用它做循環(huán)上限不會(huì)越界。參數(shù)說(shuō)明AsString讀取時(shí)會(huì)把其他類(lèi)型自動(dòng)轉(zhuǎn)成字符串但AsFloat取出來(lái)的小數(shù)位數(shù)受單元格格式影響格式化時(shí)最好用Format(%.2f, [...])固定精度。這個(gè)讀法適合中小文件幾十 MB 以?xún)?nèi)的 Excel 直接全量讀入內(nèi)存問(wèn)題不大超過(guò)這個(gè)量級(jí)建議在 Excel 里先做預(yù)處理或換用流式方案后面第六章會(huì)聊。3.4 單元格是否為空Type 判斷和 IsEmpty 的坑讀用戶(hù)傳上來(lái)的 Excel最麻煩的是混著空格和真空值。一行里某列既有公式算出空串又有物理空單元格統(tǒng)一讀出來(lái)都是空字符串。var LCell: TXLSCell; begin LCell : XLSReadWriteII1.Sheets[0].Cells[3, 2]; if LCell.IsEmpty then ShowMessage(這個(gè)單元格什么也沒(méi)有) else if LCell.DataType xlsString then ShowMessage(字符串 LCell.AsString); end;邏輯說(shuō)明Cells[Row, Col]返回單元格對(duì)象IsEmpty判斷物理上是否沒(méi)有任何值DataType返回類(lèi)型枚舉。這個(gè)判斷比直接比對(duì)AsString 可靠因?yàn)楣接?jì)算出的空結(jié)果和真空值在后續(xù)落庫(kù)時(shí)語(yǔ)義完全不同。參數(shù)說(shuō)明不同小版本里IsEmpty的命名可能略有差異有的版本叫Empty如果你編譯時(shí)提示找不到到隨包 CHM 幫助里搜“IsEmpty”看準(zhǔn)確名稱(chēng)不影響整體邏輯。4. 讓表能看格式、公式、列寬與多 Sheet 組合報(bào)表4.1 單元格格式字體、背景與邊框的調(diào)用路徑導(dǎo)出 Excel 不只是把數(shù)據(jù)塞進(jìn)去客戶(hù)的報(bào)表講究標(biāo)題行加粗、表頭有底色、金額列加千分位。XLSReadWriteII 沒(méi)有把格式攤平到每個(gè)單元格上屬性而是集中在 CellFormat 對(duì)象里這是一個(gè)值得適應(yīng)的設(shè)計(jì)先取到單元格的格式對(duì)象再逐項(xiàng)改屬性。var LFmt: TXLSCellFormat; begin LSheet : XLSReadWriteII1.Sheets[0]; LFmt : LSheet.CellFormat[1, 1]; LFmt.Font.Name : 微軟雅黑; LFmt.Font.Size : 11; LFmt.Font.Style : [fsBold]; LFmt.BackgroundColor : $00FDE9D9; LFmt.HorAlign : haCenter; end;邏輯說(shuō)明CellFormat[Row, Col]返回該單元格格式對(duì)象改動(dòng)立即生效Font.Style是集合類(lèi)型fsBold加粗BackgroundColor是 BGR 格式的 COLORREF$00FDE9D9是淺米黃色。參數(shù)說(shuō)明HorAlign的枚舉名不同版本有差別常見(jiàn)是haCenter或xlHAlignCenter編譯報(bào)錯(cuò)就按 CtrlClick 跳轉(zhuǎn)到枚舉定義里抄一個(gè)這不是什么丟人的事。一個(gè)容易被忽略的性能點(diǎn)如果整張表幾千行都要統(tǒng)一字體不要一行一行去設(shè) CellFormat而是先拿到行的默認(rèn)格式對(duì)象統(tǒng)一設(shè)置再只對(duì)個(gè)別單元格做覆蓋寫(xiě)入速度能差一個(gè)數(shù)量級(jí)。4.2 表格三件套列寬、行高與凍結(jié)窗格報(bào)表頭三樣列寬撐開(kāi)、表頭行加高、首列或首行凍結(jié)。XLSReadWriteII 的 Sheet 對(duì)象上直接提供了這幾個(gè)入口。XLSReadWriteII1.Sheets[0].Columns[1].Width : 18; XLSReadWriteII1.Sheets[0].Rows[1].Height : 28; XLSReadWriteII1.Sheets[0].FreezePanes : 1;邏輯說(shuō)明Columns[N].Width是第 N 列的寬度單位是字符寬度18 差不多能放下 18 個(gè)半角字符Rows[N].Height是行高單位是磅FreezePanes設(shè)置凍結(jié)區(qū)域填 1 表示凍結(jié)首行填 2 表示凍結(jié)前兩行這是導(dǎo)出報(bào)表時(shí)的慣用設(shè)置。參數(shù)說(shuō)明列寬給太小中文表頭會(huì)被撐成“自動(dòng)換行”的亂象一般中文表頭列給到 14 以上行高 28 是表頭常見(jiàn)值正文行高保持默認(rèn)即可不要全局統(tǒng)一改行高否則長(zhǎng)數(shù)字會(huì)顯示成#Excel 的列寬不足提示用戶(hù)會(huì)誤以為數(shù)據(jù)壞了。4.3 多 Sheet 操作新增、改名與順序調(diào)整多 Sheet 是 ERP 報(bào)表的常態(tài)一個(gè)匯總頁(yè)加一個(gè)明細(xì)頁(yè)或者按月份分 Sheet。XLSReadWriteII 的 Sheets 集合提供了與 Excel 操作一致的方法。var LNewSheet: TXLSSheet; begin LNewSheet : XLSReadWriteII1.Sheets.Add(明細(xì)); LNewSheet.AsString[1, 1] : 2026-01-01; XLSReadWriteII1.Sheets[1].Name : 匯總-2026; XLSReadWriteII1.Write; end;邏輯說(shuō)明Sheets.Add(明細(xì))在末尾新增 Sheet返回新 Sheet 對(duì)象Name直接改工作表名注意工作表名不能超過(guò) 31 個(gè)字符不能包含冒號(hào)、斜杠、問(wèn)號(hào)等 Excel 保留字符這也是常見(jiàn)報(bào)錯(cuò)來(lái)源。參數(shù)說(shuō)明Sheets[0]是默認(rèn)第一個(gè) Sheet新增后它在末尾要把它移動(dòng)到前面可以用Move方法具體名字以幫助為準(zhǔn)如果要從另一個(gè) Sheet 復(fù)制整塊區(qū)域直接兩層循環(huán)讀 A 寫(xiě) B 最穩(wěn)別指望一次調(diào)用搞定。4.4 公式導(dǎo)出保存公式還是保存計(jì)算結(jié)果寫(xiě)帶公式的 Excel 有兩種路線一是把公式字符串寫(xiě)進(jìn)去讓 Excel 打開(kāi)時(shí)自動(dòng)算二是把程序里已經(jīng)算好的值寫(xiě)進(jìn)去。XLSReadWriteII 兩者都支持但用法不同。// 方式一寫(xiě)公式主體 XLSReadWriteII1.Sheets[0].Cells[5, 4].Formula : SUM(B2:B4); // 方式二寫(xiě)入以等號(hào)開(kāi)頭的公式字符串 XLSReadWriteII1.Sheets[0].AsString[5, 4] : SUM(B2:B4);邏輯說(shuō)明Formula屬性是結(jié)構(gòu)化公式接口寫(xiě)入時(shí)不帶等號(hào)AsString寫(xiě)SUM(...)這種整串帶等號(hào)的文本打開(kāi)文件后會(huì)被 Excel 識(shí)別為公式。區(qū)別在于Formula接口更嚴(yán)格非法公式會(huì)在寫(xiě)入前報(bào)錯(cuò)AsString更寬容寫(xiě)錯(cuò)了也只是在 Excel 里顯示#NAME?。參數(shù)說(shuō)明如果你希望用戶(hù)打開(kāi)文件就能看到計(jì)算結(jié)果公式里引用的單元格必須在同一工作表或用完整跨表引用格式明細(xì)!B2如果程序里已經(jīng)有現(xiàn)成的計(jì)算結(jié)果我的建議是直接寫(xiě)數(shù)值而不是寫(xiě)公式一是文件體積小二是避免用戶(hù)誤改公式導(dǎo)致報(bào)表錯(cuò)誤。5. 避坑安裝、編譯與運(yùn)行期的高頻問(wèn)題排查5.1 組件面板里沒(méi)有 XLSReadWriteII 頁(yè)簽現(xiàn)象按 2.3 的步驟走完Components 面板里找不到對(duì)應(yīng)的頁(yè)或組件。原因最常見(jiàn)的是只 Build 了運(yùn)行時(shí)包沒(méi)有執(zhí)行 Install或者安裝時(shí)選的 bpl 是 32 位編譯產(chǎn)物而 Delphi 12 的 IDE 是 64 位進(jìn)程加載不了。解決回到包工程在 Project Manager 里確認(rèn)活動(dòng)配置是 Win64 Release重新 Build再到 Component Install Packages 里 Add 新生成的 bpl。裝完后如果頁(yè)簽還是沒(méi)出現(xiàn)關(guān)掉 IDE 重開(kāi)一次——設(shè)計(jì)時(shí)包注冊(cè)偶爾需要重啟 IDE 刷新工具面板這不是玄學(xué)是包緩存沒(méi)刷新。5.2 拖控件到窗體報(bào) Class Not Found 或 EReadError現(xiàn)象新建工程沒(méi)問(wèn)題但打開(kāi)一個(gè)老工程、把控件拖到窗體時(shí)IDE 報(bào)“類(lèi)不存在”窗體 DFM 加載失敗。原因這個(gè) erar 里的版本和工程里記錄的類(lèi)名/版本不一致。常見(jiàn)于你之前裝過(guò)另一個(gè)版本的 XLSReadWriteIIDFM 文件里存的是舊類(lèi)名新包沒(méi)有這個(gè)類(lèi)。解決先把舊版本包卸載干凈Component Install Packages 里移除舊 bpl再裝新版老工程打開(kāi)前用文本方式右鍵 DFM 選 Open As Text檢查一下記錄的控件類(lèi)名如果確實(shí)找不到對(duì)應(yīng)類(lèi)手動(dòng)刪除這一行再轉(zhuǎn)回窗體視圖。這一步要小心操作改 DFM 前先備份文件免得把工程改廢了。5.3 編譯程序報(bào)內(nèi)存錯(cuò)誤或 IDE 直接崩潰現(xiàn)象平時(shí)編譯正常引用 XLSReadWriteII 后一編譯就報(bào) Out of Memory 或 IDE 閃退。原因bpl/dcp 版本殘留IDE 加載了兩套同名單元的編譯緩存構(gòu)建時(shí)符號(hào)表沖突另外 Delphi 12.3 如果開(kāi)了殺毒軟件實(shí)時(shí)掃描構(gòu)建目錄大量讀寫(xiě)臨時(shí)文件也可能觸發(fā)異常。解決先在項(xiàng)目里刪掉所有 .dcu、.dcp 緩存實(shí)際處理是進(jìn)到 Packages\D12 目錄刪除編譯產(chǎn)物重新 Build 一次把 Delphi 的緩存目錄默認(rèn)是C:\Users\用戶(hù)名\AppData\Local\Embarcadero\BDS\xx.0\cache加進(jìn)殺毒軟件白名單。還不行就把 bpl 從系統(tǒng)目錄比如 System32里也清一遍有些安裝腳本會(huì)把 32 位 bpl 丟進(jìn) System32Delphi 12 的 64 位 IDE 去加載時(shí)對(duì)不上就崩。這個(gè)排查順序我踩過(guò)兩次基本都是緩存問(wèn)題不是控件本身的鍋。5.4 生成的 xlsx 打開(kāi)提示格式不匹配或 WPS 打不開(kāi)現(xiàn)象代碼運(yùn)行正常文件也生成了但用戶(hù)反饋 Excel 彈“文件格式和擴(kuò)展名不匹配”或者 WPS 直接打不開(kāi)。原因控件內(nèi)部統(tǒng)一按 BIFF 格式寫(xiě)文件文件后綴卻叫 .xlsx或者反過(guò)來(lái)設(shè)置了 xlsx 格式但Filename后綴是 .xls。解決在寫(xiě)文件前顯式指定格式版本不要只靠后綴推斷。到幫助文件里搜 FileVersion 或文件類(lèi)型枚舉按版本設(shè)置對(duì)應(yīng)的 xlsx 常量如果不糾結(jié) xlsx最省事的是把Filename后綴統(tǒng)一改成 .xls老格式兼容性反而更穩(wěn)。還有個(gè)小坑Excel 對(duì)“內(nèi)容含公式但文件后綴是 xlsx、格式版本還是 xls”的組合特別敏感描述就是這條。修法只有一個(gè)格式版本和后綴保持一致沒(méi)有捷徑。5.5 Read 大文件時(shí)內(nèi)存飆升現(xiàn)象Read 一個(gè) 100MB 以上的 xlsx程序內(nèi)存占用到 1GB界面卡死。原因控件默認(rèn)把整個(gè)工作簿解析到內(nèi)存包括每個(gè)單元格的格式對(duì)象。帶大量樣式的大文件內(nèi)存會(huì)被放大好幾倍。解決文件能拆就先拆在源端就把單 Sheet 控制在一個(gè)合理行數(shù)控件文檔里搜優(yōu)化相關(guān)選項(xiàng)開(kāi)啟低內(nèi)存寫(xiě)入模式后生成側(cè)的內(nèi)存占用能明顯降下來(lái)。讀側(cè)如果沒(méi)有優(yōu)化開(kāi)關(guān)務(wù)實(shí)做法是在 Excel 里另存為 CSV 再讓 Delphi 解析文本速度快且內(nèi)存可控。CSV 丟格式但你要的核心是數(shù)據(jù)格式本來(lái)也不該由導(dǎo)入端來(lái)保證。6. 一個(gè)值得養(yǎng)成的習(xí)慣用內(nèi)存流讀寫(xiě)并做寫(xiě)入后自校驗(yàn)批量導(dǎo)出報(bào)表的常見(jiàn)翻車(chē)現(xiàn)場(chǎng)是多個(gè)任務(wù)并發(fā)寫(xiě)同一個(gè)目錄下的文件互相把對(duì)方的文件鎖擠掉或者寫(xiě)到一半進(jìn)程被 kill 留下半個(gè)文件的臟數(shù)據(jù)。避免這些問(wèn)題我的做法是讓控件不碰文件系統(tǒng)直接用內(nèi)存流打交道寫(xiě)完立刻把流讀回來(lái)自校驗(yàn)一遍。var LStream: TMemoryStream; begin LStream : TMemoryStream.Create; try XLSReadWriteII1.Filename : report.xlsx; XLSReadWriteII1.Sheets[0].AsString[2, 2] : 2026-09-01; XLSReadWriteII1.SaveToStream(LStream); LStream.Position : 0; XLSReadWriteII1.LoadFromStream(LStream); Assert(XLSReadWriteII1.Sheets[0].AsString[2, 2] 2026-09-01, 寫(xiě)入后自校驗(yàn)失敗); finally LStream.Free; end; end;邏輯說(shuō)明SaveToStream把當(dāng)前工作簿寫(xiě)到流里這里不落盤(pán)LoadFromStream從流重建工作簿重建后讀回剛才寫(xiě)的單元格做斷言。Assert失敗說(shuō)明控件內(nèi)部生成的 xlsx 數(shù)據(jù)有問(wèn)題多數(shù)是格式版本不對(duì)導(dǎo)致寫(xiě)壞。參數(shù)說(shuō)明流操作后必須手動(dòng)Position : 0回卷否則 LoadFromStream 從末尾開(kāi)始讀讀出來(lái)的內(nèi)容是空的如果你是多線程生成報(bào)表每個(gè)線程有自己的 XLSReadWriteII 實(shí)例和流對(duì)象不要共享控件內(nèi)部有全局狀態(tài)跨線程共享實(shí)例會(huì)隨機(jī)崩潰。這套“內(nèi)存流 自校驗(yàn)”的習(xí)慣是從一次血淚教訓(xùn)里長(zhǎng)出來(lái)的。那次是服務(wù)器上定時(shí)任務(wù)生成幾十份報(bào)表直接寫(xiě)盤(pán)結(jié)果某天文件鎖沖突用戶(hù)拿到一份半截報(bào)表誤以為是系統(tǒng)算錯(cuò)了數(shù)據(jù)。后來(lái)所有報(bào)表統(tǒng)一改成流模式寫(xiě)完先把關(guān)鍵單元格讀回來(lái)核一遍再統(tǒng)一落到磁盤(pán)和備份目錄。合同數(shù)據(jù)、財(cái)務(wù)對(duì)賬這類(lèi)場(chǎng)景寧可多花幾十毫秒校驗(yàn)也不能把壞文件發(fā)出去。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取