ARTICLE · 1373622
本地批量出Excel表,openpyxl我实测踩了四个中文坑
本地批量出Excel表,openpyxl我实测踩了四个中文坑
上周三晚上,我对着一张投放数据表改到十一点。十余个渠道,每周都要重新排一版,表头、列宽、格式一模一样,变的只是数字。我把同一套动作重复了五六遍,手都点酸了。躺下的时候我就想,这种活儿凭什么还要人手工做。
第二天我找了个工具,把这批表交给代码去生成。它叫 openpyxl,GitHub 上的开源项目,MIT 许可,pip 一行装好,全程在本机跑,不联网、不登录、不填 key,也不烧任何额度。我把中文表头、合并单元格、公式、日期、柱状图都写进去跑了一遍,把坑一个个撞出来。这篇就讲它怎么装、能干什么、我在哪儿栽过跟头、什么人该用。

先说它到底是个什么东西
一句话,它让 Python 能读写 Excel 的 xlsx 文件。你想建一张表、写几行数据、设个表头颜色、合并几格、插个图,不用打开表格软件手动点,写代码就行。它不依赖你电脑上装没装 Office,也不碰任何在线服务,生成的文件就是标准的 xlsx,Excel 和 WPS 都能打开。
我做个实测给你看。一张选品表,中文表头、四行数据、一个柱状图,从建到存 0.012 秒,文件 7.0KB。存完再读回来,合并区、冻结窗格、图表都在,读回 0.005 秒。这不是我抄来的数字,是本机一行行跑出来的。
它能替你干的活,往具体了说有这些。你手上有一批数据,每周要出一张格式固定的报表,写个脚本每周跑一次,表自己就出来了。你要给客户批量出报价单,把变量填进模板,它能一张张生成。你做内容,选题库、投放数据、复盘表,都能让脚本排好版直接存。你还可以把它接到流程后面,前面程序算完结果,后面自动写成表交出去。这些活儿以前要么手敲,要么开在线表格一格格填,现在电脑本机就办了。
装它的代价,我如实报一下
我在 Windows 10 上建了个全新的 Python 3.10 环境,一行命令:pip install openpyxl。实测 3.36 秒装完,拉进来 2 个包,净增体积 1.7MB,全落在 F 盘,C 盘一个字节没动。装的是 3.1.5 版。
说实话这个体积让我有点意外。它只带进来 et-xmlfile 一个依赖,装完连它自己一共 4 个包、19.0MB。硬盘再紧张也装得下,不像有些库动不动几百兆。
我更看重的是它没有那些东西:不用装 Office,不用注册账号,没有额度条,没有要填的 key。你把代码跑一遍,表就在硬盘上了,谁也管不着。这也是我愿意在专栏里写它的原因,装上就能用,不跟任何服务绑在一起。

四个坑,都是我自己撞出来的
下面的话我得先声明,全是我在这台电脑上写错、跑崩、再改对之后记下来的,不是翻文档抄的。
1、公式写进去,它不算。我给 A3 写了个 =SUM(A1:A2),A1 是 10,A2 是 20,存盘重新打开。我用 data_only 等于 True 去读 A3,读出来是 None。它老老实实把那串公式文本存了,但不替你算结果。这一点跟很多人想的不一样。你要是拿 data_only 等于 False 读,倒是能读到 =SUM(A1:A2) 这串字,可那是公式本身,不是你要的 30。怎么办?要么你自己先算好,把数字直接写进去;要么拿 Excel 或 WPS 打开另存一次,让办公软件把值算出来存进去。你要的是给客户看的成品表,我建议你直接写死数值,最省事。
2、合并单元格,只有左上角存值。我把 A1 写上标题,再用 merge_cells 合并 A1 到 C1。这时候 A1 有值,B1 和 C1 变成一种叫 MergedCell 的只读格子。我不信邪,试着往 B1 写点东西,程序直接抛 AttributeError,告诉我这格子的 value 是只读的。记住一条:合并区取值只认左上角那个格子,往别的格子写必报错。正确顺序是先往 A1 写值,再合并,反过来就给自己找麻烦。
3、样式把行数撑大,凭空冒出幽灵行。我在 A1 到 A5 写了 5 行内容,这时候 max_row 是 5,正常。接着我只给 A200 设了个边框,一个字都没写,max_row 一下跳到 200。可真正有内容的还是那 5 行。你要是写个循环打算遍历所有行,中间那 195 行全是空的,白跑一趟。这个坑还藏在删数据里:你只把 value 清空,样式还留着,行数照样下不去,得连样式一起重置才干净。
4、日期有两副面孔。我写了个 datetime 日期进去,3.1 这一版默认给它套了 yyyy-mm-dd h:mm:ss 的格式,打开一看是 2026-11-18 00:00:00,后头挂着时分秒。嫌长就手动设成 yyyy-mm-dd,立刻干净。但你要是把格式设成 General,它马上退回一串数字,我实测那个日期变成 46344,这是 1900 日期系统的序列数。写日期记一条:要么留默认,要么显式设成你要的格式,别碰 General。

怎么写才顺手
把上面四个坑记牢,代码其实很短。导入 Workbook,建工作簿,拿 active 取当前 sheet。表头用 cell 一格格写,字体、颜色、边框这些样式都挂在 cell 上逐格设。合并用 merge_cells,记得先写值。冻结窗格设 freeze_panes,图表用 BarChart,add_chart 挂上去。存盘一句 save 就完事。
中文这里我再啰嗦一句。openpyxl 的样式是挂在每一个 cell 上的,没有一处设置全表生效的捷径,表头每格都得设到。列宽也按字符数算,一个中文字差不多占两个英文字符宽,你给列宽设 10,中文标题就被截断,所以中文列得往宽里给。这两点看着小,做出来好不好看全在它们身上。
公式那块我的态度是别偷懒。成品表就把结果算好写死,打开就是数,客户也不会去改你公式。只有你自己留着下次还要拿来用的模板,才需要写公式,而且心里要清楚它不会自己算。

谁该装,谁别浪费时间
该装的几种人。要批量出周报、清单、报价单这类格式固定表格的。要把脚本算出来的结果自动写成带图表 Excel 的。做内容想给每期选题自动留一张排好版数据表的。只想本地免费出 xlsx,压根不想碰在线表格那套的。
别碰的几种人。你要打开就看到公式算好的值,它办不到,得再开一次办公软件。你要做透视表、宏这类东西,它写不了。你嫌设字体设列宽麻烦,想一句话就出完美排版,它不是那种工具。你指望它认出一张图片里的表格,那是 OCR 的活,得另找工具。
它的价值说到底就一句:格式固定的 Excel,它能替你批量生成,省掉手工排版的时间。你前面要把素材图裁好,可以用之前聊过的 Pillow;后面要把数据写成 Word 交出去,可以配 python-docx。一个裁图、一个出表、一个出 Word,本地办公文档这条线就凑齐了,全程不联网、不花钱。
这一篇我只讲透一个仓库:它是什么、怎么装、坑在哪、谁适合。我就这么一个一个拆,把真正在本机跑通的东西挑出来给你看。想接着往下看的,来「弋然小记」找我,扣个 1,我接着挖下一个。















































































