建立 2026-09-15 更新 2026-09-15

clasp 本機開發

clasp 是 Google 官方的 Apps Script CLI。把雲端專案拉到本機，就能用 VS Code、Git、自己習慣的格式化工具。瀏覽器編輯器適合試作；專案一變大或要多人改，就該上 clasp。

安裝與登入

需要 Node.js，然後：

npm install -g @google/clasp
clasp login

瀏覽器登入 Google 後，本機會存 token。公司帳號若停用不夠安全的應用，要請管理員允許 clasp，或改用 Cloud 專案的 OAuth 用戶端。

常用指令

clasp clone 指令碼ID          # 把既有專案拉下來
clasp create --type sheets   # 新建並可指定類型
clasp pull                   # 雲端 → 本機
clasp push                   # 本機 → 雲端
clasp open                   # 打開瀏覽器編輯器
clasp logs                   # 看 Stackdriver／執行紀錄（需設定）

專案根目錄會有 .clasp.json（記錄 scriptId）與 appsscript.json。不要把 .clasp.json 裡的 ID 當成密鑰，但也不要提交含 token 的本機認證檔。 .gitignore 應忽略 ~/.clasprc.json 這類憑證。

本機檔名可用 utils.js；push 上去仍是 Apps Script 專案裡的 .gs。V8 支援現代 JS 語法，但沒有 Node 的 require／npm，除非你自己做打包流程。多數教學建議保持簡單，一個檔案一個職責即可。