如何使用Python将整个文件夹上传至Box并保留原有目录结构

最新版 Box 官方 Python SDK（boxsdk>=3.0.0）已经内置了无需自行编写递归逻辑的文件夹上传方法，可直接调用，完全保留本地目录结构。

前置操作 #

首先升级到最新版SDK：

pip install --upgrade boxsdk

可直接运行的代码示例 #

完成SDK认证后调用内置方法即可，无需自己实现遍历逻辑：

from boxsdk import Client, OAuth2

# 替换为你自己的认证信息
auth = OAuth2(
    client_id="你的应用客户端ID",
    client_secret="你的应用客户端密钥",
    access_token="你的有效访问令牌"
)
client = Client(auth)

# 上传配置
LOCAL_FOLDER_PATH = "./documents/A"  # 本地待上传的文件夹路径
BOX_PARENT_FOLDER_ID = "0"  # 上传到Box的目标父文件夹ID，0代表根目录

# 一键上传，自动保留完整目录结构
uploaded_folder = client.folder(BOX_PARENT_FOLDER_ID).upload_local_folder(
    local_path=LOCAL_FOLDER_PATH,
    # 同名文件冲突处理策略：可选overwrite（覆盖）/rename（自动重命名新文件）/skip（跳过不上传）
    upload_using="overwrite"
)

print(f"上传完成，Box端文件夹ID：{uploaded_folder.id}")

内容的提问来源于stack exchange，提问作者A. Lewis