👉 项目官网：https://www.python-office.com/ 👈

github star

大家好，这里是程序员晚枫，正在all in AI编程实战。

从这讲开始，我们正式进入 python-office 实战环节。

这讲教你怎么用 3行代码读取 Excel 文件。

1、场景说明

你可能经常遇到这样的场景：

  • 导出一个数据报表，要手动复制粘贴
  • 同事发来一个 Excel，要一个个核对数据
  • 每月要统计 Excel 里的销售数据，手动算到眼花

这些问题，用 python-office 只需要 3 行代码就能解决。

2、准备一个Excel文件

在桌面上新建一个 Excel 文件，命名为 学生成绩.xlsx，输入以下内容：

姓名语文数学英语
小明908592
小红889289
小刚768085

保存好，我们来读取它。

3、代码：3行读取Excel

新建一个 Python 文件，写入以下代码：

1
2
3
4
5
6
7
8
# -*- coding: utf-8 -*-
import office

# 1行代码读取Excel
df = office.excel.read(path='学生成绩.xlsx')

# 打印结果
print(df)

运行程序，你会看到：

1
2
3
4
     姓名  语文  数学  英语
0   小明   90   85   92
1   小红   88   92   89
2   小刚   76   80   85

🎉 Done！Excel 读取成功！

4、代码解读

让我解释一下这 3 行代码：

第1行：导入库

1
import office

这一行是固定的，导入 python-office 库。

第2行：读取Excel

1
df = office.excel.read(path='学生成绩.xlsx')

office.excel.read() 是 python-office 提供的 Excel 读取功能。

  • path 参数填写你的文件路径
  • 如果文件和代码在同一文件夹，直接写文件名就行

第3行：打印结果

1
print(df)

把读取到的内容打印出来。

5、读取其他位置的Excel

如果你的 Excel 文件不在代码文件夹里，需要写完整路径：

Windows用户：

1
df = office.excel.read(path=r'C:\Users\你的用户名\Desktop\学生成绩.xlsx')

Mac用户：

1
df = office.excel.read(path='/Users/你的用户名/Desktop/学生成绩.xlsx')

6、读取后数据分析

读取出来的 df 是什么类型？是一个 DataFrame（数据表格）。

你可以对它进行各种分析：

1
2
3
4
5
6
7
8
9
# 计算每科平均分
print(df.mean())

# 计算总分
df['总分'] = df['语文'] + df['数学'] + df['英语']
print(df)

# 找出最高分
print(df.max())

7、实战案例：批量读取文件夹里所有Excel

你有没有遇到过这种情况：一个文件夹里有几十个 Excel，要一个个打开复制粘贴？

用 python-office 可以一键搞定：

1
2
3
4
5
6
7
8
9
10
11
12
13
import office
import os

# 遍历文件夹里所有xlsx文件
folder = 'C:\\Users\\你的用户名\\Desktop\\报表'
files = [f for f in os.listdir(folder) if f.endswith('.xlsx')]

for file in files:
    path = os.path.join(folder, file)
    df = office.excel.read(path=path)
    print(f'=== {file} ===')
    print(df)
    print()

8、常见问题

Q：报错"找不到文件"？

A：检查路径是否正确，或者文件名前后有没有空格。

Q：报错"模块不存在"？

A：先执行 pip install python-office 安装库。

Q：Excel有多个Sheet怎么办？

A：可以指定读取哪个 Sheet：

1
df = office.excel.read(path='学生成绩.xlsx', sheet='Sheet2')

9、下讲预告

学会了读取，下一讲我们学 Excel写入——把数据一键写入 Excel，支持格式设置。

敬请期待！

有问题欢迎加微信 python-office 进群交流~

程序员晚枫专注AI编程培训，小白看完他和图灵社区合作的教程《30讲 · AI编程训练营》就能上手做AI项目。

🎓 AI 编程实战课程

想系统学习 AI 编程？程序员晚枫的 AI 编程实战课 帮你从零上手！