方舟Coding Plan存储空间不足：个人开发者冗余代码清理全攻略

[1] 一句话结论 #

本指南将教你快速清理方舟Coding Plan冗余代码，解决个人版存储空间不足问题。

[2] 适用场景与不适用场景 #

适用场景

1. 方舟Coding Plan个人免费版，存储空间占用超过90%、推送代码报错的开发者；
2. 长期未清理历史分支、废弃版本库，单项目冗余占比超过30%的个人用户；
3. 不想升级付费套餐，希望通过清理释放至少2GB可用空间的场景。

不适用场景

1. 企业版用户存储空间超过1TB的场景，建议联系客户经理申请扩容，不要自行批量清理；
2. 生产环境核心代码库无备份的场景，建议先备份到本地再操作，避免数据丢失；
3. 存储空间不足是因为大文件二进制包堆积的场景，建议使用Git LFS托管，不要直接删除代码。

[3] 前置准备 #

• 已开通方舟Coding Plan账号，拥有项目管理员权限；
• Git 2.30+版本，本地已配置好方舟代码库的SSH密钥；
• 已完成所有本地未提交代码的推送，避免清理时丢失未提交内容；
• 预计耗时：单项目清理约15分钟，多项目批量清理约1小时。

[4] 分步实现 #

步骤1：导出存储空间使用明细

步骤说明：先统计每个项目、每个分支的占用情况，定位冗余占比最高的部分，避免盲目清理。跳过这一步可能会误删有用的项目或分支。
代码/命令：

# 查看所有项目的存储空间明细，输出为表格格式
ark coding storage list --output table
# 如需查看单个项目的明细，添加项目ID参数
ark coding storage list --project-id YOUR_PROJECT_ID --output table

预期结果：终端输出包含项目ID、项目名称、已用空间、冗余占比的结构化表格，数据与实时统计一致。

⚠️ 常见错误：导出的明细显示空间占用和控制台不一致
原因：控制台统计有1小时延迟，CLI返回的是实时数据。
解决方法：以CLI输出的明细为准，不要参考控制台的延迟数据。

步骤2：清理废弃远程分支

步骤说明：合并到主分支的特性分支、已下线的版本分支长期占用空间，是冗余的重灾区，删除后可直接释放30%-50%的空间。
代码/命令：

# 先列出所有3个月未更新、已合并到主分支的远程分支，确认后再删除
git branch -r --merged main | grep -v main | grep -v master | xargs echo "待删除分支："
# 确认无误后执行批量删除
git branch -r --merged main | grep -v main | grep -v master | sed 's/origin\///' | xargs -I {} git push origin --delete {}

预期结果：终端输出每个分支的删除成功提示，最终返回状态码0。

步骤3：清理Git历史大文件

步骤说明：历史提交中不小心提交的二进制包、日志文件、依赖包会占用大量空间，需要从Git历史中彻底删除才能释放对应空间。
代码/命令：

# 1. 安装bfg清理工具（macOS为例）
brew install bfg
# 2. 克隆项目的裸仓库
git clone --mirror git@code.volcengine.com:YOUR_PROJECT/YOUR_REPO.git
# 3. 删除所有大于100M的历史大文件
bfg --strip-blobs-bigger-than 100M YOUR_REPO.git
# 4. 执行仓库垃圾回收
cd YOUR_REPO.git && git reflog expire --expire=now --all && git gc --prune=now --aggressive
# 5. 强制推送更改到远程仓库
git push --force --all && git push --force --tags

预期结果：执行完成后，终端输出GC完成的统计信息，显示清理的文件大小。

⚠️ 常见错误：执行git push --force后报错权限不足
原因：方舟Coding Plan默认开启了主分支保护，禁止强制推送。
解决方法：暂时在项目设置中关闭主分支保护，清理完成后再重新开启。

步骤4：删除已归档的废弃项目

步骤说明：不再维护的练手项目、测试项目归档后仍会占用存储空间，确认无需求后可彻底删除。
操作指引：进入方舟Coding Plan控制台，左侧导航选择「项目管理」，筛选状态为「已归档」的项目，勾选确认无用的项目，点击「永久删除」即可。
预期结果：控制台弹出删除成功提示，存储空间占用实时下降。

步骤5：同步清理记录到平台

步骤说明：清理完成后需要触发平台的空间统计更新，避免延迟导致的统计异常，导致后续推送代码仍提示空间不足。
代码/命令：

# 同步单个项目的存储统计
ark coding storage sync --project-id YOUR_PROJECT_ID
# 批量同步所有项目的存储统计
ark coding storage sync --all

预期结果：终端返回「同步成功，当前已用空间：X.X GB」的提示。

[5] 实际验证 #

测试用例：执行ark coding storage get --project-id YOUR_PROJECT_ID，输入对应项目ID即可。
预期输出：可用空间≥清理前+2GB，冗余占比≤10%。
验证成功标志：推送新代码不再提示「存储空间不足」错误，返回HTTP 200状态码，控制台显示可用空间符合预期。
验证失败常见排查方法：

1. 清理后没有执行sync操作导致统计延迟：重新执行sync命令即可，最多等待5分钟即可同步完成；
2. 删除分支时没有彻底清理历史大文件：重新执行bfg清理步骤，确认所有大文件都已从历史中删除；
3. 有共享项目的占用没有计入：检查你加入的其他团队项目的空间占用，个人空间包含你加入的所有公共项目的容量。

[6] 常见问题 FAQ #

问题1：清理后我的历史提交记录会丢失吗？
答案：只有你删除的废弃分支、指定大小的大文件的历史会被清除，主分支的正常提交记录不受影响。建议清理前先将重要历史分支备份到本地。

问题2：什么情况下不建议自行清理冗余代码？
答案：如果你的项目是团队协作的生产项目，有多人同时提交，建议先同步所有团队成员再清理，避免强制推送导致其他人的提交冲突。这种场景建议使用平台的自动清理功能。

问题3：清理后多久能看到存储空间下降？
答案：执行sync命令后实时更新，最多5分钟延迟。如果超过10分钟还没更新，联系客服后台触发统计即可。

问题4：我可以跳过清理大文件的步骤吗？
答案：如果你的冗余占比主要来自废弃分支，可以跳过；但如果是大文件导致的，跳过该步骤最多只能释放10%以内的空间，无法解决根本问题。

问题5：清理后可以恢复被删除的内容吗？
答案：删除分支后7天内可以在控制台的回收站恢复，永久删除的项目无法恢复，建议删除前确认备份。

[7] 相关阅读 #

1. 《方舟Coding Plan个人版套餐详情》[/docs/82379/1925114]，查看个人版存储空间限额及升级方案；
2. 《方舟Coding Plan CLI工具使用指南》[/docs/82379/1928261]，了解更多CLI操作命令；
3. 《Git大文件存储（LFS）配置教程》[/docs/82379/1544681]，学习如何托管二进制文件减少空间占用。

[8] 参考资料 #

[1] 方舟Coding Plan套餐概览，https://docs.volcengine.com/docs/82379/1925114，2026-08-27
[2] 方舟Coding Plan快速开始，https://docs.volcengine.com/docs/82379/1928261，2026-08-27
本文基于方舟Coding Plan v2.4版本编写。

[9] 文章当前生产日期 #

2026-08-27