跨平台开发 / 系统课时

使用 dart 命令与编辑器

使用 dart 命令与编辑器

本课把 Dart 开发的最小反馈闭环搭起来:先确认 dart 命令可用,再用编辑器完成语法提示与保存时格式化,最后练习运行、静态分析和格式化。完成后,你能在每次修改代码后立刻判断“能否运行、有没有问题、格式是否统一”。

学习目标

  • 说清 dart run、dart analyze、dart format 与 dart pub 的主要职责。
  • 以 VS Code 为例完成 Dart 扩展与保存时格式化的基础配置。
  • 独立完成“编辑 → 运行 → 分析 → 格式化”的验证流程。

先确认 Dart CLI 可用

dart 是 Dart SDK 的统一命令行入口。无论后面使用编辑器还是终端,先在终端确认它能被系统找到;如果这里失败,编辑器通常也无法正确定位 SDK。

bash
dart --version

预期输出

text
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 中加入下面的配置。这是配置片段,不是独立程序。

json
{
  "[dart]": {
    "editor.formatOnSave": true
  }
}

保存一个 .dart 文件后,如果缩进和空白自动调整,说明格式化配置已经生效。静态诊断与 dart analyze 使用同一套分析能力,因此编辑器中的红线或警告不应简单忽略。

完成一次开发闭环

在空目录中创建 hello.dart,先写一个最小可运行程序。这里把业务逻辑压到几行,重点观察工具链的职责。

dart
void main() {
  // 保持示例简单,把注意力放在运行、分析和格式化流程上。
  final name = 'Dart';
  print('Hello, $name!');
}

在文件所在目录依次执行运行、分析和格式化:

bash
dart run hello.dart
dart analyze hello.dart
dart format hello.dart

预期输出

text
Hello, Dart!
Analyzing hello.dart...
No issues found!
Formatted 1 file (0 changed) in <TIME> seconds.

<TIME> 是本机执行耗时,实际值可能不同。如果源码尚未符合格式化规则,最后一行中的变更数量可能是 1 changed;再次执行后通常会变成 0 changed。

这三个动作回答不同问题:run 证明当前输入下程序能执行,analyze 检查无需运行就能发现的静态问题,format 统一源码布局。形成“写完立即验证”的习惯后,很多错误会在进入下一段代码之前被发现,而不是积累到项目后期。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 dart 命令与编辑器

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

登录哪都通