Mason怎么用？从安装到生成的实测路径
Mason怎么用？最短路径只有四段：安装CLI、初始化项目、添加brick、执行make。实测中真正容易卡住的不是命令，而是brick目录、变量命名和生成位置。本文按一个“创建用户资料模块”的可复现操作展开，每一步都说明应该看到什么结果。
先说结论：跑通最小闭环再扩展
不要上来就做完整架构模板。实测最稳的方式，是先生成一个目录和两个文件，确认CLI、变量及输出路径都正常，再加入测试、状态管理和钩子。
下面以Dart或Flutter项目为例，目标是输入 `profile`，生成资料模块目录、页面文件和测试文件。命令应在版本库内执行，出错后可直接查看差异或回退。
安装与初始化
本机已有Dart SDK时，运行 `dart pub global activate mason_cli`。随后用 `mason --version` 检查命令是否可用；若终端找不到命令，优先检查Dart全局可执行目录是否加入PATH。
进入项目根目录运行 `mason init`。初始化后会出现Mason配置文件。团队项目应把配置纳入Git，而不是让每个人各自维护一套模板来源。
创建、添加并调用brick
创建brick后，在 `brick.yaml` 定义 `feature_name` 变量，在 `__brick__` 中放模板文件。例如文件名和类名都可引用 `{{feature_name}}`，需要类名格式时再使用对应转换。
通过 `mason add` 把brick登记到项目，然后运行 `mason make` 调用。执行时按提示输入 `profile`，生成后立刻检查目录、文件名、import和测试引用，别只看终端显示成功。
用得顺的三个细节
生成位置要显式确认，避免在错误目录制造一套嵌套文件；变量名称保持语义清楚，别用 `name1`；模板中少写绝对路径和项目专属依赖，否则换仓库就失效。
Mason怎么用得长久，关键是把brick当源码维护：修改要评审，生成结果要过格式化和静态分析，结构变更要同步模板。命令很短，治理才是长期成本。
常见问题
- Mason安装后提示command not found怎么办？
- 先运行 `dart pub global list` 确认已安装，再检查Dart全局可执行目录是否进入PATH。修改环境变量后应重开终端。
- Mason make生成到哪里？
- 取决于执行目录、brick内的目录结构及使用的输出参数。首次运行前先确认当前路径，并用Git状态检查新增文件。
- Mason变量怎么转换成类名？
- 可在Mustache模板中使用Mason支持的大小写转换，将输入的下划线或普通名称转成PascalCase等格式。变量转换应集中测试，避免文件名和类名规则不一致。
- brick应该放项目内还是单独仓库？
- 只服务一个项目时放项目内最易同步；多个仓库共用时可独立管理并固定版本，避免模板更新后旧项目被动变化。