VSCode中AWS Toolkit问题多因凭据加载失败或region不匹配：需确保VSCode≥1.75、正确安装方式、清除代理设置；~/.aws/credentials profile名与VSCode中aws.profile设置严格一致；右下角AWS区域须手动切换至函数所在region；部署时区分右键template.yaml与函数节点；Log Group名必须与函数名完全一致。
VSCode 里 AWS Toolkit 插件装不上、Lambda 不显示、Deploy Function 失败——这些问题基本都卡在凭据加载失败或 region 不匹配上，而不是插件本身坏了。
插件安装失败：先查 VSCode 版本、安装方式和代理
Toolkit 要求 VSCode ≥1.75，低于这个版本会静默失败，连错误提示都不弹。Windows 上必须是用户安装版（非 MSI 系统级安装），否则扩展主机常因权限被拦截；Mac 用户别用 Homebrew 装旧版，得从官网下 .dmg 或 .zip。
- 打开 VSCode，按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Help: About查版本 - 设置 → 搜索
http.proxy，清空该字段——哪怕你没手动配过，企业策略可能已注入代理，导致插件市场返回403 - 重装插件前，先退出 VSCode，删掉
~/.vscode/extensions/amazonwebservices.aws-toolkit-vscode-*目录再试
Lambda 函数列表为空：凭据 profile 和 region 必须严格对齐
Toolkit 不存密钥，只读 ~/.aws/credentials 或复用 CLI 凭据链。点了 AWS: Login 却看不到函数？大概率是 profile 名不一致或 region 没切对。
- 确认
~/.aws/credentials存在且格式正确，例如有[dev]段落，并含aws_access_key_id和aws_secret_access_key - VSCode 设置中搜索
aws.profile，值必须和 credentials 文件里的 profile 名**完全一致**（区分大小写） - 右下角状态栏点 AWS 图标 →
Change Region→ 选函数实际所在的 region（如us-west-2），不是你默认配置的 region - 终端运行
aws sts get-caller-identity，能返回 ARN 才说明 CLI 凭据可用；Toolkit 默认走这条链路
Deploy Function 报错或无更新：别右键错节点，检查 handler 路径和权限
右键 template.yaml → Deploy 是整个 SAM 应用部署；右键函数名节点 → Deploy Function 才是单函数更新。混淆这两者，90% 会部署失败或函数没变。
- 报错含
lambda:UpdateFunctionCode或lambda:CreateFunction？检查 IAM 权限是否显式授权（AdministratorAccess在某些组织策略下会被禁用） - handler 字符串（如
src/handler.hello）必须和实际文件路径、导出名完全一致；多一个.（如./src/handler.js）会导致容器内MODULE_NOT_FOUND - 本地调试前确保已运行
sam build，并核对输出目录是否为.aws-sam/build/；若项目无samconfig.toml，构建可能发生在错误路径
CloudWatch 日志打不开：Log Group 名和函数名必须一字不差
双击 “View CloudWatch Logs” 提示 No log group found，不是权限问题，而是 Log Group 名称和函数名不严格对应——AWS 自动创建的 Log Group 名是 /aws/lambda/<function-name>，中间不能有空格、下划线以外的特殊字符，也不能大小写混用。
- 在 AWS 控制台 Lambda 页面查看函数配置页的 “Function name” 字段，复制纯文本（不含引号）
- 进 CloudWatch Logs 控制台，手动搜索
/aws/lambda/+ 该名称，确认是否存在；若不存在，说明函数从未成功执行过（冷启动失败、handler 报错退出等） - 函数首次成功运行后，Log Group 才会被自动创建；此前日志操作必然失败
最常被忽略的是：Toolkit 从不“记住”你上次登录的 profile 或 region，每次重启 VSCode 后，右下角状态栏的 AWS 区域和 profile 都可能回退到默认值，得手动再切一次——这不是 bug，是设计行为。
