发布至crates.io时Cargo.toml的篡改规则及执行位置问询

1. 篡改的具体规则与步骤 #

Cargo在发布 crate 时对Cargo.toml的修改是标准化处理，核心是移除本地专属配置、标准化发布所需的内容，具体规则包括：

• 移除本地开发相关字段：删掉仅用于本地构建/调试的配置段，比如[patch]、[replace]、[workspace]，以及[profile.dev]这类仅针对开发环境的编译配置。
• 标准化依赖声明：
  • 自动替换工作空间内的路径依赖（path = "..."）为对应的版本号；如果存在未替换的外部路径依赖，cargo publish会直接报错阻止发布。
  • 移除依赖中仅本地有效的属性（比如features之外的本地调试配置），保留符合crates.io规范的依赖声明。
• 清理与格式化：去除原文件中的所有注释，标准化Toml格式（统一缩进、字段排序），确保发布的清单格式一致。
• 固化版本信息：将[package]下的version字段固定为当前要发布的正式版本号（如果原版本是带后缀的开发版，会替换为提交的正式版本）。
• 处理发布权限字段：确保publish字段符合crates.io发布要求（如果原字段设为false，发布会直接失败；如果是指定仓库的数组，会保留）。

执行步骤大致是：

1. 检查当前 crate 配置合法性（比如路径依赖、版本号格式等）。
2. 将本地原Cargo.toml备份为Cargo.toml.orig。
3. 按照上述规则修改Cargo.toml。
4. 将修改后的Cargo.toml和其他必要文件打包成.crate归档。
5. 上传归档至crates.io；部分场景下，发布完成后Cargo会自动恢复原Cargo.toml（但如果发布过程中断，可能会保留修改后的文件，此时可以用.orig文件恢复）。

2. 篡改操作的执行位置 #

所有对Cargo.toml的修改都是本地执行的，由cargo publish命令在你的开发机器上完成。crates.io服务器仅负责接收和存储你上传的.crate归档，不会对归档内的内容做任何修改。你下载的示例 crate 中的修改后清单，就是本地打包时生成的版本。

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