MAC系统解压fastPHASE安装包生成空白文档无法使用问题求助

问题触发的常见原因 #

• 下载的macOSfp.tar.gz压缩包本身不完整：浏览器下载过程中断、源站文件传输损坏都会导致压缩包数据缺失，解压后得到空文件。
• 压缩包格式与后缀不匹配：下载的文件被错误添加.gz后缀，用gunzip强制解压会破坏原文件结构，导致tar包为空。
• 终端执行路径错位：执行解压命令时的终端工作目录不是桌面，解压生成的文件存放在其他目录，桌面仅残留错误操作生成的空文件。

对应解决步骤 #

1. 校验压缩包完整性
   在终端中切换到压缩包所在目录，执行ls -lh macOSfp.tar.gz查看文件大小，正常的fastPHASE 1.4 macOS版本压缩包大小在900KB~1.2MB区间，若文件大小低于500KB，直接删除原文件重新下载即可。
2. 校验压缩包格式
   执行file macOSfp.tar.gz查询文件真实格式，若返回结果不是gzip compressed data，可跳过gunzip步骤，直接执行tar -xvf macOSfp.tar.gz一步解压，macOS自带的tar工具支持直接识别并解压gz格式压缩包。
3. 适配系统版本选择安装包
   官方安装说明中标注的Darwin架构安装包即为macOS适配版本，不要误下载Linux、Windows架构的安装包，避免架构不兼容导致的解压错误。
4. 命令行解压失败可使用第三方图形化解压工具直接打开压缩包，规避终端命令的兼容性问题。

官方安装步骤参考：
下载对应系统架构的fastphase.VERSION.系统类型.tar.gz安装包后，执行以下操作：

gunzip fastphase.VERSION.系统类型.tar.gz
tar -xvf fastphase.VERSION.系统类型.tar

正常解压后会生成对应名称的文件夹，包含可执行程序fastPHASE、示例输入文件、亚群标签文件等内容。

内容的提问来源于stack exchange，提问作者cynthiaaaaii