# @google-cloud/nodejs-repo-tools 中文文档

规范地址：https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/

版本：3\.3\.0
npm 元数据更新时间：2022-06-12T19:14:32.068Z
中文译文更新时间：2026-11-16T20:28:40.421Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40google-cloud/nodejs-repo-tools
原文对照：https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/?lang=original
项目主页：https://github.com/GoogleCloudPlatform/nodejs-repo-tools#readme
源码仓库：https://github.com/GoogleCloudPlatform/nodejs-repo-tools

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

- 包体积（解压后）：294 kB，74 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=8\.0\.0
- 运行依赖：14 个
- 首次发布：2017-04-14T22:37:17.314Z
- 最新版本发布：2019-05-14T00:20:06.357Z
- 近 30 天下载量：13184（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：94（近 12 个月 0 个）

## 中文简介

在GoogleCloudPlaftorm组织中用于维护和测试Node.js寄存器的工具.

## 安装

```sh
npm install @google-cloud/nodejs-repo-tools
```

也可以使用：`pnpm add @google-cloud/nodejs-repo-tools`、`yarn add @google-cloud/nodejs-repo-tools`、`bun add @google-cloud/nodejs-repo-tools`

## README

# 节点- repo 工具 [![build status](https://img.shields.io/travis/GoogleCloudPlatform/nodejs-repo-tools.svg)](https://travis-ci.org/GoogleCloudPlatform/nodejs-repo-tools) [![coverage](https://img.shields.io/codecov/c/github/GoogleCloudPlatform/nodejs-repo-tools/master.svg)](https://codecov.io/gh/GoogleCloudPlatform/nodejs-repo-tools) [![Greenkeeper badge](https://badges.greenkeeper.io/GoogleCloudPlatform/nodejs-repo-tools.svg)](https://greenkeeper.io/)

在 Google CloudPlatform 中用于维护和测试寄存器的工具 组织.

**目录**

-   [安装](https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/#readme-installation)
-   [CLI 使用情况](https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/#readme-cli-usage)
-   [程序用途](https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/#readme-programmatic-usage)
-   [语文支助](https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/#readme-language-support)
    -   [可用的构建包](https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/#readme-available-build-packs)
    -   [添加一个构建包](https://npmcn.com/package/%40google-cloud/nodejs-repo-tools/#readme-adding-a-build-pack)

## 安装

通过 `npm`数字 :

1.  `npm install -g @google-cloud/nodejs-repo-tools`
2.  `repo-tools --help`

Via 下载 (Linux) :

1.  `curl -O https://storage.googleapis.com/cloud-docs-samples/releases/latest/nodejs-repo-tools-linux`
2.  `mv ./nodejs-repo-tools-linux $HOME/bin/repo-tools`
3.  `chmod +x $HOME/bin/repo-tools`

Via 下载 (Mac) :

1.  `curl -O https://storage.googleapis.com/cloud-docs-samples/releases/latest/nodejs-repo-tools-macos`
2.  `mv ./nodejs-repo-tools-macos $HOME/bin/repo-tools`
3.  `chmod +x $HOME/bin/repo-tools`

Via下载( Windows) :

[下载链接](https://storage.googleapis.com/cloud-docs-samples/releases/latest/nodejs-repo-tools-win.exe)

## CLI 使用情况

用法 : `repo-tools --help` 或者说 `tools --help`

```
Commands:
  exec                  Run a given command in /Users/jdobry/projects/nodejs-repo-tools.
  generate <targets..>  Generate the given target(s) in /Users/jdobry/projects/nodejs-repo-tools.
  test                  Run a test sub-command.
  unify                 (Node.js only) Recursively add sub-directory dependencies to the top-level package.json file.

Options:
  --build-pack, -b  Choices: nodejs, python, ruby. Detected: nodejs. The build pack to use. The tool will attempt to
                    detect which build to use.                                                                  [string]
  --local-path, -l  Current: /Users/jdobry/projects/nodejs-repo-tools. Use this option to set the current working
                    directory of the command.                                                                   [string]
  --dry-run         Default: false. Print the actions that would be taken, but don't actually do anything.     [boolean]
  --silent          Default: false. If true, hide the output of shell commands.                                [boolean]
  --help            Show help                                                                                  [boolean]
  --version         Show version number                                                                        [boolean]

For more information, see https://github.com/GoogleCloudPlatform/nodejs-repo-tools
```

## 程序用途

1.  安装工具 :
    
    ```
    npm install --save @google-cloud/nodejs-repo-tools
    ```
    
2.  然后在你的代码:
    
    ```
    const tools = require('@google-cloud/nodejs-repo-tools');`
    ```
    

## 语文支助

对各种编程语言的支持通过\[building backs\]\[\]来添加. 一个建筑 包指定特定语言配置和命令,当 执行各种Repo工具任务。 Repo 工具尽力推断 构建包,它应该使用,但当运行命令可以指定一个特定 以 `--build-pack [BUILD_PACK]` 或者说 `-b [BUILD_PACK]`。 。 。 .

### 可用的构建包

-   [全球](https://github.com/GoogleCloudPlatform/nodejs-repo-tools/blob/master/src/build_packs/build_pack.js) - 默认,所有构建包的全球配置.
-   [节点](https://github.com/GoogleCloudPlatform/nodejs-repo-tools/blob/master/src/build_packs/nodejs.js) - 为Node.js编程语言建立包.
-   [蟒蛇](https://github.com/GoogleCloudPlatform/nodejs-repo-tools/blob/master/src/build_packs/python.js) - 为Python编程语言构建包.
-   [红宝石](https://github.com/GoogleCloudPlatform/nodejs-repo-tools/blob/master/src/build_packs/ruby.js) - 为Ruby编程语言构建包.

### 添加一个构建包

可以通过添加一个 `.js` 转到 [src/ 构建 包装](https://github.com/GoogleCloudPlatform/nodejs-repo-tools/tree/master/src/build_packs) 目录。 此文件应该导出 JavaScript 对象 。 你可以看到 通过浏览已有的构建包来查看可用的选项.

## 捐款

见 [捐款额](https://github.com/GoogleCloudPlatform/nodejs-repo-tools/blob/master/.github/CONTRIBUTING.md)。 。 。 .

## 许可证

Apache 版本 2.0

见 [自由主义](https://github.com/GoogleCloudPlatform/nodejs-repo-tools/blob/master/LICENSE)。 。 。 .

## 常见问题

### @google-cloud/nodejs-repo-tools 是什么？

在GoogleCloudPlaftorm组织中用于维护和测试Node\.js寄存器的工具\.

### 如何安装 @google-cloud/nodejs-repo-tools？

在项目目录运行 npm install @google-cloud/nodejs-repo-tools，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 tools、repo-tools，可以用 npx tools 直接运行。

### @google-cloud/nodejs-repo-tools 支持 TypeScript 吗？

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

### @google-cloud/nodejs-repo-tools 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @google-cloud/nodejs-repo-tools 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=8\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @google-cloud/nodejs-repo-tools 可以商用吗？

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

### @google-cloud/nodejs-repo-tools 的下载量有多少？

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

### @google-cloud/nodejs-repo-tools 还在维护吗？

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

