vscode中aws toolkit插件安装失败需先检查三件事：是否为用户安装版vscode、版本是否≥1.75、代理设置是否清空；lambda不显示需核对凭据profile与region；s3加载异常需确认region、endpoint及权限配置。
VSCode里AWS Toolkit插件装不上？先查这三件事
装不上不是网络问题就是权限或版本冲突。AWS Toolkit（Amazon Web Services Toolkit）依赖 VSCode 的扩展主机机制，很多失败其实卡在底层环境上。
- 确认 VSCode 是用户安装版（非系统级 MSI 安装），否则 Windows 上可能因权限被拦截 —— 重装时勾选
Add to PATH和Install for all users反而容易出问题 - 检查 VSCode 版本：Toolkit 要求
1.75+，低于这个版本会静默失败，连错误提示都不弹；Mac 用户尤其注意从官网下载最新.zip或.dmg，别用 Homebrew 装的旧版 - 关掉所有代理设置：
Settings > Proxy里清空http.proxy，哪怕你没手动配过 —— 某些企业网络会通过系统策略注入代理，VSCode 会继承并导致插件市场请求 403
配置 AWS 凭据后Lambda函数不显示？重点看 profile 和 region
Lambda 列表为空，90% 是因为 Toolkit 没读到有效的凭据上下文，或者 region 不匹配目标函数所在区域。
- 凭据必须放在
~/.aws/credentials（Linux/macOS）或%USERPROFILE%\.aws\credentials（Windows），且 profile 名要和 VSCode 设置里aws.profile值一致；默认是default，但如果你用了[dev]，就得在 VSCode Settings 搜索aws.profile改成dev - Toolkit 默认只拉取当前设置的
aws.region下的资源，哪怕你有跨 region 权限，也得手动切换：右下角状态栏点 AWS 图标 →Change Region→ 选对 region（比如us-east-1） - 确保 IAM 用户或角色有
lambda:ListFunctions权限；仅靠AdministratorAccess不一定生效 —— 某些组织禁用了通配符策略，需显式授权
本地调试 Lambda 时提示“Cannot find module 'index'”？路径和入口配置对不上
这是 Node.js 运行时找不到 handler 文件的典型报错，和 Toolkit 本身无关，但调试启动逻辑会掩盖真实路径问题。
- 检查
template.yaml或serverless.yml中的CodeUri（SAM）或package.artifact（Serverless Framework）是否指向正确目录，且该目录下真有index.js（或你声明的 handler 文件） - VSCode 启动调试前，会自动运行
sam build；如果项目根目录没有samconfig.toml，它可能在错误路径下执行构建，导致输出目录错乱 —— 建议手动跑一次sam build --debug看输出路径 - handler 字符串格式必须严格匹配：比如
index.handler表示index.js导出的handler函数，不能写成./index.handler或index.js.handler
S3 资源列表加载慢或报错“Access Denied”？不是权限问题就是 endpoint 配置漏了
S3 在 Toolkit 里不像 Lambda 那样走标准 API，它依赖 region-specific endpoint，而且某些自定义 endpoint（如 MinIO、Ceph）需要额外声明。
- 确认
aws.region设置和 S3 bucket 所在 region 一致；跨 region 访问 S3 不报错但极慢，因为 Toolkit 会尝试连接默认 endpoint 并超时后 fallback - 私有 S3 兼容服务必须在
~/.aws/config里加s3 = { endpoint_url = "https://your-minio.example.com" }，否则 Toolkit 仍发请求到s3.us-east-1.amazonaws.com - 如果 bucket 启用了
blockPublicPolicy或ignorePublicAcls，IAM 策略里光给s3:GetBucketLocation不够，还得加s3:ListAllMyBuckets和s3:ListBucket，否则列表直接空白
Toolkit 对 S3 的操作本质是调用 AWS SDK v3 的 ListBucketsCommand 和 ListObjectsV2Command，所有行为都受底层 SDK 的 region、endpoint、credentials 链路控制 —— 没有独立的“S3 模式”，这点很容易被忽略。
