mac上steam游戏安装失败后，需手动清理common/下残缺游戏文件夹、downloading与temp临时目录、下载缓存及shadercache，并用终端或pearcleaner扫描删除孤立文件。
如果您在Mac上尝试安装Steam游戏时失败，系统可能已生成部分下载文件、临时缓存或不完整的游戏目录，这些残留内容无法被Steam自动识别和清除，会持续占用磁盘空间并干扰后续安装。以下是清理此类安装失败游戏碎片的具体方法：
一、定位并删除未完成的steamapps/common子目录
Steam在安装过程中会在~/Library/Application Support/Steam/steamapps/common/下为每个游戏创建独立文件夹；安装失败时，该文件夹可能已建立但内容为空或残缺，需手动识别并移除。
1、打开访达（Finder），按住Option键，点击顶部菜单栏“前往”→“资源库”。
2、依次进入Application Support → Steam → steamapps → common。
3、查找名称与您安装失败的游戏高度匹配的文件夹（例如包含游戏英文名、版本号或“incomplete”、“tmp”、“part”等字样）。
4、确认该文件夹内无有效可执行文件（如无.app、.dylib、.so或主游戏二进制文件），且修改日期为最近失败安装时段。
5、将该文件夹直接拖入废纸篓。
二、清空steamapps/downloading与steamapps/temp临时目录
Steam客户端在下载阶段会将分块数据暂存于downloading目录，安装解压过程则使用temp目录；安装中断后，这些目录中常遗留大量零散.part、.bin或未解压归档，必须主动清空。
1、在访达中进入~/Library/Application Support/Steam/steamapps/。
2、检查是否存在downloading文件夹：若存在，全选其内所有内容并删除。
3、检查是否存在temp文件夹：若存在，同样全选并删除全部内容。
4、若这两个文件夹不存在，无需创建，Steam会在下次下载时自动重建。
三、清除Steam下载缓存与着色器临时文件
下载缓存损坏可能导致重复下载失败，而shadercache中残留的未完成着色器编译任务会锁住GPU资源并占用GB级空间，二者均需清除。
1、启动Steam客户端，确保已登录账户。
2、点击左上角Steam → 设置 → 下载。
3、滚动到底部，点击清除下载缓存按钮。
4、在弹出提示中点击确定，等待进度条完成。
5、完全退出Steam（右键菜单栏Steam图标→退出，或Steam菜单→退出Steam）。
6、回到访达，前往~/Library/Application Support/Steam/steamapps/shadercache/。
7、删除该目录下所有子文件夹（每个子文件夹对应一个游戏ID，可批量删除）。
四、使用终端精准搜索并移除孤立游戏相关文件
安装失败可能在用户目录任意位置写入临时文件（如/tmp、~/Downloads、~/Desktop），仅靠路径判断易遗漏；通过终端命令可全局扫描关键词，确保无残留。
1、打开终端应用（位于“应用程序→实用工具”）。
2、输入以下命令并回车（将YourGameName替换为实际游戏名，支持模糊匹配，如“Cyberpunk”、“Stardew”）：
find ~/ -name "*YourGameName*" -maxdepth 4 -type d 2>/dev/null
3、观察返回路径，排除系统关键路径（如/System、/usr）及明确为正常项目的位置。
4、对确认为失败安装残留的路径，执行删除命令（示例）：
rm -rf "/Users/YourName/Downloads/Cyberpunk2077_incomplete"
5、重复步骤2–4，分别尝试搜索"steam_temp"、"partial_*.zip"、"incomplete_*.app"等常见失败标识符。
五、借助Pearcleaner自动识别并清理碎片文件
Pearcleaner是一款专为macOS设计的开源清理工具，能扫描Steam进程关联的临时文件句柄、未注册的下载片段及孤立的资源包，弥补手动操作盲区。
1、通过Homebrew安装：brew install pearcleaner；或从GitHub发布页下载pkg安装包。
2、首次运行时，系统会提示授予全盘访问权限与辅助功能权限，必须启用才能扫描后台残留。
3、启动Pearcleaner，在左侧选择Applications → Steam，右侧将列出所有检测到的非标准文件组。
4、勾选标注为"Incomplete Download"、"Orphaned Shader Cache"或"Temp Install Artifact"的条目。
5、点击Clean Selected执行清理，完成后重启Steam客户端验证状态。
