VSCode使用CLASP本地开发GAS执行clasp push命令报错排查

本地VSCode完成Google Apps Script项目开发后，在PowerShell的D:\evcPRD路径下执行clasp push推送代码变更时抛出错误：

No valid D:\evcPRD.clasp.json project file. You may need to create or clone a project first.
报错原因是clasp在当前执行路径下未找到有效的.clasp.json项目配置文件，无法关联远端GAS项目完成推送。

按优先级依次尝试以下操作：

• 先确认命令执行路径是否正确
  执行clasp clone时会自动在当前目录生成项目专属的子文件夹，.clasp.json默认存放在该子文件夹内，而非外层目录。先在当前路径执行dir -Force查看所有文件（含隐藏文件），如果.clasp.json存在于下级子目录中，通过cd 子目录路径切换到存放配置文件的项目真实根目录，再执行clasp push即可。
• 手动补全丢失的配置文件
  如果确认.clasp.json文件丢失，不要直接重新clone覆盖本地已开发完成的代码。在当前开发目录下手动新建名为.clasp.json的文件，写入以下配置内容：

  {
    "scriptId": "对应GAS项目的脚本ID",
    "rootDir": "."
  }
  

  其中scriptId可从对应GAS项目的编辑器地址、项目设置页中直接获取，rootDir填.代表当前目录为项目代码根目录即可。
• 验证配置有效性
  配置文件创建完成后，先执行clasp status检查配置是否生效，命令正常返回本地待变更文件列表时，再执行clasp push即可完成代码推送。

• .clasp.json为点开头的隐藏文件，Windows资源管理器、普通dir命令默认不显示，排查文件位置时必须加-Force参数才能看到。
• clasp仅会从当前执行命令的目录开始向上查找配置文件，所有clasp相关命令必须在存放.clasp.json的项目根目录下执行。
• 手动迁移本地代码文件时，必须连同.clasp.json一起移动到目标目录，否则会出现配置找不到的报错。

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