排除 Excel 中的 Python 错误

Excel 中的 Python 目前为预览版，可能会根据反馈进行更改。若要使用此功能，请加入 Microsoft 365 会员计划，并选择“Beta 版频道”预览体验成员级别。

Excel 中的 Python 将使用 Beta 版频道逐步向 Excel for Windows 客户推出。目前，该功能在其他平台上不可用。

如果在使用 Excel 中的 Python 时遇到任何问题，请通过在 Excel 中选择“帮助”>“反馈”来报告这些问题。

不熟悉 Excel 中的 Python？从 Excel 中的 Python 简介和 Excel 中的 Python 入门开始。

功能要求

在排查错误之前，请查看以下要求列表。

平台可用性

此功能在以下平台上不可用。

Excel for Mac
Excel 网页版
Excel for iPad
Excel for iPhone
Excel for Android

有关其他可用性信息，请参阅 Excel 中的 Python 可用性。

Internet 访问

Excel 中的 Python 需要 Internet 访问，因为计算在 Microsoft 云中的远程服务器上运行。计算不是由本地 Excel 应用程序运行的。

排查 Excel 错误

Excel 中的 Python 计算可以向 Python 单元格返回标准 Excel 错误，例如 #PYTHON!、#BUSY! 和 #CONNECT!。

访问错误消息

若要详细了解 Excel 错误如何适用于 Python 公式，请打开错误消息。若要打开错误消息，请选择单元格旁边的错误符号，然后从菜单中选择“显示错误消息”。以下屏幕截图显示了包含“显示错误消息”的错误菜单。

Excel 中的 Python 单元格出现错误，错误菜单已打开。

接下来，Excel 会显示包含附加信息的 Python 错误消息。在本例中，#PYTHON! 错误是由于 Python 公式中第 1 行的 Python 语法无效造成的。

注意: 如果返回 #PYTHON! 错误，诊断任务窗格会自动在 Excel 中打开。请参阅以下部分中的 #PYTHON! 错误信息，了解有关诊断任务窗格的详细信息。

常见错误

#BLOCKED!

必须在工作簿中启用 Excel 中的 Python 才能计算 Python 公式。如果看到 #BLOCKED! 错误，请确保你有权访问 Microsoft 365 连接的服务。

#BUSY!

#BUSY! 错误表示 Python 计算正在 Microsoft 云中运行。如果 #BUSY! 错误显示时间超过 60 秒，请尝试重置 Python 运行时。从“公式”选项卡的“Python”组中，选择“重置运行时”。或者使用键盘快捷方式 Ctrl+Alt+Shift+F9。

#CALC!

Excel 中的 Python 不支持引用具有可变值的单元格，例如使用 RAND 函数的单元格。引用具有可变值的单元格的 Python 公式返回 #CALC 错误。

Excel 中的 Python 计算一次最多可以处理 100 MB 的数据。尝试运行数据超过 100 MB 的计算会返回 #CALC! 错误。尝试使用较小的数据集。

#CONNECT!

尝试通过重置 Python 运行时来刷新与 Microsoft 云的连接。从“公式”选项卡的“Python”组中，选择“重置运行时”。或者使用键盘快捷方式 Ctrl+Alt+Shift+F9。

#PYTHON!

#PYTHON! 错误可能表示 Python 语法错误。如果返回 #PYTHON! 错误，诊断任务窗格会自动打开。查看诊断任务窗格以查看有关错误的详细信息。

查看诊断任务窗格

诊断任务窗格显示在 Excel UI 中的网格右侧。使用诊断任务窗格，可以连续查看 Excel 中的 Python 计算的标准输出、标准错误和解释器错误。若要手动打开诊断任务窗格，请转到工作表中的 Python 单元格，打开上下文菜单（右键单击或 Ctrl+单击单元格），并选择“诊断”。

以下屏幕截图显示了诊断任务窗格，其中显示了一个错误：单元格 C1 中的 Python 公式存在语法错误。

Excel 中的 Python 诊断任务窗格，显示语法错误。

#SPILL!

#SPILL! 错误可能指示 Python 输出区域中的单元格已包含数据。这可能是因将 Python 对象作为 Excel 值返回造成的。 Excel 值可能会跨多个单元格溢出。请参阅如何更正 #SPILL! 错误了解解决策略。

#UNKNOWN!

Python 单元格中的 #UNKNOWN! 错误可能表示 Excel 版本不支持 Excel 中的 Python。有关详细信息，请参阅本文前面的功能要求部分。