如何通过cargo批量更新工作区Cargo.toml依赖的branch配置

别费劲找原生cargo对应的批量修改子命令了，目前官方没有内置这个功能，下面几个方法都能实现无手动逐个编辑的批量修改，我自己平时维护多crate工作区的时候经常用：

• 方案1：全局文本替换（效率最高，适合统一替换场景）
  Cargo.toml本身是纯文本格式，直接用系统自带的文本处理命令遍历工作区下所有Cargo.toml做目标字符串替换即可，替换完成后执行cargo update同步Cargo.lock，再跑一遍cargo check确认配置正确就生效了。
  不同环境的替换命令如下：
  • Linux（支持递归通配符的shell环境）：

    sed -i 's/branch = "v1.0.1"/branch = "v1.0.2"/g' **/Cargo.toml
    

  • macOS（BSD版sed需要指定备份参数，传空字符串代表不生成备份文件）：

    sed -i '' 's/branch = "v1.0.1"/branch = "v1.0.2"/g' **/Cargo.toml
    

  • 如果shell不支持**递归通配符，Linux/macOS都可以用find命令遍历：

    # Linux
    find . -name "Cargo.toml" -exec sed -i 's/branch = "v1.0.1"/branch = "v1.0.2"/g' {} \;
    # macOS
    find . -name "Cargo.toml" -exec sed -i '' 's/branch = "v1.0.1"/branch = "v1.0.2"/g' {} \;
    

  • Windows PowerShell：

    Get-ChildItem -Recurse -Filter Cargo.toml | ForEach-Object { (Get-Content $_ -Raw) -replace 'branch = "v1.0.1"', 'branch = "v1.0.2"' | Set-Content $_ }
    

  注意：如果你本地Cargo.toml里的branch配置存在空格、引号格式不一致的情况，对应调整匹配的字符串规则即可。

• 方案2：工作区依赖继承（一劳永逸，避免后续重复批量修改）
  如果你的项目是标准Cargo工作区结构，可以把所有跨crate复用的公共依赖，统一抽到根目录Cargo.toml的[workspace.dependencies]块下配置，工作区内的成员crate直接继承依赖配置即可。后续要调整分支版本的时候，只需要修改根目录这一处的branch值，所有成员会自动同步配置，完全不需要遍历修改多个文件。
  配置示例：

  # 根目录Cargo.toml
  [workspace.dependencies]
  common-crate = { git = "https://your-git-repo-address.git", branch = "v1.0.2" }
  

  成员crate内引用依赖时不需要重复写branch等公共配置：

  # 任意成员crate的Cargo.toml
  [dependencies]
  common-crate = { workspace = true }
  

• 方案3：第三方cargo扩展（适合复杂规则修改场景）
  如果你需要做更精细化的修改，比如只调整特定git源下依赖的分支、排除部分crate不参与替换，可以安装cargo-edit扩展，配合简单的shell脚本做定向修改，比纯文本替换的容错性更高，安装命令为cargo install cargo-edit。

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