🚀 在 Android Studio 中运行 Dart 语言代码的完整教程

本文适合 Dart/Flutter 初学者，带你从 0 到 1 掌握 Android Studio 开发 Dart 的全流程

---

🎯 前言

Dart 是 Flutter 框架的官方开发语言，而 Android Studio 作为 Flutter 开发的首选 IDE，其强大的插件生态和调试能力能让你的 Dart 开发效率翻倍。本文将从插件安装、项目创建、代码编写、运行调试到问题排查，带你完整掌握在 Android Studio 中开发 Dart 代码的全流程。

---

一、安装 Flutter & Dart 插件

Android Studio 需通过插件支持 Dart 开发，安装步骤如下：

1. 打开插件市场
   启动 Android Studio，依次点击：
   File > Settings > Plugins（Windows/Linux）
   或 Android Studio > Settings > Plugins（Mac）

2. 搜索并安装插件
   在搜索框输入 Flutter，找到官方插件后点击 Install。安装过程中会自动提示安装依赖的 Dart 插件，确认安装即可。

3. 验证安装
   安装完成后重启 Android Studio，在 File > New 菜单中若出现 New Flutter Project，则表示插件安装成功。

---

二、创建 Dart 项目

可以选择创建纯 Dart 项目或 Flutter 应用项目，这里以 Flutter 应用项目为例：

新建项目

1. 选择 File > New > New Flutter Project
2. 在弹出的窗口中选择 Flutter Application（若仅需纯 Dart 项目，可选择 Flutter Package 或 Flutter Plugin）
3. 填写项目名称（如 DartDemo）、选择存储路径，并确保 Flutter SDK 路径正确（若未自动识别，需手动指定 Flutter 安装目录）

项目结构解析

• lib/main.dart：Dart 代码的入口文件，所有逻辑从这里开始
• pubspec.yaml：依赖管理文件，用于添加第三方库或资源

---

三、编写 Dart 代码

在 lib/main.dart 中替换默认代码为以下示例（包含函数、类和异步操作）：

// 主函数：程序入口
void main() {
  printGreeting("Dart");
  calculateSum(10, 20);
  fetchData().then((data) => print(data));
}

// 自定义函数：打印问候语
void printGreeting(String name) {
  print("Hello, $name!");
}

// 自定义函数：计算两数之和
int calculateSum(int a, int b) {
  int sum = a + b;
  print("Sum: $sum");
  return sum;
}

// 异步函数：模拟网络请求
Future<String> fetchData() async {
  await Future.delayed(Duration(seconds: 2)); // 模拟延迟
  return "Data fetched successfully!";
}

代码规范提示

• Dart 中 main() 是程序的唯一入口，无返回值
• 使用 async/await 处理异步操作，避免回调地狱
• 变量命名使用小驼峰（如 userName），类名使用大驼峰（如 UserInfo）

---

四、运行 Dart 代码

选择运行目标

• 模拟器：点击工具栏中的设备下拉菜单，选择已创建的模拟器（如 Pixel 5），若未安装模拟器，点击 AVD Manager 创建
• 真机：通过 USB 连接手机，开启「开发者模式」和「USB 调试」，Android Studio 会自动识别设备

运行代码

1. 右键点击 main.dart 文件，选择 Run 'main.dart'
2. 或点击工具栏的绿色运行按钮 ▶️
3. 纯 Dart 脚本（非 Flutter 应用）可直接运行，输出会显示在 Run 控制台中

---

五、调试 Dart 代码

设置断点

在代码行号左侧点击，出现红色圆点即为断点。例如，在 printGreeting 函数内设置断点。

启动调试模式

点击工具栏的 Debug 'main.dart' 按钮（或按 Shift+F9），程序会在断点处暂停。

调试操作

• Step Over (F8)：执行下一行代码，但不进入函数内部
• Step Into (F7)：进入当前行的函数内部
• Resume Program (F9)：继续执行到下一个断点
• 查看变量：在 Debug 面板的 Variables 窗口中，可实时查看变量值和调用栈

---

六、配置运行环境

手动配置 Dart SDK

若 Android Studio 未自动识别 Dart SDK，需手动指定路径：

1. 依次点击 File > Settings > Languages & Frameworks > Dart
2. 在 Dart SDK path 中输入 Flutter SDK 目录下的 dart-sdk 路径（如 C:\flutter\bin\cache\dart-sdk）

配置 launch.json（适用于 VS Code 联动）

若需在 VS Code 中运行，需在项目根目录创建 .vscode/launch.json 文件，添加以下配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Dart",
      "program": "lib/main.dart",
      "request": "launch",
      "type": "dart"
    }
  ]
}

---

七、常见问题及解决方案

错误类型	原因分析	解决方案
Dart SDK not found	未正确配置 Dart SDK 路径	1. 检查 Flutter SDK 是否完整；2. 在 Settings > Dart 中重新指定路径
设备未识别	真机未开启 USB 调试或驱动问题	1. 开启手机「开发者模式」和「USB 调试」；2. 安装对应品牌的 USB 驱动
运行时无输出	代码无 print 语句或控制台被隐藏	1. 确保代码中有 print 或 debugPrint；2. 打开 View > Tool Windows > Run
依赖缺失	pubspec.yaml 未配置依赖	在 pubspec.yaml 中添加依赖（如 http: ^0.13.5），然后点击 Pub get

---

八、扩展技巧

使用 Dart DevTools

运行 Flutter 应用时，点击 Open DevTools 按钮（或按 Ctrl+Alt+D），可打开 Dart 开发者工具，用于性能分析、UI 检查等。

热重载（Hot Reload）

在 Flutter 应用中，修改代码后按 Ctrl+S（或点击工具栏的 Hot Reload 按钮），无需重启即可看到效果，大幅提升开发效率。

---

📌 总结

通过以上步骤，你可以在 Android Studio 中高效编写、运行和调试 Dart 代码。如果遇到复杂问题，可参考 Dart 官方文档 或 Flutter 中文网 获取更多帮助。

---