0Pricing
Dart Academy · 课时

pubspec.yaml 的组成

声明元数据、依赖项与约束

pubspec.yaml 的组成 是 CoddyKit 上的免费 Dart Academy 课时。 这是第 1 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Dart Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Dart Academy 课程共包含 4 节课。

认识 pubspec.yaml

每个 Dart 项目的根目录中都有一个 pubspec.yaml。它是项目清单,用于描述项目并列出项目依赖的所有内容。📄

为什么使用 YAML

Dart 在这里使用 YAML,因为它便于人类阅读:缩进表示结构,键后面写冒号和值。不需要花括号。

name: my_app
version: 1.0.0

name 字段

name 字段是必需的。它必须使用小写字母和下划线,并会成为其他代码导入您软件包时使用的标识符。

name: weather_client

描述和版本

请添加简短的 description,让人们了解您的软件包用途;再添加遵循 major.minor.patch 格式的 version,例如 1.2.0。

description: A tiny weather client.
version: 1.2.0

environment 键

environment 键声明项目支持哪些 Dart SDK 版本。如果您的 SDK 超出此范围,工具就会拒绝运行。

environment:
  sdk: ^3.0.0

运行时依赖

dependencies 部分列出代码在运行时需要的软件包。每个条目都会将软件包名称映射到版本约束。

dependencies:
  http: ^1.2.0

dev_dependencies

对于只在构建期间需要的工具,请使用 dev_dependencies,例如测试或代码检查软件包。使用您软件包的人不会获得这些工具。

dev_dependencies:
  test: ^1.24.0

插入符号版本约束

像 ^1.2.0 这样的 caret 表示接受从 1.2.0 开始、但不包括 2.0.0 的任何版本。这样可以接受安全且兼容的更新。

http: ^1.2.0

缩进很重要

YAML 使用空格而不是制表符来表示嵌套。键的对齐错误会破坏文件,因此请始终保持两个空格的缩进。

dependencies:
  http: ^1.2.0

其他实用字段

您还可以添加 homepage、repository 和 publish_to 字段。它们可以为用户提供链接,并允许您在需要时将软件包保持为私有。

homepage: https://example.com
publish_to: none

pub 从哪里读取

运行 pub 命令时,工具会先读取 pubspec.yaml 以了解依赖项,然后为您获取并解析所有内容。🔧

快速检查

只在开发期间需要的软件包应该放在哪里?

回顾

您已经了解,pubspec.yaml 会为项目命名、设置 SDK 范围,并列出运行时依赖和开发依赖。它是每个 Dart 项目的核心。🎉

常见问题解答

「pubspec.yaml 的组成」课时是免费的吗?

是的 — 「pubspec.yaml 的组成」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Dart Academy 课程的其余内容,请升级到 CoddyKit PRO。 Dart Academy 课程共包含 4 节课。

「pubspec.yaml 的组成」这节课中我会学到什么?

声明元数据、依赖项与约束 你通过在浏览器中直接运行的动手代码来练习 Dart Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Dart Academy 需要有经验吗?

无需任何先前经验。CoddyKit 上的 Dart Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 1 节课,共 4 节。

「pubspec.yaml 的组成」课时需要多长时间?

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。

我能在这节 Dart Academy 课中编写并运行代码吗?

能。每节 Dart Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. pubspec.yaml 的组成
  2. 使用 dart pub 添加依赖项
  3. 导入、导出与库
  4. 版本约束与锁定文件
← 返回 Dart Academy