Angular中使用ExcelJS锁定指定Excel单元格问题及xlsx库咨询

我尝试在代码中锁定特定单元格（第1行和第1列），但遇到的问题是整个工作表被锁定，而非指定单元格。我已尝试先默认解锁所有单元格再锁定指定区域，但问题仍未解决，希望获取最优解决方案。同时我有一个疑问：是否可以使用xlsx库实现该功能？该库是否支持此类高级特性？

原代码 #

downloadTable() {
    const data = this.formatExcelData(this.dialogData.template);
    // Create a new workbook and worksheet
    const workbook = new ExcelJS.Workbook();
    const worksheet = workbook.addWorksheet('Sheet1');
    // Protect the worksheet but allow selecting both locked and unlocked cells
    worksheet.protect('your_password', {selectLockedCells: false});
    // Convert JSON data to worksheet columns dynamically
    if (data.length > 0) {
      const keys = Object.keys(data[0]);
      worksheet.columns = keys.map((key, i) => { 
        return { 
            header: key, 
            key: key, 
            width: i==0 ? 8 : i==1 ? 13 : i==6||i==7 ? 11 : i==8||i==9 ? 22 : i==10||i==11 ? 13 : i==12 ? 17 : 11,   
        } 
      });
    }
    // Add JSON data as rows
    data.forEach(row => {
      worksheet.addRow(row);
    });
    // Apply merging to specified standby rows
    this.standbyRows.forEach(rowIndex => {
        worksheet.mergeCells(rowIndex + 2, 3, rowIndex + 2, 13); // Merges columns 3 to 13 (1-based index)
      
        const cell = worksheet.getCell(rowIndex + 2, 3); // The top-left cell of the merged range
        cell.alignment = { 
        horizontal: 'center', // Center horizontally
        vertical: 'middle'    // Center vertically
      };
    });
    // Unprotect all cells in the worksheet
    worksheet.eachRow((row) => {
      row.eachCell((cell) => {
        cell.protection = {
          locked: false
        };
      });
    });
    worksheet.getRow(1).height = 30;
    worksheet.getRow(1).eachCell((cell, colNumber) => {
      debugger
        cell.protection = { locked: true }; // Lock all cells in the first row
        if(colNumber <= 13) {
            // Set the background color, text color, bold font, and borders
            cell.fill = {
                type: 'pattern',
                pattern: 'solid',
                fgColor: { argb: '4286F5' }, // Blue background similar to your image
            };
            cell.font = {
                bold: true,
                color: { argb: 'FFFFFF' }, // White text color
                size: 12, // Optional, adjust font size if needed
            };
            cell.alignment = {
                horizontal: 'center',
                vertical: 'bottom',
            };
            cell.border = {
                top: { style: 'thin' },
                left: { style: 'thin' },
                bottom: { style: 'thin' },
                right: { style: 'thin' }
            };
        }
    });
    // Lock the first column (column A)
    worksheet.getColumn(1).eachCell((cell) => {
        cell.protection = { locked: true }; // Lock all cells in the first column
    });
    // Generate and download the Excel file
    workbook.xlsx.writeBuffer().then((buffer) => {
      const blob = new Blob([buffer], { type: 'application/octet-stream' });
      const link = document.createElement('a');
      link.href = URL.createObjectURL(blob);
      link.download = 'CEMENT_QUALITY_DASHBOARD.xlsx';
      link.click();
    });
  }

问题原因及修复方案 #

问题核心是工作表保护的时机错误：你先调用了worksheet.protect()开启保护，之后修改的单元格锁定状态不会生效。正确流程是先完成所有单元格的锁定/解锁配置，最后再启用工作表保护。

修复步骤 #

1. 将worksheet.protect()调用移到所有单元格配置完成后（下载逻辑前）
2. 确保解锁所有已存在的单元格（包括表头和数据行）
3. 合并单元格只需设置左上角单元格的锁定状态，Excel会自动应用到整个合并区域

修复后代码 #

downloadTable() {
    const data = this.formatExcelData(this.dialogData.template);
    // 创建工作簿和工作表
    const workbook = new ExcelJS.Workbook();
    const worksheet = workbook.addWorksheet('Sheet1');
    // 动态生成列
    if (data.length > 0) {
      const keys = Object.keys(data[0]);
      worksheet.columns = keys.map((key, i) => { 
        return { 
            header: key, 
            key: key, 
            width: i==0 ? 8 : i==1 ? 13 : i==6||i==7 ? 11 : i==8||i==9 ? 22 : i==10||i==11 ? 13 : i==12 ? 17 : 11,   
        } 
      });
    }
    // 添加数据行
    data.forEach(row => {
      worksheet.addRow(row);
    });
    // 合并指定行的单元格
    this.standbyRows.forEach(rowIndex => {
        worksheet.mergeCells(rowIndex + 2, 3, rowIndex + 2, 13);
        const cell = worksheet.getCell(rowIndex + 2, 3);
        cell.alignment = { 
            horizontal: 'center',
            vertical: 'middle'
        };
    });
    // 先解锁所有单元格
    worksheet.eachRow((row) => {
      row.eachCell((cell) => {
        cell.protection = { locked: false };
      });
    });
    // 配置第一行样式并锁定
    worksheet.getRow(1).height = 30;
    worksheet.getRow(1).eachCell((cell, colNumber) => {
        cell.protection = { locked: true };
        if(colNumber <= 13) {
            cell.fill = {
                type: 'pattern',
                pattern: 'solid',
                fgColor: { argb: '4286F5' },
            };
            cell.font = {
                bold: true,
                color: { argb: 'FFFFFF' },
                size: 12,
            };
            cell.alignment = {
                horizontal: 'center',
                vertical: 'bottom',
            };
            cell.border = {
                top: { style: 'thin' },
                left: { style: 'thin' },
                bottom: { style: 'thin' },
                right: { style: 'thin' }
            };
        }
    });
    // 锁定第一列
    worksheet.getColumn(1).eachCell((cell) => {
        cell.protection = { locked: true };
    });
    // 最后启用工作表保护
    worksheet.protect('your_password', {
        selectLockedCells: true,
        selectUnlockedCells: true
    });
    // 生成并下载文件
    workbook.xlsx.writeBuffer().then((buffer) => {
      const blob = new Blob([buffer], { type: 'application/octet-stream' });
      const link = document.createElement('a');
      link.href = URL.createObjectURL(blob);
      link.download = 'CEMENT_QUALITY_DASHBOARD.xlsx';
      link.click();
    });
  }

关于xlsx库的支持性 #

xlsx（SheetJS）基础版本不支持单元格锁定和工作表保护这类高级特性，它的核心能力集中在数据解析与导出，对格式、保护等高级功能支持有限。如果需要这类特性，建议继续使用ExcelJS，或者购买SheetJS专业版，专业版提供了更多高级格式和保护功能支持。

内容的提问来源于stack exchange，提问作者Snehil Agrahari