跳转至

5分钟快速开始

本教程将带您快速了解Symphra Excel的基本用法，5分钟内创建您的第一个Excel文件。

第一步：导入库

from symphra_excel import Workbook
from symphra_excel.styles import CellStyle, PredefinedStyles, Color

第二步：创建工作簿和工作表

# 创建新工作簿
wb = Workbook()

# 创建工作表
sheet = wb.create_worksheet("员工数据")

第三步：写入数据

设置表头

headers = ["姓名", "部门", "工资", "入职日期"]

for col_idx, header in enumerate(headers):
    cell_ref = f"{chr(65 + col_idx)}1"  # A1, B1, C1, D1
    sheet.set_cell_value(cell_ref, header)
    # 应用表头样式
    sheet.apply_style(cell_ref, PredefinedStyles.header_style())

添加数据行

employees = [
    ["张三", "技术部", 15000, "2025-01-15"],
    ["李四", "销售部", 12000, "2025-02-20"],
    ["王五", "人事部", 10000, "2025-03-10"],
    ["赵六", "财务部", 13000, "2025-04-05"],
]

for row_idx, employee in enumerate(employees, start=2):
    for col_idx, value in enumerate(employee):
        cell_ref = f"{chr(65 + col_idx)}{row_idx}"
        sheet.set_cell_value(cell_ref, value)

第四步：应用样式

# 为工资列添加特殊样式
salary_style = CellStyle()
salary_style.set_font(bold=True, color=Color.DARK_GREEN)
salary_style.set_number_format("#,##0")  # 千分位格式

for row in range(2, 6):  # 行2到5
    sheet.apply_style(f"C{row}", salary_style)

第五步：保存文件

wb.save("employees.xlsx")
print("Excel文件创建成功！")

完整代码

将以上步骤组合起来：

from symphra_excel import Workbook
from symphra_excel.styles import CellStyle, PredefinedStyles, Color

# 创建工作簿
wb = Workbook()
sheet = wb.create_worksheet("员工数据")

# 设置表头
headers = ["姓名", "部门", "工资", "入职日期"]
for col_idx, header in enumerate(headers):
    cell_ref = f"{chr(65 + col_idx)}1"
    sheet.set_cell_value(cell_ref, header)
    sheet.apply_style(cell_ref, PredefinedStyles.header_style())

# 添加数据
employees = [
    ["张三", "技术部", 15000, "2025-01-15"],
    ["李四", "销售部", 12000, "2025-02-20"],
    ["王五", "人事部", 10000, "2025-03-10"],
    ["赵六", "财务部", 13000, "2025-04-05"],
]

for row_idx, employee in enumerate(employees, start=2):
    for col_idx, value in enumerate(employee):
        cell_ref = f"{chr(65 + col_idx)}{row_idx}"
        sheet.set_cell_value(cell_ref, value)

# 为工资列添加样式
salary_style = CellStyle()
salary_style.set_font(bold=True, color=Color.DARK_GREEN)
salary_style.set_number_format("#,##0")

for row in range(2, 6):
    sheet.apply_style(f"C{row}", salary_style)

# 保存
wb.save("employees.xlsx")
print("Excel文件创建成功！")

运行结果

运行上述代码后，您将得到一个名为employees.xlsx的Excel文件，包含：

  • ✅ 格式化的表头（粗体、深色背景）
  • ✅ 4行员工数据
  • ✅ 工资列使用特殊样式和千分位格式
  • ✅ 专业美观的外观

进阶示例

使用上下文管理器

更推荐的方式是使用上下文管理器，确保资源正确释放：

from symphra_excel import Workbook

with Workbook() as wb:
    sheet = wb.create_worksheet("数据")
    sheet.set_cell_value("A1", "Hello")
    wb.save("output.xlsx")
# 自动关闭和清理

批量操作

处理大量数据时可以使用批量方法：

# 批量设置值
data = [
    ["A", "B", "C"],
    [1, 2, 3],
    [4, 5, 6],
]

for row_idx, row_data in enumerate(data, start=1):
    for col_idx, value in enumerate(row_data):
        sheet.set_cell_value(f"{chr(65+col_idx)}{row_idx}", value)

自动调整列宽

# 设置列宽
sheet.set_column_width("A", 15)  # A列宽度15
sheet.set_column_width("B", 20)  # B列宽度20
sheet.set_column_width("C", 12)  # C列宽度12

常见操作速查

单元格操作

# 设置值
sheet.set_cell_value("A1", "文本")
sheet.set_cell_value("B1", 123)
sheet.set_cell_value("C1", 3.14)

# 获取值
value = sheet.get_cell_value("A1")

# 合并单元格
sheet.merge_cells("A1:C1")

样式操作

# 使用预定义样式
sheet.apply_style("A1", PredefinedStyles.header_style())
sheet.apply_style("A2", PredefinedStyles.title_style())

# 自定义样式
style = CellStyle()
style.set_font(name="微软雅黑", size=12, bold=True)
style.set_background_color(Color.LIGHT_BLUE)
sheet.apply_style("A1", style)

工作表操作

# 创建多个工作表
sheet1 = wb.create_worksheet("Sheet1")
sheet2 = wb.create_worksheet("Sheet2")

# 获取工作表
sheet = wb.get_worksheet("Sheet1")

# 删除工作表
wb.delete_worksheet("Sheet2")

下一步

恭喜！您已经掌握了Symphra Excel的基本用法。接下来您可以：