GitHub上PDF提示无效无法显示、本地Chrome打开失败问题求助

第一步：排查浏览器内置PDF查看器配置 #

• 打开Chrome地址栏输入 chrome://settings/content/pdfDocuments 回车
• 确认当前配置项是否为「下载 PDF 文件，而不是在 Chrome 中自动打开它们」，如果开启了该选项，GitHub内置预览会直接失效，关闭后重新刷新页面测试即可
• 检查是否安装了会篡改PDF预览逻辑的浏览器扩展，比如第三方PDF编辑器、广告拦截类扩展，可先切换到无痕模式（快捷键Ctrl+Shift+N）打开目标PDF链接，确认是否能正常加载

第二步：排查网络与缓存问题 #

• 清除Chrome针对GitHub的站点缓存：按下F12打开开发者工具，长按地址栏左侧的刷新按钮，选择「清空缓存并硬性重新加载」
• 排查是否是网络代理、DNS污染导致的文件加载不完整：尝试切换手机热点等其他网络环境后重新访问
• 确认本地下载的PDF文件大小是否和仓库内显示的文件大小一致，如果大小不符说明下载过程中文件损坏，重新下载即可

第三步：排查本地PDF解析兼容性问题 #

如果是本地下载后打开报错：

• 尝试更换其他PDF阅读器（如Edge内置查看器、Adobe Acrobat）打开下载的文件，确认是否是当前默认PDF软件的兼容性问题
• 对比你下载的文件哈希值和好友能正常打开的文件哈希值，如果不一致说明你的下载过程中文件被篡改，重新下载即可

特殊场景排查 #

你当前使用的Chrome 94属于2021年发布的老旧版本，该版本对包含空格、特殊字符的资源路径解析存在已知缺陷，可尝试升级Chrome到最新正式版后重试。

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