如何仅将Rust工作区中的二进制Crate发布至crates.io

第一个错误的原因 #

你在工作区根目录的Cargo.toml里添加[[bin]]配置是错误的——工作区根的配置文件仅用于管理工作区成员，本身不是一个Crate，不能直接声明二进制编译目标。这个配置完全没必要加，正常情况下，二进制Crate只要是src/main.rs的标准结构，Cargo会自动识别。

第二个错误的核心解决方法 #

当你执行cargo publish -p <二进制Crate名>时，Cargo会默认检查所有依赖是否能从crates.io获取，但你的二进制Crate依赖的abstract_frontend是本地工作区库，没发布到crates.io，所以触发报错。要解决这个问题，需要做两个关键配置：

1. 给所有内部库添加禁止发布标记 #

在每个不想对外发布的内部库的Cargo.toml中，添加如下配置：

[package]
# 保留原有的name、version等配置
publish = false

这个标记会告诉Cargo：该库仅用于内部，永远不要发布到crates.io，发布二进制Crate时也不会尝试从registry拉取它。

2. 明确工作区依赖关系 #

确保二进制Crate的Cargo.toml中，对内部库的依赖声明为工作区成员依赖，而非普通路径依赖（路径依赖在发布流程中会被Cargo忽略，转而尝试从crates.io查找）：

[dependencies]
abstract_frontend = { workspace = true }

同时，工作区根目录的Cargo.toml要包含所有成员Crate：

[workspace]
members = [
    "my_project_binary_name",
    "abstract_frontend",
    # 其他内部库名称...
]

3. 正确的发布测试命令 #

直接在工作区根目录执行：

cargo publish -p my_project_binary_name --dry-run

（除非你确实需要发布未提交的修改，否则不要加--allow-dirty参数）

额外提醒 #

• 只有当二进制Crate包含多个可执行文件时，才需要在自己的Cargo.toml里添加[[bin]]配置，单个src/main.rs的场景完全不需要手动声明。
• 发布前务必用--dry-run完整测试，确认所有内部依赖都被正确识别为工作区成员，没有触发从crates.io拉取的逻辑。

内容的提问来源于stack exchange，提问作者Quessours