帮助与支持

在这里找到使用 IINA 的一切答案,社区与文档随时为你服务

支持渠道

选择适合你的求助方式

无论遇到何种问题,总有一种方式可以帮到你。

常见问题

下方 FAQ 涵盖了用户最常遇到的问题。在联系社区之前,建议先在这里寻找答案,多数问题都能快速解决。

浏览常见问题 →

使用文档

GitHub Wiki 提供了详尽的使用文档,涵盖基础操作、高级配置、mpv 选项、脚本扩展等全方位内容。

访问文档 →

GitHub Issue

遇到 Bug 或有功能建议?在 GitHub Issue 中提交,开发者会定期查看与回复。请提供详细复现步骤与系统信息。

提交 Issue →

社区讨论

加入 Telegram 群组、Reddit 社区、V2EX 等讨论区,与全球 IINA 用户交流使用心得、分享配置、解决问题。

加入社区 →

FAQ

常见问题解答

这里收录了用户最常提出的问题,希望能快速解答你的疑惑。

IINA 是免费的吗?有广告或内购吗?
IINA 完全免费开源,遵循 GPLv2 协议。没有任何广告、内购、付费功能或商业捆绑。所有功能对所有用户一视同仁,源代码托管于 GitHub 接受社区监督。我们坚信优秀的软件应当自由分享,这也是 IINA 自 2017 年发布以来始终坚守的原则。如果你愿意支持项目发展,可以通过 GitHub Sponsors 进行赞助,但赞助不会带来任何功能上的差异。
IINA 支持 Apple Silicon (M1/M2/M3) 吗?
支持。IINA 提供 Universal Binary,原生支持 Apple Silicon 芯片,无需 Rosetta 转译,性能与能效比表现优异。安装包会自动识别你的 Mac 架构,无论是 Intel Mac 还是 Apple Silicon Mac,都能获得最佳体验。我们在 M1/M2/M3 系列芯片上进行了充分测试,包括 4K HDR 视频播放、硬件解码、画面渲染等场景,均可流畅运行。
IINA 支持哪些视频和音频格式?
IINA 基于 mpv 内核,支持几乎所有主流音视频格式。视频方面包括 MKV、MP4、AVI、MOV、WebM、FLV、TS、WMV 等容器,H.264、H.265/HEVC、AV1、VP9、ProRes、DNxHD 等编码。音频方面支持 FLAC、ALAC、DSD、APE、WAV、MP3、AAC、Opus 等格式。字幕方面支持 SRT、ASS、SSA、VTT、PGS、VOB 等。此外还支持 HDR10、HDR10+、Dolby Vision、HLG 等 HDR 格式,以及 4K/8K 高分辨率、高帧率内容。无需额外安装任何解码器。
首次打开 IINA 提示「无法验证开发者」怎么办?
这是 macOS 对未签名或非 App Store 应用的标准安全提示。解决方法:前往「系统设置 > 隐私与安全性」,在底部会看到「已阻止使用 IINA」的提示,点击「仍要打开」按钮即可。也可以在 Finder 中右键点击 IINA 应用,选择「打开」,在弹出的对话框中点击「打开」。如果你希望避免此提示,可以考虑通过 Homebrew 安装(brew install --cask iina),Homebrew 安装的版本会自动处理签名问题。
如何搜索和加载字幕?
IINA 内置 OpenSubtitles 集成,提供便捷的在线字幕搜索功能。播放视频时,点击播放器右下角的字幕按钮,或使用快捷键 Option+S,选择「在线搜索字幕」。IINA 会自动根据视频文件名匹配字幕资源,你可以在搜索结果中选择合适的语言与版本,一键下载并加载。也可以手动将字幕文件拖入播放器窗口加载。加载字幕后,可以在字幕设置中调整字体、大小、颜色、位置、时间轴等参数。
IINA 支持画中画模式吗?
支持。播放视频时,点击播放器工具栏上的画中画按钮,或使用快捷键 Option+P,即可将视频以小窗口形式悬浮在屏幕上方。画中画窗口可以拖动到屏幕任意位置,大小可自由调整。在画中画模式下,你可以同时处理其他工作,视频不会被遮挡。画中画窗口还提供基本的播放控制:暂停/播放、快进/快退、关闭。当主窗口最小化或切换到其他应用时,画中画窗口会持续显示,非常适合边看视频边工作的场景。
如何更新 IINA 到最新版本?
IINA 内置自动更新功能,默认会在后台检查新版本。当有新版本可用时,应用启动时会弹出更新提示,点击「更新」即可自动下载并安装。你也可以在 IINA 菜单中选择「检查更新」手动触发检查。如果你通过 Homebrew 安装,使用 brew upgrade iina 命令更新。从 GitHub Release 下载的用户,需要重新下载新版本 DMG 覆盖安装。无论哪种方式,更新都不会影响你的个人设置与配置。
IINA 播放 4K HDR 视频时卡顿怎么办?
首先确认硬件是否满足 4K HDR 播放要求,建议使用 Apple Silicon Mac 或较新的 Intel Mac。然后在 IINA 偏好设置 > 高级 中确认已开启硬件加速(VideoToolbox)。如果仍有卡顿,可以尝试以下方案:1) 关闭画质增强滤镜;2) 在 mpv 配置中调整 hdr-tone-mapping 算法;3) 降低视频输出后端要求;4) 关闭其他占用 GPU 资源的应用。如果问题依旧,请在 GitHub Issue 中提交详细报告,包括系统信息、视频规格、IINA 版本等。
如何自定义快捷键?
IINA 提供完整的快捷键自定义功能。打开偏好设置 > 控制器 > 键绑定,即可看到所有快捷键列表。你可以修改任意快捷键,或添加新的绑定。IINA 支持组合键、连发、上下文相关绑定等高级配置。对于进阶用户,还可以直接编辑 mpv 的 input.conf 文件,实现更复杂的快捷键逻辑。修改完成后保存即可生效,无需重启应用。
IINA 可以播放加密 DVD 或蓝光吗?
IINA 本身不包含破解加密的功能。对于未加密的 DVD 与蓝光镜像,IINA 可以直接播放。对于加密内容,由于法律原因,IINA 不内置解密功能,但用户可以自行配置 libdvdcss 等工具配合使用。我们建议用户通过合法渠道获取媒体内容,尊重版权。对于自己购买的正版 DVD/蓝光,可在法律允许的范围内进行个人备份与播放。
如何参与 IINA 的开发或翻译?
IINA 是开源项目,欢迎各类贡献。代码贡献:在 GitHub 上 Fork 仓库,创建分支进行开发,提交 Pull Request。新贡献者请先阅读仓库根目录的 CONTRIBUTING.md 指南。翻译贡献:IINA 的本地化文件位于 GitHub 仓库的 iina/translations 目录,你可以直接编辑 .strings 文件提交翻译。文档贡献:可以参与 GitHub Wiki 的完善。Issue 反馈:遇到 Bug 或有建议,请在 GitHub Issue 中提交。每一份贡献都让 IINA 变得更好。
IINA 与 VLC、QuickTime 相比有什么优势?
相比 QuickTime,IINA 支持更多格式(无需额外解码器),提供更强大的播放控制(倍速、AB 循环、逐帧)、更完善的字幕支持与更现代的界面。相比 VLC,IINA 是纯原生 macOS 应用,UI 与系统集成度远超 VLC 的跨平台界面;基于 mpv 内核在画质与性能上也有优势;同时 IINA 的设计语言完全遵循 macOS 规范,使用体验更接近系统原生应用。简单来说,IINA = QuickTime 的原生体验 + VLC 的格式兼容 + mpv 的专业画质。
社区支持

