Openpyxl中sheet.page_setup.fitToPage设置报错：NoneType无sheet_properties属性

问题根源 #

这个错误的核心原因是你当前操作的sheet并非普通的工作表（Worksheet类型），而是图表工作表（ChartSheet）这类特殊类型对象——这类对象没有有效的page_setup属性，访问时会返回None，进而触发后续的属性访问报错。

解决方案 #

1. 过滤非普通工作表 #

在操作page_setup前，先检查sheet类型，只对普通工作表执行设置：

import os
from openpyxl import load_workbook
from openpyxl.worksheet.worksheet import Worksheet

download_path = os.path.dirname(os.path.abspath(__file__))

for excel_file_name in os.listdir(download_path):
    if excel_file_name.endswith('.xlsx'):
        excel_file_path = os.path.join(download_path, excel_file_name)
        excel_workbook = load_workbook(excel_file_path)
        sheet = excel_workbook.active

        # 仅处理普通工作表
        if not isinstance(sheet, Worksheet):
            print(f"跳过非普通工作表：{sheet.title}")
            continue
        
        # 设置一页缩放适配
        sheet.page_setup.fitToPage = True
        sheet.page_setup.fitToHeight = False
        sheet.page_setup.fitToWidth = 1

        # 保存修改
        excel_workbook.save(excel_file_path)

2. 升级openpyxl到最新版本 #

旧版本openpyxl可能存在属性访问的兼容性问题，执行以下命令升级：

pip install --upgrade openpyxl

3. 直接指定目标工作表名称 #

如果Excel文件包含多个工作表，active可能指向非预期的sheet，直接指定工作表名称可避免此类问题：

# 替换为你需要操作的工作表名称
sheet = excel_workbook["Sheet1"]

内容的提问来源于stack exchange，提问作者Albin Rdz