直接调用 pandas.read_excel("protected.xlsx") 会报 ValueError: File is encrypted，因 openpyxl/xlsxwriter 不支持解密，xlrd 2.0+ 已弃用 .xlsx 支持。
用 pandas.read_excel 直接读加密 Excel 会报什么错？
直接调用 pandas.read_excel("protected.xlsx") 会触发 XLRDError: Unsupported format, or corrupt file（旧版）或更常见的 ValueError: File is encrypted。这是因为 openpyxl 和 xlsxwriter 引擎默认不支持密码解密，而 xlrd 从 2.0 版起已彻底放弃对 .xlsx 文件的支持，也不处理密码。
必须先解密再读取：用 msoffcrypto-tool 解包
msoffcrypto-tool 是目前最稳定、被广泛验证的 Python 库，专用于解密受密码保护的 Office 文件（含 Excel）。它不直接解析数据，而是把解密后的流交给 openpyxl 处理。
实操步骤：
- 安装依赖：
pip install msoffcrypto-tool openpyxl - 确保你有正确的密码（区分大小写，空格敏感）
- 不要尝试用
pd.read_excel直接传文件路径，必须手动构造解密后的Workbook对象
示例代码：
立即学习“Python免费学习笔记（深入）”；
import pandas as pd
import msoffcrypto
from openpyxl import load_workbook
<p>with open("protected.xlsx", "rb") as f:
file = msoffcrypto.OfficeFile(f)
file.load_key(password="MyPass123") # ⚠️ 密码错误会抛出 ValueError
with open("decrypted.xlsx", "wb") as decrypted:
file.decrypt(decrypted)</p><h1>再用 pandas 读取临时解密文件</h1><p>df = pd.read_excel("decrypted.xlsx", engine="openpyxl")为什么不能跳过临时文件？
pandas.read_excel 的 engine 参数只接受文件路径或类文件对象，但 msoffcrypto 解密后返回的是字节流，openpyxl.load_workbook() 要求可 seek 的对象（比如 BytesIO），而 pd.read_excel 在 openpyxl 引擎下并不支持传入 BytesIO —— 它内部会尝试调用 .filename 属性，导致 AttributeError。
所以可靠做法是：
- 用
msoffcrypto解密到磁盘临时文件（最稳） - 或用
BytesIO+openpyxl.load_workbook+pandas.DataFrame手动构建 DataFrame（需自己处理 sheet、header、dtype 等，易漏细节） - 避免用
tempfile.NamedTemporaryFile(delete=False)后不手动清理，Windows 下可能因句柄未释放导致后续读取失败
Excel 加密类型影响解密成功率
不是所有“带密码”的 Excel 都能被 msoffcrypto-tool 解开。关键看加密方式：
- ✅ 支持：Microsoft Excel 2007+ 的“文档加密”（即打开时要输密码，菜单栏：文件 → 信息 → 保护工作簿 → 用密码进行加密）
- ❌ 不支持：“工作表保护”或“工作簿结构保护”（右键工作表标签 → 保护工作表），这类只是防止编辑，文件本身未加密，
pandas可正常读，但写入/修改会失败 - ⚠️ 模糊地带：某些企业用第三方插件或 VBA 自定义加密，
msoffcrypto-tool无法识别，此时需先人工用 Excel 打开另存为无密码文件
判断是否为真加密：用文本编辑器（如 VS Code）打开 .xlsx 文件，如果开头不是 PK（ZIP 签名），而是乱码或固定头（如 D0 CF 11 E0），大概率是旧格式（.xls）或非标准加密，需换工具或确认格式。
密码错误、格式误判、临时文件权限问题——这三个点占了实际使用中 90% 的失败原因。别省那几行代码，加个 try/except 捕获 ValueError 和 PermissionError，比反复重试更省时间。
