PyCharm AWS Toolkit插件无法创建Python AWS无服务器应用

1. 确认SAM CLI与AWS Toolkit的关联配置 #

• 打开PyCharm设置（Windows/Linux：File > Settings；Mac：PyCharm > Settings），找到Tools > AWS Toolkit > AWS SAM。
• 检查SAM CLI的路径是否正确配置，点击Test按钮验证连接有效性。若路径为空，手动选择SAM CLI安装路径：Mac/Linux一般为/usr/local/bin/sam，Windows一般为C:\Program Files\Amazon\AWSSAMCLI\bin\sam.exe。

2. 正确导入sam init创建的项目 #

• 用sam init生成Python项目后，不要直接打开单个文件，而是在PyCharm中选择File > Open，选中包含template.yaml、samconfig.toml的项目根目录。
• 等待PyCharm完成索引，AWS Toolkit会自动识别项目中的SAM模板，左侧AWS Explorer侧边栏将显示该无服务器应用。

3. 自动识别失败时手动关联SAM模板 #

• 打开项目中的template.yaml文件，右键点击编辑器空白处，选择AWS > Associate with SAM Application。
• 在弹出窗口中确认项目根目录，完成关联后，Toolkit会识别该模板，AWS Explorer中即可查看函数列表。

4. 本地启动/调试Python函数 #

• 在AWS Explorer中找到目标Python函数，右键选择Run Local或Debug Local。
• 首次运行时，Toolkit会自动生成运行配置：确认Python解释器为项目使用的虚拟环境（sam init创建的虚拟环境路径一般为.venv/bin/python），配置触发事件（如API Gateway请求JSON）。
• 点击运行按钮即可本地启动函数，调试时直接设置断点，日志将在控制台输出。

常见排查点 #

• 检查template.yaml中Python函数的Runtime配置，需与本地安装的Python版本匹配（如Runtime: python3.11）。
• 确保项目根目录存在samconfig.toml文件，该文件是SAM CLI的配置文件，缺失可能导致Toolkit无法识别项目。
• 重启PyCharm，插件加载延迟可能导致模板不显示，重启后通常可解决。

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