Skip to content

1. 简介

本文档的 PDF 版本在|这里|。

本文档的代码在|这里|。

本文档由 Anthropic 的 Claude AI生成。其目的是将文档 [通过示例学习 TypeScript 语言和 NestJS Web 框架入门] 中的 TypeScript 语言替换为 Dart 语言,从而对其进行改编。

Anthropic Claude AI 模型 完成了大部分工作(90%):

  • 代码生成:所有代码均由 Claude 生成。我只是按照生成的课程对其进行测试。Claude 工作的环境中没有 Dart(不同于 TypeScript 课程,那里 Claude 可以执行并验证每个脚本):本课程的脚本以同样的细致程度编写和审阅,并检查了语法(花括号和圆括号是否配对、每个可执行脚本中是否有 [main] 入口点),但在交付前无法编译或执行。注意:所有交付的代码均已由课程审校者测试。发现的错误已报告给 Claude,并由其立即修正。
  • ODT 格式课程的生成:Claude 应我的要求生成了多个版本。这是我主要参与的部分。

Serge Tahé,2026 年 9 月

==

本文档是 [Dart] 语言的入门课程,其设计原则与 [通过示例学习 TypeScript 语言和 NestJS Web 框架入门(2026)] 课程相同:通过一系列逐行注释的独立小脚本来学习一门语言,而不是通过对其语法的理论阐述。

课程的进度与 TypeScript 课程完全一致:相同的概念、相同的顺序,每个 TypeScript 脚本旁都配有一个 Dart 脚本。这种对称是有意为之的:它使你可以随时直接比较 Dart 和 TypeScript 如何满足同一需求,并且对于每一处差异,分辨哪些只是语法选择的结果,哪些源于两种语言之间的根本差异(结构化类型与名义类型、编译与转译、是否存在隐式强制转换等)。

TypeScript 课程中的两章在这里被有意省略:[Introduction to the NestJS Web Framework] 和 [Case Study: The Tax Calculation Server in NestJS]。这两章讲的是用 TypeScript 编写的服务器端 Web 框架,与学习 Dart 语言本身没有直接关系。不过,NestJS 所得税计算服务器予以保留:一旦安装完成(参见章节“安装 NestJS服务器”),它就可以作为测试 Dart 函数的真实目标,正如它在原课程中作为 HTTP 和 TypeScript 客户端的目标一样。

不过,本课程与 TypeScript 课程在范围上有一处不同:TypeScript 课程的 [The Fundamentals] 部分用了整整三节介绍 ECMAScript 的近期更新(2020–2024、2026)以及 [Temporal] API。这些新特性是 JavaScript/TypeScript 特有的,在 Dart 中没有直接对应物;在这里它们被替换为一节 [Dart 3.x New Features],专门介绍 Dart 特有的近期特性:[records]、[pattern matching]、[sealed] 类以及类修饰符。

1.1. 目标读者与先决条件

本课程面向已经熟悉编程的读者,最好是已学过 TypeScript 课程的读者,因为两种语言之间的持续对比是这里所采用教学方法的核心。不需要事先了解 Dart:每个新概念都通过一个最小化的脚本引入,并附有详细注释。

有一种常见的误解,把 Dart 简化为“Flutter 的语言”;与之相反,本课程自始至终不涉及 Flutter 或移动界面:Dart 在这里被用作通用编程语言,通过命令行([dart run])运行,正如原课程中使用 [tsx] 运行 TypeScript 一样。

1.2. 示例项目的组织结构

Image

Image

本课程的脚本放在一个单独的目录结构 [dart-fundamentals/] 中,它与 TypeScript 课程的文件夹结构一一对应([basics/]、[arrays/]、[objects/]、[strings/]、[regexp/]、[functions/]、[exceptions/]、[modules/]、[async/]、[classes/]、[http/]……),另外还增加了一个新文件夹 [dart3/],用于 [Dart 3.x New Features] 一节。第二个目录树 [dart-databases/] 包含“数据库访问”一章的内容。每个文件夹都有自己的 [README.md],必要时还有自己的 [pubspec.yaml](相当于 Node.js 的 [package.json];参见下一章)。

每个脚本都通过命令 [dart run] 后接脚本路径来单独运行,例如 [dart run dart-fundamentals/basics/basics_01.dart]。运行单个脚本不需要完整安装项目:在包含 [pubspec.yaml] 的文件夹根目录下运行一次 [dart pub get](相当于 [npm install]),就足以安装该文件夹中所有脚本的依赖项。