Skip to main content

文件上传/下载

本文详细介绍 CloudStudio 社区版中文件上传与下载的操作方法，涵盖不同场景下的操作方式、注意事项及问题解决方案，帮助您高效管理项目文件。

一、文件上传操作​

支持 「拖拽」 和 「复制粘贴」 两种方式，可根据文件类型（单个文件/文件夹）灵活选择，操作前需准备好本地待上传的文件或文件夹。

方式 1：拖拽上传（推荐）​

  • 适用场景：单个/多个文件、文件夹的批量上传（最便捷方式）。

  • 操作步骤：

    1. 打开本地文件管理器，找到需上传的文件或文件夹；
    2. 按住鼠标左键，将文件/文件夹 直接拖拽至 CloudStudio 左侧「工程区域」的目标存储文件夹（如根目录、assets 文件夹等）；
    3. 释放鼠标，系统自动开始上传。上传过程中，「工程区域」上方会显示流动线条（表示上传中），若线条停止且无报错，则上传成功。

方式 2：复制粘贴上传（仅文件）​

  • 适用场景：单个或少量文件上传（不支持文件夹）。
  • 操作步骤：
    1. 复制本地文件：
      • 右键单击文件，选择「复制」；或选中文件后按快捷键 Ctrl+C（Windows）/ Command+C（Mac）。
    2. 粘贴至 CloudStudio：
      • 在「工程区域」中，单击选中目标存储文件夹（确保光标定位正确）；
      • 按快捷键 Ctrl+V（Windows）/ Command+V（Mac），文件将自动粘贴并上传至该文件夹。

上传注意事项​

  • 网络要求：上传 50MB 以上大文件时，建议使用有线网络或稳定 WiFi，避免因网络波动导致中断或失败。
  • 失败解决：若上传失败，可检查网络连接后重新上传，或确认目标文件夹权限（默认支持读写，无需额外设置）。

二、文件下载操作​

目前仅支持 单个文件下载，暂不支持直接下载文件夹（若需下载文件夹，可先在本地压缩为 ZIP 包上传，再下载 ZIP 包）。

（一）操作步骤​

  1. 在「工程区域」中找到目标文件，右键单击该文件；
  2. 选择弹出菜单中的 「下载」 选项；
  3. 浏览器自动触发下载，文件保存至本地默认下载路径（可在浏览器设置中修改）。

（二）下载注意事项​

  • 浏览器限制：
    • Safari、Firefox：无单文件大小限制；
    • Chrome：目前支持最大 2GB 单文件下载，超过 2GB 建议压缩拆分后下载。
  • 下载速度：受本地网络带宽和服务器负载影响，大文件下载耗时较长，建议在网络空闲时段操作。
  • 大文件下载：若文件过大导致无法在当前工作空间直接下载，可按以下步骤操作：在终端执行命令 echo "https://${X_IDE_SPACE_KEY}.ap-shanghai2.cloudstudio.club"，待终端打印出工作空间地址后，将其复制粘贴到浏览器新标签页打开，随后在新页面中右键选择下载即可。