#每天一个知识点#
samples与examples有什么区别

没有强制国标,是开源圈约定俗成(Goose / Rust / C++ 仓库通用)

examples

API最小用法、基础入门、单特性演示

- 偏向Hello World、单一接口、最简正确写法
- 代码短、注释少、直白,目标:看懂这个API怎么调用
- 适合新手入门、快速验证语法
- 例: examples/hello.goose 、单个函数调用demo

samples

贴近真实业务、场景化、多API组合的完整小工程

- 把多个特性组合起来,模拟实际开发场景
- 结构完整,带构建脚本、README,可直接fork改一改上线
- 用来参考工程结构、最佳实践、落地思路
- 例:bench程序、小型工具、多模块组合案例

一句话总结

 examples  = 单特性最简演示; samples  = 贴近生产的场景样例工程。

补充(很多仓库混用)

不少小项目直接随便起名,只看名字不一定准;ROS、.NET、Rust官方仓库是严格区分这套规范的 。

例如,给你Goose仓库的目录建议

-  /examples :hello、基础ADT、简单循环、单API调用
-  /samples :bench套件、数据处理小工具、完整可落地小程序

展开
1