如何在 xlwings 中正确读取受保护 Excel 工作表中的单元格批注
WindowTop是一款窗口自定义设置工具，实现置顶、透明度调整、界面模糊、暗色模式及缩小窗口等功能。界面整理和高频系统操作被放到一起考虑，桌面或窗口内容一多时，管理起来会更省心。
使用xlwings读取受保护Excel工作表的批注时，直接调用range.note会返回None。正确方法是通过.api.Comment.Text()调用底层COM接口，即可绕过保护限制。需注意仅支持Windows桌面版Excel，并用try/except处理无批注异常。密码须在打开工作簿时传入。
在使用 xlwings 处理密码保护的 Excel 文件时，很多人会踩的一个坑是：直接调用 range.note 去读取批注，结果返回 None，明明单元格里明明有批注，却死活读不出来。这其实不是 bug，而是 .note 这个属性本身就比较“浅”——它是 xlwings 封装的一个轻量级只读接口，不会穿透 Excel 的保护层。而真正的批注对象，藏得更深，需要通过底层的 COM 接口才能访问。
那该怎么办？核心思路是：绕过外层封装，直接调用 Excel 应用程序的原生 API。具体来说，就是使用 .api.Comment.Text() 方法。注意大小写和括号，它直接跟 Excel 的 COM 对象对话，只要工作簿已经用密码成功打开，就能正常读取，不受保护限制。下面是一个标准示例：
import xlwings as xw
PATH = r'C:/Users/Hendo/Pictures/Sample.xlsx'
psw = '1234'
wb = xw.Book(PATH, password=psw)
sheet = wb.sheets['Sheet1']
# ✅ 正确：通过 COM 接口读取批注文本
try:
comment_text = sheet.range('H15').api.Comment.Text()
print("批注内容:", comment_text)
except AttributeError:
print("H15 单元格无批注")
print("单元格值:", sheet.range('H15').value)
有几个关键点需要留意：
- 这个方法只适用于 Windows 系统 + Excel 桌面版，因为依赖 COM 接口。
- 确保 Excel 已安装，并且 xlwings 的后端是默认的
app。 - 如果单元格没有批注，
.api.Comment会直接抛出AttributeError，所以必须用try/except兜底。 - 默认返回的是纯文本内容。如果你还需要作者、时间等元信息，可以访问
cmt.Author、cmt.Date等属性，下面批量方案里有具体写法。
如果你需要一次性提取全工作簿所有批注，包括位置、作者和内容，可以参考这个批量遍历的版本：
import xlwings as xw
excel_file = r'C:/Users/Hendo/Pictures/Sample.xlsx'
with xw.App(visible=False) as app:
wb = xw.Book(excel_file, password='1234') # ⚠️ 密码必须传入此处！
for sheet in wb.sheets:
print(f"---- 工作表 '{sheet.name}' ----")
# 检查该表是否存在批注
if sheet.api.Comments.Count > 0:
for cmt in sheet.api.Comments:
addr = cmt.Parent.Address.replace('$', '') # 如 'H15'
try:
text = cmt.Text()
author = cmt.Author
print(f"? 单元格: {addr}")
print(f"? 作者: {author}")
print(f"? 内容: {text}")
print("-" * 40)
except Exception as e:
print(f"[警告] 读取 {addr} 批注失败: {e}")
else:
print("→ 本工作表无批注")
wb.close()
总结下来，就几条核心原则：
- ❌ 别用
range.note处理受保护工作表的批注，它拿不到数据。 - ✅ 坚持走
.api.Comment.Text()路线，并配合异常处理。 - ? 密码必须在
xw.Book(..., password=...)中传入，否则 API 调用会失败。 - ? 批量处理时，建议关闭
visible=True，并显式调用close()关闭工作簿，避免后台 Excel 进程残留。
WPS Office是一款面向macOS用户的综合办公套件，将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式，支持Intel及Apple芯片Mac，基础功能可免费使用，
Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核，支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换，并可通过账户在多台设备之间同步项目。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Ableton Live 是面向音乐制作人与现场表演者的数字音频工作站，提供编曲视图、独具特色的现场视图、音频录制、MIDI创作、实时变速、乐器及效果器。Mac版原生支持Apple芯片，并可连接音频接口、MIDI控制器和第三方插件。
Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera
Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。
Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。
Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。
Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。
Postman 是面向 API 全生命周期的开发与协作平台。Windows 桌面版可用于构建和发送 HTTP、GraphQL、gRPC、WebSocket、MQTT 等请求，并提供环境变量、集合、脚本测试、模拟服务、监控、文档及团队工作区等
Navicat Premium 是一体化数据库开发与管理工具，可在同一界面连接 MySQL、PostgreSQL、SQL Server、Oracle、SQLite、MongoDB、Redis 等数据库，
Adobe Premiere（原名 Adobe Premiere Pro）是一款面向影视、短视频、广告和网络内容制作的专业非线性编辑软件。Windows 版提供多轨剪辑、字幕转录、调色、音频处理、动态图形、格式转换与智能辅助工具，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
WPS Office 是金山办公推出的一体化办公套件，在 Windows 上提供文字处理、电子表格、演示文稿和 PDF 工具，并支持常见 Microsoft Office 文件格式。个人用户可以免费使用基础功能，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件，支持 Windows、macOS 和 iPad 等平台，广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件，集建模、动画、渲染、视频编辑与视觉合成等功能于一体，广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎，并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统，安装包轻巧、运行流畅，依托活跃的全球开发者社区持续更新，是从初学者到专业创作者都值得选择的正版 3D 创作工具。
