飞书下载完却打不开怎么办，这份排查指南收好

下载完软件包但双击没反应

我前两天刚帮同事处理过这个问题，她下载完飞书安装包，双击后屏幕纹丝不动，鼠标指针转了两圈就没然后了。这种时候别急着删掉重下，先看看文件后缀名对不对。Windows系统下飞书安装包通常是exe结尾的，如果你下载完发现是个压缩包或者后缀变成tmp、crdownload，那说明下载过程还没完成或者被浏览器拦截了。稍微等几分钟让浏览器把文件写完整，或者去下载管理页看看进度条是不是卡在99%不动。另一个常见情况是文件其实已经下载好了，但你点的不是本页下载按钮而是在某个镜像链接上点的，那个文件可能本身就损坏了。我建议你回到飞书官方那个下载站，再点本页下载按钮，等弹出真实exe文件再双击。Mac的话是dmg格式，下载完双击后桌面会挂载一个磁盘映像，再把里面的飞书图标拖进Applications文件夹，很多人忽略这一步直接双击磁盘里的app，出现提示权限不足就很正常了。

安装时提示「文件损坏」怎么办

这种情况在Mac上尤其频繁，我见过好几次。你从网上下载的飞书安装包，macOS的安全门禁会拦一下报「文件已损坏，请移至废纸篓」。别慌，这不是你的安装包真坏了，是苹果的Gatekeeper抽风。打开系统偏好设置里的安全性与隐私，看看底下有没有「仍要打开」这个选项，有的话点它就能跳过警告。如果没有这个选项，打开终端粘贴一段命令：sudo spctl --master-disable，回车输入密码后就能在安全设置里看到「任何来源」的选项了，选上它再重新双击dmg。Windows系统常见的错误是弹窗说「安装程序无法启动」或「文件不是有效的Win32应用程序」，十有八九是因为下载过程中断导致文件不完整。检查一下文件大小，飞书Windows版大概在200MB到300MB之间，如果只有几十KB那肯定装不了。这种情况下直接清掉浏览器缓存，再点本页下载按钮重新下载一次，全程别切换窗口或者关掉下载页。如果你用的是迅雷这类下载工具，有时候它是直接跳转到一个镜像站拿了旧版本，解压出来报错，那我就建议所有下载任务还是用浏览器自带的下载功能最稳。

双击安装包却弹出权限请求

我身边好几个朋友第一次装飞书都被这个吓到过，以为电脑中毒了。实际上飞书安装的时候要写注册表、创建启动项、把快捷方式丢进开始菜单，这些操作都需要管理员权限。Windows会弹个UAC窗口问你是否允许此应用对设备进行更改，点「是」就行。如果你点完「是」没反应，那可能是你当前电脑上有个后台进程卡住了，比如其他安装程序还没跑完。重启一次电脑再来装，干净得很。Mac端则是会让你输入系统密码或者用指纹授权，因为安装过程要把飞书程序拷贝到Applications目录，而这个目录默认只允许系统管理员写入。如果你用的是公司配的电脑，可能IT管理员锁死了Install权限，那你就得找IT帮忙装或者让他们远程给你开个白名单。还有一种情况是安装包本身是从U盘或者移动硬盘拷贝过来的，系统会标记它为「不安全来源」，你得右键点安装包选「打开」而不是双击，这样会多弹一次确认窗口，选打开就能继续。

安装完打不开/闪退怎么排查

装完飞书后桌面上多了个图标，双击进去就看到一个飞书logo闪一秒然后直接消失，这种闪退问题我遇过三四次了。先看看是不是电脑配置不够。飞书最低要求Windows 7以上、4GB内存、双核CPU，但如果你电脑还在用机械硬盘又跑着10个浏览器标签页和微信钉钉，飞书刚启动时内存占满就被系统杀了。我试过把Chrome关掉一半标签页，再启动飞书就正常了。Mac上闪退往往跟M1或M2芯片的转译模式有关，如果你是Apple Silicon电脑，记得下载ARM版本，别去下Intel版然后用Rosetta跑，偶尔会出兼容问题。另外显卡驱动太老也会导致飞书启动时渲染界面崩掉，去设备管理器更新下显卡驱动，或者在飞书安装文件夹里找到`bytedance-feishu`主程序右键属性→兼容性→勾选「以Windows 7兼容模式运行」，很多人都用这招修好了闪退。还有一个很冷门但真实坑过我的——C盘空间不足100MB，飞书启动时要写缓存文件，写不进去就直接退。清理下磁盘或者把虚拟内存改到D盘也能解。

