`calamine` 是一个用于读取多种电子表格格式（如 Excel、LibreOffice Calc 等）的 Python 库。它支持 `.xls`, `.xlsx`, `.ods` 和 `.csv` 文件格式，提供了简单易用的 API 来加载和处理电子表格数据。`calamine` 的一大特点是它的轻量级和高效性，特别适合需要快速解析电子表格而不依赖于重量级库（如 `openpyxl` 或 `pandas`）的应用场景。
安装
要使用 `calamine`，首先需要通过 `pip` 安装它：
```bash
pip3 install calamine
```基本用法
#### 读取 Excel 文件以下是如何使用 `calamine` 读取 Excel 文件并获取其中的数据：```python
from calamine import Workbook, CellType# 打开工作簿
workbook = Workbook.open("example.xlsx")# 获取所有的工作表名称
sheet_names = workbook.sheet_names()
print(f"Sheet names: {sheet_names}")# 选择第一个工作表
sheet = workbook.get_sheet_by_index(0)# 遍历所有行
for row in sheet.rows():# 每一行是一个列表，包含每个单元格的值print([cell.value for cell in row if cell.type != CellType.EMPTY])# 关闭工作簿
workbook.close()
```#### 读取 ODS 文件对于 OpenDocument Spreadsheet (ODS) 文件，操作方式类似：```python
from calamine import Workbook, CellType# 打开 ODS 工作簿
workbook = Workbook.open("example.ods")# 选择第一个工作表
sheet = workbook.get_sheet_by_index(0)# 遍历所有行
for row in sheet.rows():print([cell.value for cell in row if cell.type != CellType.EMPTY])# 关闭工作簿
workbook.close()
```#### 读取 CSV 文件虽然 CSV 文件不是严格意义上的电子表格文件，但 `calamine` 同样可以方便地处理它们：```python
from calamine import Workbook, CellType# 打开 CSV 文件
with open("example.csv", "r") as f:workbook = Workbook.from_csv(f)# 选择唯一的工作表sheet = workbook.get_sheet_by_index(0)# 遍历所有行for row in sheet.rows():print([cell.value for cell in row if cell.type != CellType.EMPTY])
```### 处理单元格类型`calamine` 支持多种单元格类型，并允许你根据需要访问不同类型的数据：```python
from calamine import CellType# 假设我们已经打开了一个工作簿并选择了某个工作表
for row in sheet.rows():for cell in row:if cell.type == CellType.STRING:print(f"String value: {cell.value}")elif cell.type == CellType.NUMBER:print(f"Number value: {cell.value}")elif cell.type == CellType.BOOL:print(f"Boolean value: {cell.value}")elif cell.type == CellType.ERROR:print(f"Error value: {cell.error}")elif cell.type == CellType.FORMULA:print(f"Formula: {cell.formula}, Result: {cell.value}")elif cell.type == CellType.EMPTY:print("Empty cell")
```### 获取特定单元格的值如果你知道具体的单元格位置（例如 A1），可以直接获取其值：```python
# 获取 A1 单元格的值
value = sheet.get_value("A1")
print(f"Value at A1: {value}")
```### 更多高级功能- **遍历列**：除了按行遍历外，还可以按列遍历。
- **合并单元格**：支持检测和处理合并的单元格。
- **样式信息**：尽管 `calamine` 主要关注数据本身，但它也提供了一些基础的样式信息访问方法。
- **公式计算**：如果需要计算公式的结果，可以在读取时指定参数来启用此功能。### 示例：完整代码示例以下是一个完整的例子，演示了如何使用 `calamine` 读取 Excel 文件中的数据，并进行简单的数据处理：```python
from calamine import Workbook, CellTypedef read_excel(file_path):workbook = Workbook.open(file_path)sheet = workbook.get_sheet_by_index(0)data = []for row in sheet.rows():row_data = [cell.value for cell in row if cell.type != CellType.EMPTY]if row_data:data.append(row_data)workbook.close()return dataif __name__ == "__main__":file_path = "example.xlsx"data = read_excel(file_path)# 打印前几行数据作为示例for row in data[:5]:print(row)
```### 总结
`calamine` 是一个非常轻便且高效的工具，适用于需要快速解析多种格式电子表格的应用程序。它提供的 API 简单直观，易于集成到现有项目中。
10倍性能，待验证。
