# 文档注释常用章节 - `# Examples` - Panics:函数可能发生panic的场景 - Errors:如果函数返回Result,描述可能的错误种类 - Safety:如果函数处于unsafe调用,就应该解释函数unsafe的原因以及调用者确保的使用前提 # 发布crate 为crate添加元数据,需要在`cargo.toml`的package区域添加信息 - crate唯一名称:name - description:一两句话即可 - license:提供许可证标识值,可到http://spdx.org/licenses查找 > 可指定多个,用OR隔开 - version - author - 使用`cargo publish`命令