ARTICLE · 1368133
Excel 里的单元格设置,Python 里怎么写?
一、先建立映射:Ctrl+1 的六个标签页 = 六个对象
Excel 的格式设置分散在"开始"选项卡的按钮、右键菜单和 Ctrl+1 对话框里;Python 里它们一一对应成六个可赋值对象。

把对话框那六页摊开看,就是六件套:

关键认知只有一条:**cell.font、cell.fill 读回来是只读代理 StyleProxy,格式不是"改属性",而是"换对象"。** 实测两个高频报错:
cell.font.bold = True
AttributeError: Style objects are immutable and cannot be changed.Reassign the style with a copy
ws['C1'].font = ws['D1'].font
TypeError: unhashable type: 'StyleProxy'
前者要整体重新赋值,后者要用 copy():
from copy import copy
c.font = copy(other.font) # 跨单元格搬样式
c._style = copy(other._style) # 六件套一次搬完(实测 bold/fill/size 全带上)
number_format 是普通字符串,直接等号复制就行。
二、六件套的完整写法

Side 的线型只有 13 种,写错会直接把合法集合报给你:thin / medium / thick / dotted / dashed / double / hair / dashDot / dashDotDot / mediumDashed / mediumDashDot / mediumDashDotDot / slantDashDot。text_rotation 只收 0–180 的整数,181 直接 ValueError。
颜色:Excel 给 6 位,openpyxl 要 8 位

实测三种写法的下场:'FFFF0000' 正常;'FF0000' 不报错但被补成 '00FF0000'(写进去和读回来不一样,别拿它做相等判断);'red' 直接 ValueError: Colors must be aRGB hex values。Excel 取色器上半排是主题色,对应 Color(theme=5, tint=0.4),这种颜色读 .rgb 是取不到值的,只能读 theme 和 tint。
三、数字格式

写 13 种格式存盘,解 zip 读 xl/styles.xml,内置格式复用规范里的固定 ID(0–163),自定义格式从 164 开始编号。两个反直觉的点:中文 Excel 的"G/通用格式"不是 General,会被新开一个自定义号;yyyy-mm-dd 也不复用内置的 14。
四、写进去的值 ≠ 文件里存的值

date(2026, 11, 17) 在文件里是 46343(1900 纪元序列号),保存那一刻才转换;'00123' 会变成 inlineStr,Excel 左上角亮绿三角。要前导零又要能参与计算,唯一干净的做法是**写数字 + number_format='00000'**。
五、条件格式:Excel 菜单五项,对应五个 Rule

条件格式是规则不是样式:直接读 cell.fill 什么都看不到,颜色存在 styles.xml 的 dxfs 段里。实测一个隐蔽坑——手写 DifferentialStyle(fill=PatternFill(bgColor='FFFFC7CE')) 生成的是 <patternFill><bgColor .../></patternFill>,没有 patternType,Excel 不显示底色;用 CellIsRule(fill=PatternFill('solid', fgColor=...)) 才是正确形态。
六、数据验证:下拉、区间、长度

type 只有 list / whole / decimal / date / time / textLength / custom 七种。showDropDown 的语义是反的(它原意是"隐藏下拉箭头"),实测留空时 XML 写的是 showDropDown="0",箭头照常显示,所以别去动它。内联列表实测 296 字符也能写进 XML,openpyxl 不拦,但稳妥做法还是 formula1='=$Z$1:$Z$59' 引用区域。
七、行高、列宽、合并、冻结、隐藏、分组

单位别搞混:列宽是字符数,行高是磅。两个实测细节:没设置过的列读回来是 13.0,那是 openpyxl 的占位默认值,不代表 Excel 里的真实宽度;行一旦设过 height,XML 就写 customHeight="1",Excel 不再按自动换行帮你撑高。合并区里只有左上角可写,其它位置类型变成 MergedCell,赋值直接 AttributeError。
八、锁定与保护:默认全锁,但要开总开关

Protection.locked 默认全是 True,不开 ws.protection.sheet = True 就完全不起作用。方向也和直觉相反:ws.protection.insertRows = False 才表示"保护后仍允许插入行"。另外这只是防误操作,不是加密——密码只写成一个短哈希(实测 'CC1A'),删掉 XML 节点就解锁。
九、pandas 相关运用

实测性能参考:5 万格逐个刷 font + fill(样式对象在循环外建一次)0.31 秒;设 20 列的列宽 0.0001 秒。列级设置是 O(列数),别逐格刷。
Styler 走的是 CSS,但只有少数几条 CSS 会被翻译进 Excel:

十、九个坑速查

摘要
Excel 单元格设置在 Python 里就是六件套对象:字体、边框、填充、对齐、数字格式、保护。样式对象只读,只能整体替换;pandas Styler 只认少数 CSS,管不了表头和列宽。















































































