# @bazel/hide-bazel-files 中文文档

规范地址：https://npmcn.com/package/%40bazel/hide-bazel-files/

版本：1\.7\.0
npm 元数据更新时间：2022-04-04T17:49:55.612Z
中文译文更新时间：2026-11-07T18:43:19.368Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bazel/hide-bazel-files
原文对照：https://npmcn.com/package/%40bazel/hide-bazel-files/?lang=original
项目主页：https://github.com/bazelbuild/rules_nodejs#readme
源码仓库：https://github.com/bazelbuild/rules_nodejs

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：16.2 kB，4 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2019-06-18T21:35:45.451Z
- 最新版本发布：2020-05-29T02:55:34.454Z
- 近 30 天下载量：15423（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：38（近 12 个月 0 个）

## 中文简介

一个工具, 将所有 Bazel 文件隐藏在节点 模块中, 用下划线前缀它们

## 安装

```sh
npm install @bazel/hide-bazel-files
```

也可以使用：`pnpm add @bazel/hide-bazel-files`、`yarn add @bazel/hide-bazel-files`、`bun add @bazel/hide-bazel-files`

## README

# @bazel/hide-bazel-文件

> 这包是Bazel 2.1之前一个问题的变通方案. 如果你在Bazel 2.1或以后, 你不应该需要这个,因为 `.bazelignore` 文件包含 `node_modules` 这样Bazel就不会试图从这个目录读取软件包.

一个工具来隐藏可能用一些 npm 包运出的 Bazel 文件 。 带有这些文件的软件包在使用时会导致构建失败 `npm_install` 或者说 `yarn_install` 当使用在 Bazel 2.0 或更早.

此工具将全部重命名 `BUILD` 财务报告和审定财务报表 `BUILD.bazel` 节点下的文件 `_BUILD` 财务报告和审定财务报表 `_BUILD.bazel` 页:1.

如果您看到错误, 如

```
ERROR: /private/var/tmp/_bazel_greg/37b273501bbecefcf5ce4f3afcd7c47a/external/npm/BUILD.bazel:9:1: Label '@npm//:node_modules/rxjs/src/AsyncSubject.ts' crosses boundary of subpackage '@npm//node_modules/rxjs/src' (perhaps you meant to put the colon here: '@npm//node_modules/rxjs/src:AsyncSubject.ts'?)
```

那么,在您的依赖中有一个 npm 软件包包含一个 `BUILD` 文档。 为了解决这个问题,添加 `@bazel/hide-bazel-files` 给您的 `devDependencies`编辑 `@bazel/hide-bazel-files` npm 软件包会自动运行一个后置步骤,将所有 Bazel 构建的文件重命名到您的节点 模块中 .

```
"devDependencies": {
  "@bazel/hide-bazel-files": "latest"
},
```

注:常用的 npm 包rxjs 包含 `BUILD` 从5.5.5版本到6.4.0包含的文件。 现已在6.5.0版中删除了这些内容. 如果您在此范围内使用 rxjs 版本, 这是您依赖中唯一包含 npm 软件包 `BUILD` 文件可以尝试升级到 rxjs 6.4.0 而不是使用 `hide-bazel-files`。 。 。 .

## 常见问题

### @bazel/hide-bazel-files 是什么？

一个工具, 将所有 Bazel 文件隐藏在节点 模块中, 用下划线前缀它们

### 如何安装 @bazel/hide-bazel-files？

在项目目录运行 npm install @bazel/hide-bazel-files，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 hide-bazel-files，可以用 npx hide-bazel-files 直接运行。

### @bazel/hide-bazel-files 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bazel\_\_hide-bazel-files 是否存在。

### @bazel/hide-bazel-files 可以商用吗？

@bazel/hide-bazel-files 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @bazel/hide-bazel-files 的下载量有多少？

根据 npm 官方下载统计，@bazel/hide-bazel-files 在 2026/10/08 – 2026/11/06 这 30 天内被下载 15,423 次，日均约 514 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bazel/hide-bazel-files 还在维护吗？

最新版本 1\.7\.0 发布于 2020/05/29（6 年前）；至今共发布 38 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/06/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。