加入 IINA 社区

与全球 IINA 用户与开发者交流,分享使用心得,获取第一时间更新。

GitHub

项目主仓库,源代码、Issue、Pull Request、Release 都在这里。开发者与进阶用户必关注。

github.com/iina/iina →

Telegram

官方 Telegram 群组,实时交流使用问题、分享配置、获取开发进展。中文用户友好。

t.me/iinaofficial →

Reddit

r/IINA 子版块,英文社区主要讨论区。分享使用技巧、配置文件、问题求助。

reddit.com/r/IINA →

Twitter

官方 Twitter 账号,获取版本更新通知、开发动态、使用技巧分享。

@iina_app →

问题反馈

如何高效提交 Bug 报告

一份详细的 Bug 报告能帮助开发者快速定位与修复问题。

步骤 01

复现问题

尝试多次复现 Bug,找出稳定的复现步骤。记录下具体的操作序列,包括打开的文件类型、使用的功能、触发的快捷键等。如果问题偶发,记录出现的频率与可能的诱因。

步骤 02

收集系统信息

记录你的 macOS 版本、Mac 型号、芯片类型(Intel/Apple Silicon)、IINA 版本号。可在 IINA 菜单 > 关于 IINA 中查看版本号。这些信息对定位问题至关重要。

步骤 03

截图与日志

提供问题发生时的截图或录屏。如果应用崩溃,请附上崩溃日志(可在「活动监视器」或「控制台」中找到)。日志文件能直接揭示问题原因。

步骤 04

搜索重复 Issue

在提交前,先在 GitHub Issue 中搜索是否已有相同问题的报告。如果有,请在原 Issue 下补充你的情况,而非创建新 Issue。这能集中信息,提高处理效率。

步骤 05

提交 Issue

在 GitHub Issue 页面点击 New Issue,按照模板填写内容。清晰的标题、详细的复现步骤、完整的系统信息、必要的截图,这些都会让开发者更快响应。

步骤 06

跟进反馈

提交后请保持关注,开发者可能会要求你提供更多信息或测试某个修复版本。及时响应能让问题更快解决。问题修复后,会通过 Issue 关闭通知你。

还没下载 IINA 吗

立即获取,开启现代 macOS 媒体播放体验