跨平台开发 / 系统课时
创建并运行第一个 Dart 项目
创建并运行第一个 Dart 项目
本课从一个标准命令行项目开始,完成创建、识别目录职责、找到 main 入口并运行程序。重点不是记住所有生成文件,而是建立“项目根目录 → pubspec.yaml → bin 入口 → lib 逻辑 → test 验证”的路径意识。
学习目标
- 使用
dart create创建标准 Dart 命令行项目并确认生成成功。 - 解释
pubspec.yaml、bin、lib与test的常见职责。 - 从
main入口调用lib中的代码,并使用dart run验证执行路径。
创建标准命令行项目
在准备存放项目的目录中执行下面的命令。当前 dart create 未指定模板时默认使用 console 模板,并在创建文件后获取项目依赖。
dart create first_dart_app
cd first_dart_app预期结果
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,把可复用逻辑放进去:
String buildGreeting(String name) {
// 可复用逻辑放在 lib,入口和测试都可以调用它。
return 'Hello, $name!';
}再把 bin/first_dart_app.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。
运行并核对执行路径
仍在项目根目录执行两次程序:第一次使用默认名字,第二次显式传入命令行参数。
dart run
dart run bin/first_dart_app.dart Alice预期输出
Hello, Dart!
Hello, Alice!首次运行时终端可能额外显示构建可执行目标的提示,这是工具输出,不影响程序最终打印结果。只要两行问候分别出现,就能确认默认入口和显式文件入口都正确调用了 lib/greeting.dart。
如果 dart run 提示找不到包配置,先确认当前目录中是否存在 pubspec.yaml;如果 package:first_dart_app/... 无法解析,再核对 pubspec.yaml 的 name 是否仍为 first_dart_app。项目能否运行,不只取决于 main 写得对不对,也取决于入口位置、包名与目录结构是否彼此对应。