通用 · 外观
选择随系统切换的浅色/深色主题，设定启动时显示欢迎窗口还是直接打开文件面板。
使用指南
从安装到进阶配置的完整路径。所有操作均基于当前稳定版 1.5.1，菜单名称以中文界面为准。
第一步
安装与首次启动
IINA 是标准的 macOS 应用，安装方式与绝大多数 Mac 软件一致，没有安装向导，也没有捆绑组件。
- 把 IINA 拖入「应用程序」即完成安装
- 首次启动时确认「来自互联网的应用」提示
- 之后可从启动台、聚焦搜索或程序坞打开
终端 · 校验安装
# 确认已安装的版本号
mdls -name kMDItemVersion /Applications/IINA.app
# 通过命令行打开一个视频文件
/Applications/IINA.app/Contents/MacOS/iina-cli ~/Movies/demo.mkv第二步
花两分钟做完这几项设置
打开「设置」（快捷键 ⌘,），以下几项最值得先调整。
通用 · 行为
开启「记住上次播放位置」，长片看到一半关掉也能接着看；可设定打开文件后自动暂停或直接全屏。
字幕 · 首选语言
填入 chi 或 chs 等语言代码，在线字幕检索会优先返回对应语言的结果。
视频 · 硬件解码
默认设置已适配大多数机型。若遇到花屏或异常，可切换为软件解码做对照排查。
界面 · OSC 布局
决定控制条出现在画面底部还是顶部，并选择要显示的控件集合。
快捷键 · 方案
先看一眼默认方案，若与你的习惯冲突，可复制一份再逐条修改。
第三步
加载字幕的三种方式
按「已有字幕文件」「需要在线检索」「字幕不同步」三种情况分别处理。
本地字幕自动匹配
把字幕文件与视频放在同一目录，文件名保持一致（例如 movie.mkv 与 movie.chs.srt），打开视频时会自动载入。若存在多个候选，IINA 会列出让你选。
在线搜索字幕
按 ⇧⌘D 或在菜单选择「字幕 › 查找在线字幕」。检索结果会按语言分组，勾选后下载并自动载入。OpenSubtitles 匿名访问有下载次数限制，登录账号可提高额度。
手动拖入字幕
直接把 .srt、.ass 等文件拖到播放窗口，即可临时加载，不影响源文件。
字幕不同步怎么办：在「字幕」菜单中调整延迟，或用快捷键微调正负偏移。调整只影响当前播放，不会改写字幕文件；确认合适后可另存为新的字幕文件。
第四步
常用快捷键速查
以下为默认键位方案中的操作。所有命令都可以在「设置 › 快捷键」中重新绑定，或复制方案后自定义。
| 操作 | 快捷键 | 说明 |
|---|---|---|
| 进入画中画 | ⌃ ⌘ P | 视频交给系统画中画窗口，可跨空间拖动 |
| 窗口置顶 | ⌃ ⌘ T | 播放窗口始终位于其他窗口之上 |
| A-B 循环 | ⌘ L | 标记起点与终点，循环播放选定片段 |
| 逐帧步进 | ⌥ + ← / → | 按住 Option 时菜单也会显示对应的备用命令 |
| 调整播放速度 | ⌘ ⌥ [ / ] | 降速或提速，适合精听与快速浏览 |
| 查找在线字幕 | ⇧ ⌘ D | 打开在线字幕检索面板 |
| 打开设置 | ⌘ , | 与 macOS 应用惯例一致 |
提示：默认方案下方向键按关键帧跳转，因此跳转位置可能不精确。若需要精确跳转，可复制默认方案后把左右键动作改为
seek 5 relative+exact；精确跳转在大文件上会略慢，属正常现象。
第五步
切换到音乐模式
播放音频文件时，在菜单「视频」中切换音乐模式，窗口会隐藏视频区域，只保留封面、曲目与精简控制条。再次切换即可回到普通播放界面。
- 适合播客、有声书与纯音乐专辑
- 界面更紧凑，占用屏幕面积更小
- 均衡器与音频设备选项仍然可用
- 播放位置与播放列表照常保留
音乐模式 · 示意
曲目名称
专辑 · 艺人
01:24 / 03:36
进阶
需要更细的控制时
IINA 把 mpv 的能力保留在界面之下，愿意读文档的人可以拿到完整的控制权。
使用自己的 mpv 配置
在「设置 › 进阶」中指定额外的 mpv 配置目录，IINA 会在启动时读取其中的选项。
# 示例：mpv.conf 片段
hwdec=auto
profile=gpu-hq
sub-auto=fuzzy
screenshot-format=png命令行打开文件
安装应用后可在终端调用 iina-cli，把播放行为写进脚本。
# 打开本地文件并指定起始时间
iina-cli --mpv-start=00:12:30 movie.mkv
# 把网页视频交给 IINA 播放
iina-cli https://example.com/stream.m3u8安装插件
在「设置 › 插件」中打开插件商店浏览安装，或双击下载好的插件包完成安装。插件崩溃不会导致播放器退出。
导出与恢复设置
换机时可通过「设置 › 进阶」导出配置，在新机器上导入即可沿用快捷键、界面与播放偏好。
以上操作仍未解决你的问题？查看 常见问题，或在 GitHub Issues 检索是否已有相同报告。