簡(jiǎn)介本資源面向在 Windows 平臺(tái)下使用 C 讀取 Excel 的開(kāi)發(fā)者重點(diǎn)演示如何借助 VS2010 的 MFC 框架調(diào)用 WPS Office 接口讀取 XLSX 文件。內(nèi)容圍繞 WPS 動(dòng)態(tài)庫(kù)加載、接口函數(shù)指針獲取、工作簿與工作表遍歷、單元格數(shù)據(jù)解析及 MFC 界面顯示等環(huán)節(jié)展開(kāi)適合具備一定 C 與 MFC 基礎(chǔ)、需要在不依賴 Microsoft Office 環(huán)境下處理表格數(shù)據(jù)的讀者參考。壓縮包共 29 個(gè)文件以 12 個(gè) h 頭文件與 3 個(gè) cpp 源文件為核心另有 sln、vcxproj 等工程配置及 rc、ico 等界面資源整體約 19.6MB工程結(jié)構(gòu)完整可直接編譯調(diào)試。目前已有 1807 人學(xué)習(xí)下載。通過(guò)該示例可掌握 WPS 接口調(diào)用流程、XLSX 數(shù)據(jù)解析思路與常見(jiàn)錯(cuò)誤處理方式并據(jù)此擴(kuò)展出符合自身業(yè)務(wù)需求的表格讀取模塊。1. 用 C 通過(guò) WPS 讀取 xlsx一條被低估的落地路徑上周幫一個(gè)做工業(yè)數(shù)據(jù)采集的朋友排查問(wèn)題他的 C 程序需要讀取現(xiàn)場(chǎng) Excel 報(bào)表但現(xiàn)場(chǎng)機(jī)器只裝了 WPS沒(méi)裝 Microsoft Office。他一開(kāi)始用 COM 組件調(diào) Excel.Application結(jié)果直接報(bào)「無(wú)效的類字符串」程序卡死在 CoCreateInstance。這不是個(gè)例——很多工控、醫(yī)療、財(cái)務(wù)場(chǎng)景的終端環(huán)境都是 WPS 打底C 想讀 xlsx要么繞開(kāi) Office 依賴要么就得學(xué)會(huì)跟 WPS 的 COM 接口打交道。這篇筆記拆的就是「C 通過(guò) WPS 讀取 Excel」這條路徑。它解決的核心問(wèn)題是在只有 WPS 的 Windows 環(huán)境下用 C 穩(wěn)定讀取 xlsx 的單元格、區(qū)域和公式結(jié)果。適合兩類人一是維護(hù)老 MFC/Qt 項(xiàng)目、必須走 COM 的工程師二是想評(píng)估「WPS 自動(dòng)化 vs 純解析庫(kù)」選型邊界的開(kāi)發(fā)者。下面從原理、環(huán)境、代碼到踩坑一步步拆開(kāi)。2. 先搞懂 WPS 的 COM 接口為什么 Excel.Application 會(huì)翻車2.1 WPS 的 ProgID 與 Excel 的差異Microsoft Office 的 Excel 對(duì)外暴露的 ProgID 是Excel.Application而 WPS 表格對(duì)應(yīng)的 ProgID 是KET.Application部分版本也兼容ET.Application。這是第一個(gè)分水嶺如果你的代碼里寫死了Excel.Application在純 WPS 環(huán)境下 CoCreateInstance 會(huì)直接返回REGDB_E_CLASSNOTREG也就是「類未注冊(cè)」。WPS 的 COM 接口在設(shè)計(jì)上盡量兼容 Excel 的對(duì)象模型Workbooks、Worksheets、Range、Cells這些對(duì)象名基本一致所以遷移成本主要集中在前期的創(chuàng)建和釋放環(huán)節(jié)。但兼容不等于等價(jià)后面會(huì)講到幾個(gè)關(guān)鍵差異點(diǎn)。常見(jiàn)做法是先嘗試KET.Application失敗再回退到Excel.Application這樣同一份代碼在兩種環(huán)境下都能跑。我一般會(huì)封裝一個(gè)CreateExcelApp函數(shù)把 ProgID 探測(cè)邏輯收進(jìn)去避免散落在業(yè)務(wù)代碼里。2.2 環(huán)境準(zhǔn)備注冊(cè)表、位數(shù)與權(quán)限在動(dòng)手寫代碼前有三件事必須先確認(rèn)否則后面全是玄學(xué)問(wèn)題。第一確認(rèn) WPS 的 COM 組件已注冊(cè)。打開(kāi)注冊(cè)表編輯器定位到HKEY_CLASSES_ROOT\KET.Application如果這個(gè)鍵存在說(shuō)明 WPS 表格的自動(dòng)化接口可用。如果不存在通常是安裝時(shí)沒(méi)勾選「WPS 表格組件」或者裝的是精簡(jiǎn)版。第二確認(rèn)位數(shù)匹配。你的 C 程序是 32 位還是 64 位必須和 WPS 的 COM 服務(wù)器位數(shù)一致。64 位程序調(diào) 32 位 COM 服務(wù)器會(huì)失敗反之亦然?，F(xiàn)場(chǎng)排查時(shí)用任務(wù)管理器看一眼 WPS 進(jìn)程的「平臺(tái)」列就能確認(rèn)。第三權(quán)限問(wèn)題。如果程序以服務(wù)方式運(yùn)行或者在高完整性級(jí)別下運(yùn)行而 WPS 以普通用戶權(quán)限運(yùn)行COM 跨權(quán)限調(diào)用會(huì)被 UAC 攔截。常見(jiàn)做法是把程序清單里的requestedExecutionLevel設(shè)為asInvoker避免不必要的提權(quán)。提示不要用管理員權(quán)限去跑讀取 Excel 的程序除非確實(shí)需要寫系統(tǒng)目錄。提權(quán)只會(huì)讓 COM 激活更容易失敗。2.3 一個(gè)最小可跑的 COM 調(diào)用骨架下面這段代碼是讀取 xlsx 的最小骨架用KET.Application創(chuàng)建實(shí)例打開(kāi)工作簿讀取 A1 單元格的值。編譯時(shí)需要包含comdef.h和atlbase.h并鏈接ole32.lib、oleaut32.lib。#include windows.h #include comdef.h #include atlbase.h #include iostream // 初始化 COM嘗試創(chuàng)建 WPS 表格應(yīng)用實(shí)例 int main() { HRESULT hr CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED); if (FAILED(hr)) { std::cerr COM 初始化失敗: std::hex hr std::endl; return -1; } CComPtrIDispatch spApp; // 優(yōu)先嘗試 WPS 的 ProgID hr spApp.CoCreateInstance(LKET.Application); if (FAILED(hr)) { // 回退到 Microsoft Excel hr spApp.CoCreateInstance(LExcel.Application); } if (FAILED(hr)) { std::cerr 無(wú)法創(chuàng)建 Excel/WPS 實(shí)例: std::hex hr std::endl; CoUninitialize(); return -1; } // 設(shè)置 Visible 為 false避免彈窗 CComVariant vVisible(false); spApp.InvokeHelper(0x0000012E, DISPATCH_PROPERTYPUT, vVisible); // Visible 的 DISPID 因版本而異建議用 GetIDsOfNames // 打開(kāi)工作簿 CComPtrIDispatch spWorkbooks; { CComVariant vResult; spApp.GetPropertyByName(LWorkbooks, spWorkbooks); } CComPtrIDispatch spWorkbook; { CComVariant vFileName(LC:\\test\\demo.xlsx); CComVariant vResult; // Workbooks.Open 的參數(shù)較多這里用 Invoke 簡(jiǎn)化示意 // 實(shí)際項(xiàng)目中建議用 GetIDsOfNames 獲取 Open 的 DISPID } // ... 后續(xù)讀取 Cells 的代碼 CoUninitialize(); return 0; }上面這段代碼故意留了兩個(gè)「坑點(diǎn)」一是InvokeHelper里硬編碼 DISPID 不可靠不同 WPS 版本的 DISPID 可能不同二是Workbooks.Open的參數(shù)列表很長(zhǎng)直接 Invoke 容易傳錯(cuò)。下一章會(huì)給出更穩(wěn)妥的封裝方式。邏輯說(shuō)明CoInitializeEx用COINIT_APARTMENTTHREADED是因?yàn)?COM 自動(dòng)化對(duì)象通常是 STA 模型用 MTA 可能導(dǎo)致跨線程調(diào)用異常。CComPtr是 ATL 的智能指針自動(dòng)管理引用計(jì)數(shù)避免手動(dòng) Release 漏掉。參數(shù)方面CoCreateInstance的第一個(gè)參數(shù)是 ProgID第二個(gè)參數(shù)是聚合對(duì)象通常 nullptr第三個(gè)是上下文CLSCTX_LOCAL_SERVER表示本地服務(wù)器第四個(gè)是接口 IID。3. 封裝一個(gè)可復(fù)用的 WPS 讀取類從 Open 到 Range 取值3.1 用 GetIDsOfNames 替代硬編碼 DISPID上一章的骨架里InvokeHelper硬編碼 DISPID 是個(gè)隱患。正確做法是用GetIDsOfNames根據(jù)方法名動(dòng)態(tài)獲取 DISPID。下面封裝一個(gè)InvokeByName輔助函數(shù)把「按名字調(diào)用」這件事統(tǒng)一處理。// 輔助函數(shù)根據(jù)方法名獲取 DISPID 并調(diào)用 HRESULT InvokeByName(IDispatch* pDisp, const wchar_t* name, WORD flags, DISPPARAMS* pParams, VARIANT* pResult) { if (!pDisp) return E_POINTER; DISPID dispid; OLECHAR* names[] { const_castOLECHAR*(name) }; HRESULT hr pDisp-GetIDsOfNames(IID_NULL, names, 1, LOCALE_USER_DEFAULT, dispid); if (FAILED(hr)) return hr; return pDisp-Invoke(dispid, IID_NULL, LOCALE_USER_DEFAULT, flags, pParams, pResult, nullptr, nullptr); }邏輯說(shuō)明GetIDsOfNames的第二個(gè)參數(shù)是名字?jǐn)?shù)組第三個(gè)參數(shù)是名字?jǐn)?shù)量第四個(gè)是語(yǔ)言環(huán)境。Invoke的flags參數(shù)決定是調(diào)用方法DISPATCH_METHOD還是讀寫屬性DISPATCH_PROPERTYGET/DISPATCH_PROPERTYPUT。參數(shù)說(shuō)明pParams是DISPPARAMS結(jié)構(gòu)里面包含參數(shù)數(shù)組和命名參數(shù)調(diào)用方法時(shí)參數(shù)順序是逆序的這點(diǎn)很容易搞反。3.2 打開(kāi)工作簿與讀取單元格的完整流程有了InvokeByName打開(kāi)工作簿和讀取單元格就順了。下面這段代碼演示從創(chuàng)建實(shí)例到讀取 A1 值的完整鏈路關(guān)鍵步驟都加了注釋。// 打開(kāi)工作簿并讀取 A1 單元格 CComPtrIDispatch OpenWorkbook(IDispatch* pApp, const std::wstring path) { // 獲取 Workbooks 集合 CComPtrIDispatch spWorkbooks; CComVariant vWorkbooks; InvokeByName(pApp, LWorkbooks, DISPATCH_PROPERTYGET, nullptr, vWorkbooks); spWorkbooks vWorkbooks.pdispVal; // 準(zhǔn)備 Open 的參數(shù)FileName, UpdateLinks, ReadOnly, ... // DISPPARAMS 的參數(shù)是逆序的所以最后一個(gè)參數(shù)放最前面 CComVariant vFileName(path.c_str()); CComVariant vUpdateLinks(0); // 不更新鏈接 CComVariant vReadOnly(true); // 只讀打開(kāi)避免鎖文件 VARIANT args[] { vReadOnly, vUpdateLinks, vFileName }; DISPPARAMS dp { args, nullptr, 3, 0 }; CComVariant vWorkbook; HRESULT hr InvokeByName(spWorkbooks, LOpen, DISPATCH_METHOD, dp, vWorkbook); if (FAILED(hr)) { std::cerr 打開(kāi)工作簿失敗: std::hex hr std::endl; return nullptr; } return vWorkbook.pdispVal; } // 讀取指定工作表的單元格值 CComVariant ReadCell(IDispatch* pWorkbook, const std::wstring sheetName, const std::wstring cellAddr) { // 獲取 Worksheets 集合 CComVariant vSheets; InvokeByName(pWorkbook, LWorksheets, DISPATCH_PROPERTYGET, nullptr, vSheets); CComPtrIDispatch spSheets vSheets.pdispVal; // 按名稱獲取工作表 CComVariant vSheetName(sheetName.c_str()); VARIANT sheetArgs[] { vSheetName }; DISPPARAMS sheetDp { sheetArgs, nullptr, 1, 0 }; CComVariant vSheet; InvokeByName(spSheets, LItem, DISPATCH_PROPERTYGET, sheetDp, vSheet); CComPtrIDispatch spSheet vSheet.pdispVal; // 獲取 Range CComVariant vAddr(cellAddr.c_str()); VARIANT rangeArgs[] { vAddr }; DISPPARAMS rangeDp { rangeArgs, nullptr, 1, 0 }; CComVariant vRange; InvokeByName(spSheet, LRange, DISPATCH_PROPERTYGET, rangeDp, vRange); CComPtrIDispatch spRange vRange.pdispVal; // 讀取 Value CComVariant vValue; InvokeByName(spRange, LValue, DISPATCH_PROPERTYGET, nullptr, vValue); return vValue; }邏輯說(shuō)明Workbooks.Open的參數(shù)順序在 COM 里是逆序的所以FileName放在args數(shù)組的最后。ReadOnly設(shè)為true是個(gè)好習(xí)慣避免程序占用文件導(dǎo)致用戶無(wú)法編輯。Worksheets.Item既可以傳索引也可以傳名稱傳名稱時(shí)如果工作表不存在會(huì)拋異常實(shí)際項(xiàng)目中要加 try-catch 或者先遍歷判斷。參數(shù)說(shuō)明DISPATCH_PROPERTYGET用于讀屬性DISPATCH_PROPERTYPUT用于寫屬性DISPATCH_METHOD用于調(diào)方法。DISPPARAMS的cArgs是參數(shù)個(gè)數(shù)rgdispidNamedArgs用于命名參數(shù)通常 nullptrcNamedArgs是命名參數(shù)個(gè)數(shù)。3.3 批量讀取區(qū)域比逐單元格快一個(gè)數(shù)量級(jí)逐單元格讀Cells(i, j)在數(shù)據(jù)量大時(shí)會(huì)非常慢因?yàn)槊看慰邕M(jìn)程調(diào)用都有開(kāi)銷。正確做法是用Range一次性讀取整個(gè)區(qū)域拿到一個(gè)二維VARIANT數(shù)組再在本地遍歷。// 批量讀取 A1:C100 區(qū)域返回二維數(shù)組 void ReadRange(IDispatch* pSheet, const std::wstring addr) { CComVariant vAddr(addr.c_str()); VARIANT rangeArgs[] { vAddr }; DISPPARAMS dp { rangeArgs, nullptr, 1, 0 }; CComVariant vRange; InvokeByName(pSheet, LRange, DISPATCH_PROPERTYGET, dp, vRange); CComVariant vValues; InvokeByName(vRange.pdispVal, LValue, DISPATCH_PROPERTYGET, nullptr, vValues); // vValues 是一個(gè) VARIANT包含 SAFEARRAY if (vValues.vt (VT_ARRAY | VT_VARIANT)) { SAFEARRAY* psa vValues.parray; LONG lbRow, ubRow, lbCol, ubCol; SafeArrayGetLBound(psa, 1, lbRow); SafeArrayGetUBound(psa, 1, ubRow); SafeArrayGetLBound(psa, 2, lbCol); SafeArrayGetUBound(psa, 2, ubCol); for (LONG r lbRow; r ubRow; r) { for (LONG c lbCol; c ubCol; c) { VARIANT v; VariantInit(v); LONG idx[2] { r, c }; SafeArrayGetElement(psa, idx, v); // 處理 v注意 VariantClear VariantClear(v); } } } }邏輯說(shuō)明Range.Value返回的VARIANT在區(qū)域大于一個(gè)單元格時(shí)是VT_ARRAY | VT_VARIANT維度是 2。SafeArrayGetLBound和SafeArrayGetUBound的第二個(gè)參數(shù)是維度編號(hào)從 1 開(kāi)始。參數(shù)說(shuō)明SafeArrayGetElement的idx數(shù)組是各維度的下標(biāo)順序和SafeArrayCreate時(shí)一致。注意批量讀取時(shí)如果區(qū)域內(nèi)有公式Value返回的是計(jì)算結(jié)果不是公式本身。要拿公式用Formula屬性。4. 避坑與排查那些讓程序卡死或讀空的細(xì)節(jié)4.1 坑一CoCreateInstance 返回 0x80040154現(xiàn)象程序啟動(dòng)后創(chuàng)建實(shí)例失敗錯(cuò)誤碼0x80040154對(duì)應(yīng)REGDB_E_CLASSNOTREG。原因ProgID 寫錯(cuò)或者 WPS 的 COM 組件沒(méi)注冊(cè)。有些 WPS 版本注冊(cè)的是ET.Application而不是KET.Application還有的只注冊(cè)了WPS.Application。解決先用OleView或者注冊(cè)表搜索確認(rèn)可用的 ProgID。代碼里做多級(jí)回退KET.Application→ET.Application→Excel.Application。如果全失敗提示用戶檢查 WPS 安裝。4.2 坑二打開(kāi)工作簿后進(jìn)程殘留現(xiàn)象程序退出后任務(wù)管理器里還有 WPS 進(jìn)程或者文件被鎖定無(wú)法編輯。原因COM 對(duì)象沒(méi)有正確釋放引用計(jì)數(shù)沒(méi)歸零。常見(jiàn)的是Workbook.Close沒(méi)調(diào)或者Application.Quit沒(méi)調(diào)。解決用CComPtr管理所有接口指針確保作用域結(jié)束時(shí)自動(dòng) Release。在退出前顯式調(diào)用Workbook.Close(false)和Application.Quit()。如果還是殘留檢查是否有IDispatch被AddRef后忘了Release。4.3 坑三讀取空單元格返回 VT_EMPTY 導(dǎo)致崩潰現(xiàn)象遍歷區(qū)域時(shí)遇到空單元格程序崩潰或輸出亂碼。原因空單元格的Value返回VT_EMPTY或VT_NULL直接當(dāng)字符串用會(huì)解引用空指針。解決取值前先判斷vt。如果是VT_EMPTY或VT_NULL當(dāng)作空字符串處理。如果是VT_BSTR用SysStringLen判斷長(zhǎng)度。如果是VT_R8轉(zhuǎn)成字符串再拼接。4.4 坑四中文路徑導(dǎo)致 Open 失敗現(xiàn)象文件路徑含中文時(shí)Workbooks.Open返回失敗錯(cuò)誤碼0x800A03EC。原因COM 接口期望BSTR如果傳入的是char*或者編碼不對(duì)路徑解析會(huì)出錯(cuò)。解決統(tǒng)一用std::wstring和CComBSTR。從std::string轉(zhuǎn)換時(shí)用MultiByteToWideChar指定CP_ACP或CP_UTF8不要直接強(qiáng)轉(zhuǎn)。4.5 坑五Visible 屬性設(shè)置時(shí)機(jī)不對(duì)現(xiàn)象設(shè)置Visible false后仍然彈出 WPS 窗口或者設(shè)置時(shí)報(bào)錯(cuò)。原因Visible屬性必須在打開(kāi)工作簿之前設(shè)置打開(kāi)后再設(shè)可能無(wú)效。另外某些 WPS 版本對(duì)Visible的 DISPID 和 Excel 不一致。解決創(chuàng)建實(shí)例后立即設(shè)Visible false。如果InvokeByName找不到Visible用GetIDsOfNames打印實(shí)際 DISPID 對(duì)比。實(shí)在不行接受窗口短暫彈出用ScreenUpdating false減少閃爍。5. 進(jìn)階技巧用 IDispatch 做延遲綁定與性能驗(yàn)證5.1 延遲綁定的取舍前面所有代碼都走IDispatch延遲綁定好處是不需要導(dǎo)入類型庫(kù)編譯期不依賴 WPS 的 tlb 文件。代價(jià)是每次調(diào)用都要GetIDsOfNames有額外開(kāi)銷。如果讀取頻率很高可以把常用的 DISPID 緩存起來(lái)避免重復(fù)查詢。// 緩存 DISPID 的簡(jiǎn)單示例 class DispIdCache { std::mapstd::wstring, DISPID cache_; IDispatch* pDisp_; public: explicit DispIdCache(IDispatch* p) : pDisp_(p) {} DISPID Get(const std::wstring name) { auto it cache_.find(name); if (it ! cache_.end()) return it-second; DISPID id; OLECHAR* n[] { const_castOLECHAR*(name.c_str()) }; pDisp_-GetIDsOfNames(IID_NULL, n, 1, LOCALE_USER_DEFAULT, id); cache_[name] id; return id; } };邏輯說(shuō)明緩存以名字為鍵DISPID 為值。第一次查詢后寫入 map后續(xù)直接命中。參數(shù)說(shuō)明GetIDsOfNames的LOCALE_USER_DEFAULT表示用當(dāng)前用戶區(qū)域設(shè)置一般不需要改。5.2 驗(yàn)證讀取結(jié)果是否正確寫完讀取邏輯后怎么確認(rèn)拿到的值是對(duì)的我一般用「三對(duì)照」一是和 WPS 界面里看到的值對(duì)照二是和用 Python 的 openpyxl 讀出來(lái)的值對(duì)照三是和公式欄里的公式對(duì)照如果讀的是 Formula。下面這個(gè)表格列出常見(jiàn)數(shù)據(jù)類型對(duì)應(yīng)的 VARIANT 類型方便排查。Excel 內(nèi)容類型VARIANT vt 值轉(zhuǎn)換建議文本VT_BSTR直接用 CString 或 std::wstring 接收數(shù)字VT_R8用 %g 格式化避免多余小數(shù)日期VT_DATE用 VariantTimeToSystemTime 轉(zhuǎn)換布爾VT_BOOL判斷 VARIANT_BOOL 真假空單元格VT_EMPTY當(dāng)空字符串處理錯(cuò)誤值VT_ERROR檢查 scode常見(jiàn) #N/A 是 0x800A07D05.3 一個(gè)我踩過(guò)的性能坑早期我圖省事用Cells(i, j)逐格讀一個(gè) 5000 行的表結(jié)果跑了將近 40 秒。后來(lái)改成Range(A1:F5000).Value一次性讀降到 0.8 秒。差距來(lái)自跨進(jìn)程調(diào)用的次數(shù)逐格讀是 30000 次 COM 調(diào)用批量讀是 1 次。從那以后我每次寫 WPS 讀取代碼都強(qiáng)制先問(wèn)自己一句「能不能一次讀一個(gè)區(qū)域」能批量就絕不逐格。希望這個(gè)習(xí)慣也能幫到你。本文還有配套的精品資源點(diǎn)擊獲取