Windows 使用 AWS CLI 一键同步本地目录到 S3（保留目录结构、可断点续传）#

本文介绍如何在 Windows 上使用 AWS CLI，将本地目录 G:\awss3\profile 整体同步到 S3 存储桶 bucket-name 的 common/profile/ 前缀下，并解释命令行为、断网恢复机制及验证方法。

1. 目标与效果#

将本地目录：

完整上传到：

假设本地存在：

上传后在 S3 中对应为：

说明：S3 的“文件夹”本质是对象 Key 的前缀（prefix），控制台展示为目录层级，但底层仍是对象键名字符串。

验证 AWS CLI 是否可用：

1
aws --version

验证是否能访问目标桶（需要具备 List/Put 权限）：

1
aws s3 ls s3://bucket-name/

执行同步上传：

1
aws s3 sync "G:\awss3\profile" "s3://bucket-name/common/profile/" --only-show-errors

aws s3 sync 同步本地目录与 S3 目标前缀，使目标端与源端内容一致（在不加 --delete 的情况下，只上传缺失/变更项，不会删除目标多余文件）。
"G:\awss3\profile" 本地源目录。CLI 会递归遍历该目录下所有文件与子目录。
"s3://bucket-name/common/profile/" S3 目标路径：桶名为 bucket-name，对象前缀为 common/profile/。
--only-show-errors 只输出错误信息，减少控制台噪音，适合大量文件上传。

aws s3 sync 的核心逻辑是“比较后上传”：

因此，重复执行同一条 sync 命令通常是安全且常见的操作。

上传过程中若出现断网、VPN 掉线、电脑休眠等情况：

直接重新执行同一条命令即可：

1
aws s3 sync "G:\awss3\profile" "s3://bucket-name/common/profile/" --only-show-errors

恢复机制说明：

注意：这里的“续传”是基于“已完成对象不重复上传、未完成对象会重传”的同步语义，而不是对单个小文件进行真正的分片续传。对于你这种 300–500KB 的小文件，重传成本很低，整体效果接近续传。

递归列出并汇总总大小与对象数：

1
aws s3 ls "s3://bucket-name/common/profile/" --recursive --human-readable --summarize

不实际上传，仅展示将要执行的操作：

1
aws s3 sync "G:\awss3\profile" "s3://bucket-name/common/profile/" --dryrun

若输出为空或无待上传项，通常表示源端与目标端已一致。

谨慎使用 --delete --delete 会删除 S3 端存在但本地不存在的对象，适合“镜像同步”，但风险较高。若不确认目标前缀是否只用于本次同步，请不要加。
路径与斜杠的含义
- 源路径写到具体目录：G:\awss3\profile
- 目标路径通常以 / 结尾：.../common/profile/ 有利于明确前缀是目录语义。
权限要求
- 至少需要对目标桶/前缀具备 s3:PutObject
- 验证/列举通常需要 s3:ListBucket

使用以下命令即可在 Windows 上将本地目录完整同步到 S3，并保持目录结构不变：

1
aws s3 sync "G:\awss3\profile" "s3://bucket-name/common/profile/" --only-show-errors

其优势在于：

如需进一步提升稳定性与速度，可在网络条件较差或文件更多时再结合 CLI 的重试模式与并发参数进行优化。