删除.git目录后AWS Toolkit+SAM构建调试恢复正常，原因何在？

问题场景 #

使用AWS Toolkit插件配合Goland，通过AWS SAM调试Lambda功能原本正常，但只要项目根目录下存在.git目录（无论目录为空还是包含Git生成的文件），就会触发与版本控制系统（VCS）相关的构建错误。删除.git目录后，构建和调试功能恢复正常，但执行Goland的清除缓存操作无法解决问题。

可行解决方案 #

• 忽略Goland对.git目录的VCS识别
  打开Goland的Settings/Preferences → Version Control → Ignored Files，点击+号添加项目根目录下的.git目录到忽略列表。这样Goland不会将该目录识别为VCS仓库，避免干扰SAM的构建流程。

• 强制SAM跳过VCS检查
  在项目根目录的samconfig.toml文件中，添加或修改构建参数，让SAM在构建时忽略VCS状态检查：

  [default.build.parameters]
  skip_vcs_check = true
  

• 重置AWS Toolkit本地缓存
  关闭Goland后，找到AWS Toolkit的本地缓存目录（通常位于~/.aws-toolkit/或Goland插件缓存目录），删除与当前项目相关的缓存文件夹，再重新启动Goland加载项目。

• 指定SAM构建的隔离工作目录
  在Goland的AWS Toolkit调试配置中，进入Build选项，修改Working directory为项目下的一个子目录（确保该子目录内无.git目录），让SAM在隔离环境中执行构建操作。

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