跨平台开发 / 系统课时
使用 dart 命令与编辑器
使用 dart 命令与编辑器
本课把 Dart 开发的最小反馈闭环搭起来:先确认 dart 命令可用,再用编辑器完成语法提示与保存时格式化,最后练习运行、静态分析和格式化。完成后,你能在每次修改代码后立刻判断“能否运行、有没有问题、格式是否统一”。
学习目标
- 说清
dart run、dart analyze、dart format与dart pub的主要职责。 - 以 VS Code 为例完成 Dart 扩展与保存时格式化的基础配置。
- 独立完成“编辑 → 运行 → 分析 → 格式化”的验证流程。
先确认 Dart CLI 可用
dart 是 Dart SDK 的统一命令行入口。无论后面使用编辑器还是终端,先在终端确认它能被系统找到;如果这里失败,编辑器通常也无法正确定位 SDK。
dart --version预期输出
Dart SDK version: <VERSION> (stable) (<TIME>) on "<PLATFORM>"<VERSION>、<TIME> 与 <PLATFORM> 会随安装版本和操作系统不同而变化。若出现 command not found、'dart' is not recognized 等提示,应先修复 SDK 安装或 PATH,不要继续排查代码。
认识常用 dart 子命令
日常开发不需要记住所有子命令,先掌握几个会反复使用的入口即可。
| 命令 | 主要职责 | 常见使用时机 |
|---|---|---|
dart run |
运行 Dart 程序或包中的可执行入口 | 修改代码后验证行为 |
dart analyze |
对文件或项目执行静态分析 | 运行前发现类型、语法和 lint 问题 |
dart format |
按 Dart 官方格式化规则重写源码 | 保存前或提交代码前统一格式 |
dart pub |
获取、添加、升级和检查包依赖 | 项目存在 pubspec.yaml 时管理依赖 |
dart test |
运行项目测试 | 修改逻辑后执行回归验证 |
dart create |
根据模板创建项目 | 新建命令行、包、Web 等工程 |
可以用 dart help <COMMAND> 查看某个子命令的参数,例如 dart help analyze。实际开发时,把“运行、分析、格式化”当作一个连续动作,比只盯着程序能否启动更可靠。
配置编辑器的即时反馈
以 VS Code 为例,先在扩展面板安装官方 Dart 扩展。安装后打开包含 Dart 文件或 pubspec.yaml 的目录,编辑器会提供语法高亮、静态诊断、跳转和格式化等能力。
如果希望保存 Dart 文件时自动格式化,可在 VS Code 的 settings.json 中加入下面的配置。这是配置片段,不是独立程序。
{
"[dart]": {
"editor.formatOnSave": true
}
}保存一个 .dart 文件后,如果缩进和空白自动调整,说明格式化配置已经生效。静态诊断与 dart analyze 使用同一套分析能力,因此编辑器中的红线或警告不应简单忽略。
完成一次开发闭环
在空目录中创建 hello.dart,先写一个最小可运行程序。这里把业务逻辑压到几行,重点观察工具链的职责。
void main() {
// 保持示例简单,把注意力放在运行、分析和格式化流程上。
final name = 'Dart';
print('Hello, $name!');
}在文件所在目录依次执行运行、分析和格式化:
dart run hello.dart
dart analyze hello.dart
dart format hello.dart预期输出
Hello, Dart!
Analyzing hello.dart...
No issues found!
Formatted 1 file (0 changed) in <TIME> seconds.<TIME> 是本机执行耗时,实际值可能不同。如果源码尚未符合格式化规则,最后一行中的变更数量可能是 1 changed;再次执行后通常会变成 0 changed。
这三个动作回答不同问题:run 证明当前输入下程序能执行,analyze 检查无需运行就能发现的静态问题,format 统一源码布局。形成“写完立即验证”的习惯后,很多错误会在进入下一段代码之前被发现,而不是积累到项目后期。