Bazel规则http_file与http_archive的差异及适用场景咨询

简单说：二者定位不同，不能完全互换，更多是针对不同场景形成互补关系，类似你提到的local_repository系列规则的分工逻辑。

核心区别 #

• http_file：专注下载单个文件，不会做解压操作，下载后直接作为Bazel的文件目标存在。适合获取单个二进制、配置文件或独立源码文件。
  举个例子：

  http_file(
      name = "jq_binary",
      urls = ["https://github.com/stedolan/jq/releases/download/jq-1.6/jq-linux64"],
      executable = True,
      sha256 = "af986793a515d500ab2d35f8d2aecd656e764504b789b66d7e1a0b727a124c44",
  )
  

  使用时直接通过@jq_binary//file引用这个可执行文件。

• http_archive：下载压缩包（zip、tar.gz等格式）并自动解压，将解压后的目录作为一个完整的外部仓库导入。适合引入整个第三方库、项目源码或包含多文件的资源包。
  示例：

  http_archive(
      name = "com_google_googletest",
      urls = ["https://github.com/google/googletest/archive/refs/tags/v1.14.0.tar.gz"],
      sha256 = "8ad598c73ad796e0d8280b082cebd82a630d73e73cd3c70057938a6501bba5d7",
      strip_prefix = "googletest-1.14.0",
  )
  

  之后可以直接引用仓库内的目标，比如@com_google_googletest//:gtest。

关于互换性 #

只有极个别场景能勉强替代，大部分情况下做不到完全互换：

• 如果需要的是单个文件，用http_file更高效；硬要用http_archive的话，得先把单个文件打包成压缩包，完全没必要。
• 如果要引入整个多文件仓库，http_archive是唯一可行的方式——http_file无法解压压缩包，也不能创建仓库结构，根本满足不了需求。

互补关系 #

二者的分工逻辑和native.local_repository/native.new_local_repository类似，是互补而非替代：

• 处理单个独立资源文件 → 用http_file
• 处理多文件组成的压缩包/仓库 → 用http_archive
  实际项目里经常会同时用到两者，比如用http_archive引入依赖库，用http_file下载某个单独的工具二进制或者配置文件。

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