将命令行界面与 clasp 搭配使用

如需从终端（而不是 Apps 脚本编辑器）开发和管理 Google Apps 脚本项目，请使用开源工具 clasp。

clasp Codelab 简要介绍了所有 clasp 功能。

功能

clasp 包含以下功能：

在本地开发

clasp 可让您在本地开发 Apps 脚本项目。在自己的计算机上编写代码，并在完成后将其上传到 Apps 脚本。您还可以下载现有的 Apps 脚本项目以离线修改。在构建 Apps 脚本 项目时，可以使用自己喜欢的开发工具（如 git）。

管理部署版本

创建、更新和查看项目的多个部署 。

构建代码

clasp 可让您将代码整理到目录中，这些目录在您将其上传到 script.google.com 时会保留。例如：

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

项目类型

您可以使用 clasp 管理独立脚本项目和容器绑定脚本项目。

独立项目

独立项目在 Google 云端硬盘中显示为单独的文件。您可以使用 clasp create 命令创建新的独立脚本。

容器绑定项目

容器绑定项目会附加到 Google 文档、表格、幻灯片或 Google 表单 文件。您可以使用 clasp create 命令创建附加到新文件的容器绑定脚本。您还可以使用 --parentId 标志将新脚本附加到现有文件。

其他项目类型

clasp 还支持为 Web 应用和 API 创建脚本。

要求

clasp 是使用 Node.js 编写的，并使用 npm 工具进行分发。在使用 clasp 之前，您必须安装 Node.js 20.0.0 版或更高版本。安装 Node.js 需要管理员权限。

安装

安装 Node.js 后，请使用以下 npm 命令安装 clasp：

npm install @google/clasp -g

安装后，您可以在计算机上的任何目录中使用 clasp 命令。

使用 clasp

使用 clasp 从命令行处理各种任务。本部分介绍了使用 clasp 进行开发时要使用的常见操作。

登录

此命令会登录并授权管理 Google 账号的 Apps 脚本项目。运行后，系统会要求您登录存储 Apps 脚本项目的 Google 账号。

clasp login

退出

此命令会退出命令行工具。使用 clasp login 重新登录以 向 Google 重新进行身份验证，然后继续使用 clasp。

clasp logout

新建 Apps 脚本项目

此命令会在当前目录中创建一个新脚本，并提供可选的脚本标题。

clasp create [scriptTitle] [--type <projectType>] [--parentId <parentId>]

此命令使用以下可选参数：

  • scriptTitle：脚本项目的标题。
  • --type <projectType>：要创建的项目类型。允许的值包括 standalone、docs、sheets、slides、forms、webapp 和 api。
  • --parentId <parentId>：现有 Google 云端硬盘文件 （文档、表格、幻灯片或 表单）的 ID，新脚本项目应绑定到该文件。

此命令还会在当前目录中创建两个文件：

  • 一个用于存储脚本 ID 的 .clasp.json 文件。
  • 一个包含项目元数据的 appsscript.json 项目清单文件。

克隆现有项目

此命令会在当前目录中克隆现有项目。脚本 必须使用您的 Google 账号创建或与您的 Google 账号共享。您可以通过提供脚本 ID 来指定要克隆的脚本 项目。您可以克隆独立项目和 容器绑定项目。

如需查找项目的脚本 ID，请执行以下操作：

  1. 打开 Apps 脚本项目。
  2. 点击左侧的项目设置 。

  3. 在 ID 下，复制脚本 ID 。

    clasp clone