DartPad 故障排除

本页介绍在使用 DartPad 时可能出现的问题的解决方案，无论是在 dartpad.dev 网站上还是在嵌入了 DartPad 的页面中。有关 DartPad 的概览，请参阅 DartPad 页面。

dart.dev 主页和许多教程都嵌入了 DartPad。如果这些 DartPad 完全不显示，请尝试以下方法：

• 确保你使用的是 Chrome、Edge、Firefox 或 Safari 的最新两个版本之一。DartPad 可能无法在其他浏览器中使用，并且已知在 Brave 浏览器的默认配置下无法使用。

• 如果你使用了广告拦截器，请禁用它。

• 检查你是否已禁用第三方跟踪 Cookie（Chrome 说明）。如果你已禁用 Cookie，请更改设置以允许 dartpad.dev 的 Cookie。如果你使用嵌入的 DartPad，例如在 Dart 速查表 或 隐式动画代码实验室 中，你可能还需要允许嵌入站点域名的 Cookie（在这些情况下，分别为 dart.dev 和 docs.flutter.dev）。

• 如果你反复重新加载包含嵌入式 DartPad 的页面，可能会遇到 GitHub 速率限制。在 60 分钟内，你应该能够重新加载页面并看到嵌入式 DartPad 中的代码。

虽然 DartPad 不使用 Cookie，但它依赖于本地存储，而浏览器通常在禁用 Cookie 时也会禁用本地存储。

如果你将 DartPad 中的代码复制到其他环境中，代码可能无法成功运行。以下是一些可能的原因和解决方法：

• 如果 Dart 无法找到导入的库，请确保你已添加所有必需的包依赖项。DartPad 默认包含许多内置包，但你自己的项目必须明确列出其依赖的包。要查看 DartPad 包含的包，请访问 dartpad.dev 并点击窗口右下角的 i 图标。要了解如何为自己的项目添加包依赖项，请参阅 dart pub add 的文档。

• 如果 Dart 找不到某些方法或属性，请检查练习中随附的代码。

• 如果代码存在其他编译错误，请确保你使用的是最新稳定版本的 Dart SDK。DartPad 和嵌入式示例通常使用 SDK 的最新稳定版本，而旧版本可能缺少必要的语言或库功能。要了解如何更新 Dart SDK，请参阅 获取 Dart SDK。

• 如果你正在创建 Web 应用，请确保项目设置正确。DartPad 不会显示运行 Dart 代码所需的所有必要标记。要开始使用 Dart 创建 Web 应用，请查看 使用 Dart 构建 Web 应用。

如果代码使用了 Dart 最新稳定版本中不再支持的语言或库特性，代码可能无法再进行分析或无错误运行。

• 如果可能，请更新代码以兼容最新的 Dart 版本，因为 DartPad 仅支持 稳定 和 beta 频道。
• 如果代码在之前的 Dart 版本中可以运行，你可以在本地使用该版本的 Dart。要了解如何安装特定版本的 Dart，请查看 获取 Dart SDK。

尝试访问 dartpad.cn。

如果你在使用 DartPad 时遇到任何其他问题，请在 GitHub 上创建问题。