为什么可以将带连字符的 crate 名称更改为带下划线的名称，在这种模棱两可的情况下命名规则是什么？

Question

我创建了一个新的 Cargo 项目：cargo new --lib hyphen-crate。

src/lib.rs

pub fn add(a: u32, b: u32) -> u32 {
    a + b
}

tests/addition.rs

use hyphen_crate::add;

#[test]
fn addition_test() {
    assert_eq!(5, add(2, 3));
}

Cargo.toml

[package]
name = "hyphen-crate"
version = "0.1.0"
authors = ["xolve"]
edition = "2018"

[dependencies]

我已经搜索并看到了许多讨论是否应允许在 crate 或包的名称中使用连字符，但没有链接提及解决方案。

我看到的是 crate 名称 hyphen-crate 自动转换为 hyphen_crate 并成功编译和测试。

Answer 1

包名称中允许使用连字符，但它们在内部被转换为下划线，因为连字符不是Rust identifiers 中的有效字符。

似乎这种自动转换并非总是如此，带有连字符的 crate 必须手动重命名才能导入它们；例如。 extern crate "hyphen-crate" as hyphen_crate;。有关详细信息，请参阅Hyphens Considered Harmful RFC。