用Stagehand创建命令行应用console模板从零开始的实战教程【免费下载链接】stagehandDart project generator - web apps, console apps, servers, and more.项目地址: https://gitcode.com/gh_mirrors/sta/stagehandStagehand 是 Dart 官方出品的项目生成器scaffolding tool灵感来自 Yeoman 和 Web Starter Kit可以一键生成命令行应用、Web 应用、服务器应用等多种项目骨架。本文将以console-full 模板为主线手把手教新手如何用 Stagehand 从零创建一个可运行、可测试的Dart 命令行应用包括安装、生成、目录解读、运行与测试全流程。Stagehand 是什么Dart 项目生成器快速上手Stagehand 的核心价值只有一个帮你省掉新建项目时反复复制粘贴样板代码的时间。它会根据你选择的模板在当前目录中生成一整套结构完整的工程包括pubspec.yaml、代码入口、测试文件和规范配置。在 stagehand.dart 中内置了 7 种生成器生成器 ID适用场景console-full完整的命令行应用含测试与库代码console-simple极简命令行应用package-simple可发布的 Dart 包server-shelf基于 shelf 的服务器应用web-simple/web-angular/web-stagexl各类 Web 应用命令行应用开发请重点关注前两个 console 模板。生成逻辑在 console_full.dart 与 console_simple.dart 中定义每个生成器都对应一套模板文件源码可在 templates/console-full 目录中查看。安装 Stagehandpub global activate 一键安装步骤Stagehand 以 Dart 包的形式分发安装前请先确认本机已装好 Dart SDK建议 2.12 及以上。然后在终端执行pub global activate stagehand安装完成后即可全局使用stagehand命令。输入stagehand查看帮助与全部可用模板stagehand你会看到类似下面的输出其中就包括我们需要的 console 模板Available generators: console-full - A command-line application sample. console-simple - A simple command-line application. ... 提示新版 Dart SDK2.10 之后已内置功能相同的dart create命令如果你用的是新版本可以直接dart create -t console-full原理与 Stagehand 一致。生成第一个命令行应用stagehand console-full 完整命令Stagehand 会在当前所在目录生成项目且要求目录为空。因此推荐先建目录再生成mkdir my_console_app cd my_console_app stagehand console-full执行后你会看到类似输出Creating console-full application my_console_app: ...文件列表... 7 files written. -- run your app using dart bin/my_console_app.dart.生成逻辑请参考 cli_app.dart项目名取自目录名并自动规范化所以目录命名请使用小写字母加下划线例如my_console_app。文件写入由 cli_app.dart 中的_DirectoryGeneratorTarget完成。⚠️ 避坑提醒如果目录非空会提示The current directory is not empty请换一个空目录或使用--override强制生成。console-full 模板目录结构详解生成完成后项目结构如下my_console_app/ ├── bin/ # 程序入口main 函数所在 ├── lib/ # 可复用的库代码 ├── test/ # 单元测试 ├── analysis_options.yaml ├── CHANGELOG.md ├── README.md └── pubspec.yaml各部分作用对照模板源码一目了然入口文件bin/projectName.dart命令行应用的起点dart命令从这里启动程序库代码lib/projectName.dart放置业务逻辑供入口调用测试文件test/__projectName___test.dart自带一个计算 6×7 的示例断言依赖配置pubspec.yaml声明项目名、SDK 版本与依赖测试依赖test已默认配好代码规范analysis_options.yaml启用pedantic静态检查规则帮你写出规范代码。运行与测试你的 Dart 命令行应用模板自带一个calculate()函数返回 42先用它验证整条链路是否通畅。第一步拉取依赖dart pub get第二步运行命令行应用dart run bin/my_console_app.dart如果想测试直接调用库代码也可以dart run带lib/下的文件。第三步运行单元测试dart test测试通过时会看到类似输出00:00 1: All tests passed!现在把 lib/projectName.dart 里的calculate()改成你想要的逻辑在 bin/projectName.dart 中加上main()读取命令行参数、打印结果你的第一个可交互命令行应用就诞生了console-simple 与 console-full如何选择如果觉得 console-full 文件太多Stagehand 还提供极简的console-simple模板stagehand console-simple两个模板的区别对比对比项console-fullconsole-simple包含 lib/ 库代码✅❌包含 test/ 单元测试✅❌包含 analysis_options.yaml✅❌适合场景正式项目、需要测试快速验证、学习演示参考 console-simple/pubspec.yaml 可见它只保留最核心的依赖几乎零配置。新手建议直接上手console-full一步到位体验完整的工程化流程。常见问题与避坑指南1. 提示目录非空怎么办Stagehand 默认拒绝在非空目录生成换新目录即可若必须用当前目录加--override。2. 生成的项目名带大写或连字符项目名由目录名转换而来建议目录名使用小写字母 下划线例如my_tool避免包名不合法。3. 想修改作者信息生成时可用--author 你的名字指定文件头部作者否则会尝试从git config读取见 cli_app.dart。4. 想二次开发 Stagehand 本身直接 clone 本项目仓库地址https://gitcode.com/gh_mirrors/sta/stagehand后核心入口在 cli_app.dart模板文件在 templates 目录改完即可自定义属于自己的项目模板。总结用 Stagehand 创建命令行应用只需三步安装 → 建目录 → 生成。console-full 模板为你准备好了入口、库代码、测试和规范配置让你把精力全部放在业务逻辑上。无论你是想写个工具脚本还是学习 Dart 工程化Stagehand 都是绝佳的起点。现在就动手生成你的第一个命令行应用吧【免费下载链接】stagehandDart project generator - web apps, console apps, servers, and more.项目地址: https://gitcode.com/gh_mirrors/sta/stagehand创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考