下载站版本不对导致功能异常

一个用户跟我吐槽他的飞书能打开，但一直提示版本过低需要更新，更新按钮点了却说已经是最新。后来发现他去第三方下载站扒了一个老版本，那个站上的安装包为了体积特意去了更新组件。飞书本身的更新检查是靠一个内嵌的updater模块，如果装的是精简版或修改版，updater就被阉割了，只能一直卡在旧版本。解决方案很简单，直接去飞书官网或者通过本页下载按钮重新拉一个标准安装包覆盖安装就行，覆盖时不会丢聊天记录和文件。但是请注意，如果你之前自己手动改过飞书的缓存目录或者注册表路径，覆盖安装后有时候会残留旧配置导致功能乱掉。我建议卸载干净再装：Windows先去控制面板的添加或删除程序里卸掉飞书，再手动删除`C:\Users\你的用户名\AppData\Local\Feishu`和`C:\Users\你的用户名\AppData\Roaming\Feishu`两个目录，然后重启，最后点本页下载按钮装最新版。Mac的话把Applications里的飞书拖进废纸篓，再删除`~/Library/Application Support/Feishu`，同样重启再装一遍。

装了新版却打不开旧聊天记录

有一次我更新了飞书版本，登录后发现之前的聊天记录全没了，消息列表空空荡荡，差点以为被清空了。其实飞书聊天记录是存在本地数据库里的，版本大跨度更新（比如从3.x直接跳到6.x）时，数据库结构可能不兼容。第一次启动新版本会做一次数据迁移，这个过程如果因为权限不足或者硬盘空间不够就会中断，导致聊天记录显示不出来。不要反复关开飞书，这会让迁移状态卡死在半中间。我的处理办法是先退掉飞书，然后找到这个目录：`C:\Users\你的用户名\AppData\Roaming\Feishu\data\feishu.db`，把里面的feishu.db备份出来（复制到桌面），再清空feishu.db所在的整个data文件夹，重新登录飞书，它就会从服务端重新拉取最近的聊天记录（大概是最近半年的历史），老记录可以从备份文件里通过飞书自带的导入功能恢复。如果你不知道怎么导入，其实最笨也最有效的方法是保持飞书开着，放一个晚上别关，它的后台线程悄悄做迁移，第二天早上基本就能看到完整记录了。

网络、防火墙与企业管控的特殊坑

飞书打不开还有个很闷的原因——你公司的网络策略给封了。我朋友在一家金融公司上班，电脑上装了飞书就是连不上，一直转圈提示网络异常，后来发现是公司防火墙把飞书登录用的几个UDP端口给禁了。这种情况你本机怎么调都没用，只能找IT部门开白名单，让他们把`*.feishu.cn`和`*.bytedance.net`这两个域名放行。如果你自己在公司的WiFi下用手机热点连飞书却能正常登录，那百分之百是网络问题。另外有些企业的电脑装的是统一推送的管控版飞书，管理员后台限制了只能用特定版本，你从本页下载按钮拿到的个人版安装包根本装不上或者装完就被策略秒卸载。去公司内部的软件商店或者IT给的链接下载他们的企业定制版就行，通常版本号跟官方版不一样，但功能一致。还有一个很隐蔽的问题——系统时间不对。飞书登录时会校验SSL证书有效期，如果你电脑时间跑到2020年或者2035年，证书验证失败直接拒绝启动。我见过有人电脑主板电池没电了，每次重启时间都回到2018年，然后飞书就打不开了，手动同步一下网络时间就好了。