如何在本地IDE中启用Google Apps Script（GAS）自动补全功能？

我之前用clasp开发GAS项目时也碰到过一模一样的问题——明明按文档装了所有组件，就是没有GAS服务的自动补全，折腾了好一阵才搞定。给你分享几个关键的排查和解决步骤：

1. 检查tsconfig.json配置是否正确 #

首先确认项目根目录下的tsconfig.json是否包含GAS类型定义的配置：

• 如果还没有这个文件，执行clasp pull或者手动创建，确保compilerOptions里的types数组包含@google/apps-script，参考配置如下：

  {
    "compilerOptions": {
      "target": "ES5",
      "module": "None",
      "strict": true,
      "esModuleInterop": true,
      "skipLibCheck": true,
      "forceConsistentCasingInFileNames": true,
      "types": ["@google/apps-script"]
    },
    "include": ["**/*.ts"],
    "exclude": ["node_modules"]
  }
  

• 如果已有配置，检查types字段是否存在且包含上述值，修改后保存文件。

2. 确保本地安装了GAS类型包 #

一定要在项目根目录执行以下命令，把类型包安装到本地依赖：

npm install @google/apps-script --save-dev

全局安装的类型包可能不会被VS Code识别，必须本地安装到当前项目的node_modules里。

3. 重启VS Code的TypeScript服务 #

有时候VS Code的TS服务会缓存旧配置，导致新的类型定义不生效：

• 按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板
• 输入并执行TypeScript: Restart TS Server
• 等待几秒后再尝试输入GAS服务相关代码（比如SpreadsheetApp.），看是否出现自动补全提示

4. 确认代码文件扩展名是.ts #

TypeScript的自动补全只对.ts后缀的文件生效，如果你之前用的是.gs或.js文件，需要改成.ts——不用担心，clasp在push时会自动转换成GAS支持的格式。

5. 检查VS Code的相关设置 #

• 打开VS Code设置（快捷键Ctrl+,或Cmd+,），搜索typescript.enablePromptUseWorkspaceTsdk，确保这个选项处于开启状态，这样VS Code会优先使用项目本地的TypeScript版本，避免全局版本不兼容的问题
• 同时确认editor.quickSuggestions选项是开启的，保证自动补全提示功能正常工作

如果以上步骤都试过还是不行，可以尝试删除项目根目录的node_modules文件夹和package-lock.json文件，然后重新执行npm install，再重启VS Code，基本就能解决问题了。

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