在Mac系统中使用xlwings保存Excel工作簿失败求助

问题详情 #

在Windows和Mac的Jupyter Notebook中执行相同的xlwings代码保存Excel工作簿，Windows正常运行，Mac抛出参数错误。

执行代码 #

import xlwings as xw
import os

wb = xw.Book()
wb.save(os.path.join(os.getcwd(), r'pro/fi/g.xlsx'))
wb.close()

Mac端错误信息 #

CommandError: Command failed:
                OSERROR: -50
                MESSAGE: Parameter error.
                COMMAND: app (pid=71190). workbooks [ 'Book2'].save_workbook_as (filename='Macintosh HD: Users: mohit: Desktop: pro:fi:g.xlsx', overwrite=True, file_format=k.Excel_XML_file_format, timeout=-1, password=None)

原因分析 #

1. 路径格式问题：硬编码的r'pro/fi/g.xlsx'在Mac上会导致xlwings转换为AppleScript路径时出现格式异常，即便os.path.join会处理系统分隔符，嵌套的硬编码斜杠仍可能引发参数错误。
2. 父目录不存在：Mac版Excel无法自动创建不存在的父文件夹，若pro/fi目录未提前创建，会直接抛出参数错误。
3. 文件格式参数不匹配：错误中显示使用了Excel_XML_file_format格式，该格式在Mac上存在兼容性问题。

修复方案 #

修复后代码 #

import xlwings as xw
import os

# 拆分路径层级，用os.path.join统一处理跨平台分隔符
target_dir = os.path.join(os.getcwd(), 'pro', 'fi')
target_path = os.path.join(target_dir, 'g.xlsx')

# 提前创建目标目录（含子目录）
if not os.path.exists(target_dir):
    os.makedirs(target_dir)

wb = xw.Book()
# 显式指定xlsx格式，避免格式参数错误
wb.save(target_path, file_format=xw.constants.FileFormat.xlOpenXMLWorkbook)
wb.close()

关键修复点 #

• 规范路径拼接：将目录层级拆分后用os.path.join拼接，保证生成符合当前系统要求的路径格式。
• 预创建目录：提前检查并创建目标父目录，解决Mac无法自动创建目录的问题。
• 显式指定格式：使用xlOpenXMLWorkbook（标准xlsx格式），避免默认格式在Mac上的兼容性问题。

内容的提问来源于stack exchange，提问作者M J