萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 讀取本地 Excel 文件:ActiveXObject 方案完整指南與現代替代方案

核心限制:僅限 IE + 本地文件 + 用戶授權

此方案僅在 IE 瀏覽器有效,且需要:

  1. 客戶端安裝完整版 Microsoft Office (含 Excel ActiveX)。
  2. IE 安全設置:工具 → Internet 選項 → 安全 → 可信站點 → 自定義級別 → ActiveX 控件和插件 → 「對未標記為可安全執行腳本的 ActiveX 控件初始化並執行」→ 啟用。
  3. 將網站加入「可信站點」列表。
  4. 用戶確認允許運行 ActiveX 控件。

完整代碼實現 (僅 IE 有效)

<script type="text/javascript">
function readExcel() {
    var filePath = "D:\\abcd9.com.xls"; // 本地絕對路徑
    var sheetIndex = 2;               // 第 2 個工作表 (1-based)
    var startRow = 3;                 // 從第 3 行開始
    var result = '';
    
    try {
        // 1. 創建 Excel Application 對象
        var excel = new ActiveXObject("Excel.Application");
        excel.Visible = false; // 後台運行
        excel.DisplayAlerts = false; // 禁用彈窗
        
        // 2. 打開工作簿
        var workbook = excel.Workbooks.Open(filePath);
        workbook.Worksheets(sheetIndex).Select();
        var sheet = workbook.ActiveSheet;
        
        // 3. 獲取已使用範圍行數
        var rowCount = sheet.UsedRange.Rows.Count;
        
        // 4. 逐行讀取指定列
        for (var i = startRow; i <= rowCount; i++) {
            var col2 = $.trim(sheet.Cells(i, 2).Value) || '';
            var col4 = $.trim(sheet.Cells(i, 4).Value) || '';
            var col6 = $.trim(sheet.Cells(i, 6).Value) || '';
            
            // 第 8 列日期特殊處理
            var col8Val = sheet.Cells(i, 8).Value;
            var col8 = '';
            if (col8Val instanceof Date) {
                col8 = col8Val.getFullYear() + '-' + 
                       (col8Val.getMonth() + 1).toString().padStart(2, '0') + '-' + 
                       col8Val.getDate().toString().padStart(2, '0');
            } else {
                col8 = $.trim(col8Val) || '';
            }
            
            result += col2 + ' ' + col4 + ' ' + col6 + ' ' + col8 + '\n';
        }
        
        // 5. 清理資源
        workbook.Close(false); // 不保存
        excel.Quit();
        CollectGarbage(); // IE 專用強制 GC
        
        return result;
        
    } catch (e) {
        alert('讀取失敗: ' + e.message + '\n請確認:\n1. 已安裝 Office\n2. IE 安全設置已啟用 ActiveX\n3. 文件路徑正確且未被佔用');
        return '';
    }
}
</script>

關鍵技術細節

  • COM 物件生命週期:必須 Quit() 並 CollectGarbage(),否則 Excel 進程殘留佔用文件鎖。
  • 日期類型判斷:ActiveX 返回的日期為 JS Date 物件,用 instanceof Date 判斷。
  • 路徑格式:雙反斜杠 \\ 或單正斜杠 /,相對路徑相對當前頁面。
  • UsedRange 陷阱:若表格有隱藏行/列或格式殘留,UsedRange 可能超出實際數據範圍。

現代跨瀏覽器替代方案 (強烈推薦)

方案一:SheetJS (xlsx.js) - 純前端解析

<script src="https://cdn.jsdelivr.net/npm/xlsx/dist/xlsx.full.min.js"></script>
<input type="file" id="excelFile" accept=".xls,.xlsx,.csv" />

<script>
document.getElementById('excelFile').addEventListener('change', function(e) {
    var file = e.target.files[0];
    var reader = new FileReader();
    reader.onload = function(e) {
        var data = new Uint8Array(e.target.result);
        var workbook = XLSX.read(data, {type: 'array'});
        
        // 讀取第一個工作表
        var sheetName = workbook.SheetNames[0];
        var sheet = workbook.Sheets[sheetName];
        
        // 轉為 JSON 陣列
        var json = XLSX.utils.sheet_to_json(sheet, {header: 1}); // 含表頭
        console.log(json);
        
        // 或指定範圍
        var rangeJson = XLSX.utils.sheet_to_json(sheet, {range: 2}); // 從第 3 行
    };
    reader.readAsArrayBuffer(file);
});
</script>

方案二:ExcelJS - 更豐富的樣式/公式支援

import ExcelJS from 'exceljs';

async function readExcelModern(file) {
    const workbook = new ExcelJS.Workbook();
    await workbook.xlsx.load(file);
    const worksheet = workbook.getWorksheet(1);
    
    const data = [];
    worksheet.eachRow({includeEmpty: false}, (row, rowNumber) => {
        if (rowNumber >= 3) { // 從第 3 行
            data.push({
                col2: row.getCell(2).text,
                col4: row.getCell(4).text,
                col6: row.getCell(6).text,
                col8: row.getCell(8).text
            });
        }
    });
    return data;
}

方案三:File System Access API (Chrome 86+ / Edge 86+)


// 用戶主動選擇文件/目錄,獲得持久化訪問權限
async function pickAndRead() {
    const [handle] = await window.showOpenFilePicker({
        types: [{description: 'Excel Files', accept: {'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': ['.xlsx']}}]
    });
    const file = await handle.getFile();
    const buffer = await file.arrayBuffer();
    // 交給 SheetJS/ExcelJS 解析
}

方案對比總結

方案瀏覽器支援需 Office 安裝跨域/本地功能豐富度推薦指數
ActiveXObject僅 IE是僅本地絕對路徑完整 Excel 自動化⭐ (維舊專案)
SheetJS (xlsx)全現代瀏覽器否用戶選擇文件讀寫、格式轉換、流式處理⭐⭐⭐⭐⭐
ExcelJS全現代瀏覽器否用戶選擇文件樣式、公式、圖表、流式⭐⭐⭐⭐
File System Access APIChrome/Edge 新版否用戶授權目錄原生文件系統操作⭐⭐⭐ (前沿)

遷移建議

新專案直接使用 SheetJS,零依賴、體積小(~100KB gzip)、API 簡潔、社區活躍。舊 IE 專案維護期內可共存,逐步引導用戶遷移至現代瀏覽器。

copyright © 萬盛學電腦網 all rights reserved