https://openpyxl.readthedocs.io/en/stable/

`openpyxl` 是一个用于读写 Excel 2010 xlsx/xlsm/xltx/xltm 文件的 Python 库。它允许开发者创建、修改和保存电子表格，而无需依赖 Microsoft Excel 软件本身。`openpyxl` 支持读取和写入 Excel 的工作簿（Workbook）、工作表（Worksheet）、单元格（Cell）以及样式等元素。

### 安装

要使用 `openpyxl`，首先需要安装它。可以通过 pip 工具来安装最新版本：

pip3 install openpyxl

### 基本用法

#### 创建一个新的工作簿```python
from openpyxl import Workbook# 创建一个新的工作簿对象
wb = Workbook()# 获取活动的工作表
ws = wb.active# 给工作表命名
ws.title = "Sample Sheet"# 写入数据到单元格
ws['A1'] = "Hello"
ws['B1'] = "World"# 保存文件
wb.save("sample.xlsx")
```#### 打开现有的工作簿```python
from openpyxl import load_workbook# 加载现有工作簿
wb = load_workbook('existing_file.xlsx')# 获取所有工作表的名字
print(wb.sheetnames)# 选择特定的工作表
ws = wb["Sheet1"]# 或者通过索引获取第一个工作表
ws = wb.worksheets[0]
```#### 遍历工作表中的行和列```python
for row in ws.iter_rows(min_row=1, max_col=3, max_row=2, values_only=True):print(row)  # 输出每一行的数据元组# 或者逐个访问单元格
for cell in ws["A"]:print(cell.value)
```#### 添加新的工作表```python
# 创建新的工作表并指定位置
ws2 = wb.create_sheet("My New Sheet", 0)  # 在最前面插入新工作表
```#### 修改单元格样式```python
from openpyxl.styles import Font, Color, Alignment, Border, Side, PatternFill# 设置字体样式
cell = ws['A1']
cell.font = Font(name='Arial', size=14, bold=True, italic=False)# 设置对齐方式
cell.alignment = Alignment(horizontal="center", vertical="center")# 设置边框
thin_border = Border(left=Side(style='thin'), right=Side(style='thin'), top=Side(style='thin'), bottom=Side(style='thin'))
cell.border = thin_border# 设置背景颜色
cell.fill = PatternFill(start_color="FFCC66", end_color="FFCC66", fill_type="solid")
```#### 合并和拆分单元格```python
# 合并单元格
ws.merge_cells('A1:B2')# 拆分已合并的单元格
ws.unmerge_cells('A1:B2')
```#### 插入图表```python
from openpyxl.chart import BarChart, Reference# 准备数据
data = Reference(ws, min_col=1, min_row=1, max_col=3, max_row=4)# 创建柱状图
chart = BarChart()
chart.add_data(data, titles_from_data=True)# 将图表添加到工作表中
ws.add_chart(chart, "E5")
```### 更多高级功能- **公式**：可以在单元格中设置公式，例如 `ws['A1'] = '=SUM(A2:A4)'`
- **冻结窗格**：使用 `ws.freeze_panes = 'A2'` 来冻结顶部一行或左侧一列。
- **条件格式**：可以为单元格应用条件格式规则。
- **批注**：支持给单元格添加批注。
- **保护工作表**：可以启用工作表保护以防止意外更改。### 示例：完整代码示例以下是一个完整的例子，演示了如何创建包含简单表格的工作簿，并对其进行一些基本操作：```python
from openpyxl import Workbook
from openpyxl.styles import Font, Alignment, Border, Side# 创建一个新的工作簿对象
wb = Workbook()# 获取活动的工作表
ws = wb.active
ws.title = "Sales Data"# 添加标题行
headers = ["Product", "Q1 Sales", "Q2 Sales"]
ws.append(headers)# 设置标题行样式
for col in range(1, len(headers) + 1):cell = ws.cell(row=1, column=col)cell.font = Font(bold=True)cell.alignment = Alignment(horizontal="center")# 添加数据行
data = [("Widget A", 120, 150),("Widget B", 90, 110),("Widget C", 75, 85)
]for row in data:ws.append(row)# 保存文件
wb.save("sales_report.xlsx")
```

以上是关于 `openpyxl` 的一些基础知识和常用功能。