2. 搭建开发环境
注意:在接下来的步骤中,我们将使用 VSCode 工具来测试 Dart 脚本。打开两个 VSCode 窗口,并使用 [File / Open Folder] 打开这两个项目的文件夹。
TypeScript 课程需要安装 Node.js、一个 npm 项目([package.json])、TypeScript 本身及其类型检查器([tsc])、一个无需预先编译的脚本运行器([tsx]),最后还有 ESLint。与这整套工具链对应的 Dart 方案只需要安装一个组件:[Dart SDK],可以从 [dart.dev] 下载,或者更简单地通过系统包管理器安装(Windows 上用 [choco install dart-sdk],macOS 上用 [brew install dart],Linux/Debian/Ubuntu 上使用官方 APT 仓库)。
TypeScript 需要三个独立的工具(用于检查类型的 [tsc] 编译器、无需先编译即可运行脚本的 [tsx],以及用于风格分析的 ESLint),而 Dart SDK 通过单个命令 [dart] 就提供了所有这些功能,它包含以下子命令:[dart run](运行脚本)、[dart analyze](检查风格,相当于 [tsc] 和 ESLint 的结合)、[dart pub](管理依赖项,相当于 [npm])、[dart format](重新格式化代码,相当于 Prettier)和 [dart test](运行测试)。
2.1. 验证已安装的工具
安装 SDK 之后,在 VSCode 的终端中验证安装:
PS C:\Data\st-2026\dev\dart\dart-sept-2026-scripts\dart-fundamentals> dart --version
Dart SDK version: 3.12.2 (stable) (Tue Jun 9 01:11:39 2026 -0700) on "windows_x64"
该命令会显示 SDK 的版本(例如 [Dart SDK version: 3.12.2 (stable)])。与分别安装的 Node.js 和 TypeScript(一个 Node 版本、一个 TypeScript 版本)不同,Dart SDK 的版本号涵盖了语言、编译器以及由 [dart] 控制的所有工具:只需要跟踪一个版本。
2.2. 设置 VSCode 项目
与 TypeScript 一样,创建一个项目文件夹并在 VSCode 中打开它。TypeScript 项目需要用两个文件来声明(用 [package.json] 声明依赖项,用 [tsconfig.json] 声明编译器选项),而 Dart 项目只需要一个文件:[pubspec.yaml]。
2.2.1. pubspec.yaml 文件
[pubspec.yaml] 既起到 [package.json] 的作用(项目名称、依赖项),在较小程度上也起到 [tsconfig.json] 的作用(键 [environment: sdk:] 设定可接受的 Dart SDK 版本范围,很像 [target]/[lib] 定义 [tsc] 所针对的 ECMAScript 版本):
与 [package.json](JSON 格式)不同,[pubspec.yaml] 严格来说是一个 YAML 文件,其中缩进是有意义的,就像在 Python 中一样。
编写好此文件后,命令 [dart pub get](相当于 [npm install])会下载所声明的依赖项,并生成一个 [pubspec.lock] 文件(相当于 [package-lock.json]),用于锁定要安装的确切版本。
2.3. 第一个脚本
一个最小的 Dart 脚本 [hello.dart]:
使用以下命令运行:
与课程中第一个 TypeScript 脚本相比,有两个明显的差异:函数 [main] 在这里是必需的(可执行的 Dart 脚本必须在文件层级定义一个名为 [main] 的函数,这与 TypeScript/[tsx] 不同,后者文件中的顶层代码会直接运行,无需定义函数);并且 [dart run] 将编译和执行合并为一步,没有可见的单独转译步骤(类似 [tsx],但无需安装任何额外工具:[dart run] 是 SDK 本身的一部分)。
2.4. 第二个脚本:静态分析
TypeScript 课程区分了“类型检查”步骤([tsc --noEmit])和单独的 ESLint 步骤,而 Dart 将两者合并为一个命令:
在包含 [pubspec.yaml] 文件的项目根目录下不带参数运行时,它会分析项目中所有的 [.dart] 文件:既标出类型错误(相当于 [tsc]),也标出已启用的 lint 规则所涵盖的风格问题(相当于 ESLint);关于如何启用这些规则,请参见下一节。
2.5. linter
ESLint 是必须单独安装和配置的外部工具(文件 [eslint.config.js]、选择预设等)。Dart 则把自己的 linter 直接集成在 [dart analyze] 中:只需把官方的 [package:lints] 包添加到 [pubspec.yaml] 的 [dev_dependencies] 中,然后在项目根目录创建一个 [analysis_options.yaml] 文件:
这个文件的作用与 TypeScript 课程中的 [eslint.config.js] 相同:它启用 Dart 团队推荐的一组规则(未使用的变量、可疑的比较、优先使用 [const] 等),[dart analyze] 随后会自动应用这些规则。
2.6. VSCode 的 Dart 扩展
官方的 [Dart] 扩展(发布者:Dart Code)可从 VSCode 扩展市场安装,其作用与 TypeScript 课程中的 ESLint 扩展完全相同,但功能更全面:语法高亮、自动补全、在编辑器中直接显示 [dart analyze] 的错误,以及无需离开 VSCode 即可运行脚本(每个 [main] 函数上方的 [Run]/[Debug] 按钮)。只需安装这一个扩展,就涵盖了 TypeScript 课程中分散在多个扩展里的功能。