跨平台开发 / 系统课时

创建并运行第一个 Dart 项目

创建并运行第一个 Dart 项目

本课从一个标准命令行项目开始,完成创建、识别目录职责、找到 main 入口并运行程序。重点不是记住所有生成文件,而是建立“项目根目录 → pubspec.yaml → bin 入口 → lib 逻辑 → test 验证”的路径意识。

学习目标

  • 使用 dart create 创建标准 Dart 命令行项目并确认生成成功。
  • 解释 pubspec.yaml、bin、lib 与 test 的常见职责。
  • 从 main 入口调用 lib 中的代码,并使用 dart run 验证执行路径。

创建标准命令行项目

在准备存放项目的目录中执行下面的命令。当前 dart create 未指定模板时默认使用 console 模板,并在创建文件后获取项目依赖。

bash
dart create first_dart_app
cd first_dart_app

预期结果

text
Creating first_dart_app using template console...
<DEPENDENCY_OUTPUT>
Created project first_dart_app in first_dart_app!

<DEPENDENCY_OUTPUT> 代表依赖解析与下载信息,具体包数量和耗时可能不同。创建成功后,应在 first_dart_app 根目录中看到 pubspec.yaml,并能找到 bin、lib 和 test 等目录。

读懂项目中的关键位置

pubspec.yaml 位于项目根目录,是 Dart 包的声明文件。它记录包名、SDK 约束以及依赖等信息;dart pub 会围绕这个文件解析依赖,因此执行项目级命令时通常应先进入包含它的根目录。

位置 主要职责
pubspec.yaml 定义包的基本信息、SDK 约束和依赖
bin/ 放置可执行入口,命令行应用的 main 通常在这里
lib/ 放置可复用、可通过 package: 导入的库代码
test/ 放置测试文件,通常以 _test.dart 结尾
analysis_options.yaml 配置静态分析和 lint 规则
.dart_tool/ 工具生成的项目状态与缓存,不应手工维护

lib 与 bin 的边界很重要:把可复用逻辑放到 lib,把参数接收、启动和输出等入口职责放到 bin,后续测试与复用都会更自然。

从 main 入口调用 lib

先在 lib 下新增 greeting.dart,把可复用逻辑放进去:

dart
String buildGreeting(String name) {
  // 可复用逻辑放在 lib,入口和测试都可以调用它。
  return 'Hello, $name!';
}

再把 bin/first_dart_app.dart 改为下面的入口代码:

dart
import 'package:first_dart_app/greeting.dart';

void main(List<String> arguments) {
  // bin 只负责处理启动参数并调用库代码。
  final name = arguments.isEmpty ? 'Dart' : arguments.first;
  print(buildGreeting(name));
}

这里的 main 是程序入口。dart run 启动可执行目标后,从 main 开始执行;package:first_dart_app/greeting.dart 则根据 pubspec.yaml 中的包名解析到 lib/greeting.dart。

运行并核对执行路径

仍在项目根目录执行两次程序:第一次使用默认名字,第二次显式传入命令行参数。

bash
dart run
dart run bin/first_dart_app.dart Alice

预期输出

text
Hello, Dart!
Hello, Alice!

首次运行时终端可能额外显示构建可执行目标的提示,这是工具输出,不影响程序最终打印结果。只要两行问候分别出现,就能确认默认入口和显式文件入口都正确调用了 lib/greeting.dart。

如果 dart run 提示找不到包配置,先确认当前目录中是否存在 pubspec.yaml;如果 package:first_dart_app/... 无法解析,再核对 pubspec.yaml 的 name 是否仍为 first_dart_app。项目能否运行,不只取决于 main 写得对不对,也取决于入口位置、包名与目录结构是否彼此对应。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建并运行第一个 Dart 项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通