Skip to content

FAQ

Jump to bottom
binbin1213 edited this page Oct 29, 2025 · 1 revision

常见问题 (FAQ)

本页面收集了用户常见的问题和解决方案。

安装相关

Q: macOS 提示"无法打开应用"或"应用已损坏"？

解决方案:

# 在终端运行
sudo xattr -rd com.apple.quarantine /Applications/VideoTool.app

或者：

  1. 打开"系统设置" → "隐私与安全性"
  2. 找到 VideoTool 的提示
  3. 点击"仍要打开"

Q: Windows 提示"Windows 已保护你的电脑"？

解决方案:

  1. 点击"更多信息"
  2. 点击"仍要运行"

FFmpeg 相关

Q: 提示"FFmpeg 未安装"？

解决方案:

  1. 点击应用顶部的"立即安装 FFmpeg"按钮
  2. 等待自动下载和安装完成
  3. 安装完成后重启应用

Q: FFmpeg 自动安装失败？

手动安装 FFmpeg:

macOS:

brew install ffmpeg

Windows:

  1. 下载 FFmpeg: https://ffmpeg.org/download.html
  2. 解压到任意目录
  3. 将 bin 目录添加到系统 PATH

Q: FFmpeg 已安装但检测不到？

解决方案:

  1. 重启应用
  2. 检查 FFmpeg 是否在系统 PATH 中： 
    # macOS/Linux
which ffmpeg

# Windows
where ffmpeg

字幕转换

Q: 转换后中文显示为乱码？

原因: SRT 文件编码不是 UTF-8。

解决方案:

  1. 用文本编辑器打开 SRT 文件
  2. 另存为 UTF-8 编码
  3. 重新转换

Q: 转换后字幕时间轴不准确？

解决方案:

  1. 检查 SRT 文件格式是否正确
  2. 确保时间码格式为: 00:00:00,000 --> 00:00:00,000
  3. 检查是否有空行或格式错误

Q: 正则规则不生效？

检查项:

  • 是否勾选了"应用正则替换规则"
  • 查看右侧日志确认规则是否执行
  • 检查 SRT 文件内容是否符合规则匹配条件

Q: 想要自定义样式模板？

解决方案:

  1. 打开 src/shared/presets/subtitle-convert/ass-styles.txt
  2. 添加或修改样式定义
  3. 重启应用即可看到新样式

音视频合并

Q: 合并后音视频不同步？

解决方案:

  1. 使用"直接复制"模式（最快且不会引入同步问题）
  2. 检查源文件是否正常
  3. 尝试不同的编码设置

Q: 合并速度很慢？

优化建议:

  1. 使用"直接复制"模式 - 不重新编码，速度最快
  2. 启用硬件加速：
    • macOS: VideoToolbox
    • NVIDIA GPU: NVENC
    • Intel GPU: QSV
  3. 确保系统资源充足

Q: 合并后文件很大？

解决方案:

  1. 如果使用"直接复制"，文件大小 = 视频 + 音频大小
  2. 选择重新编码，可以选择：
    • H.265 编码器（更小，但兼容性稍差）
    • 调整音频比特率（如 128k）

Q: 支持哪些格式？

支持的格式:

  • 视频: MP4, AVI, MKV, MOV, FLV, WMV, WebM
  • 音频: MP3, AAC, WAV, FLAC, M4A, OGG

字幕烧录

Q: 烧录后字幕显示模糊？

解决方案:

  1. 使用高分辨率的视频
  2. 使用 ASS 字幕（比 SRT 更精细）
  3. 调整字幕字体大小

Q: 烧录速度很慢？

解决方案:

  1. 启用硬件加速
  2. 选择较快的编码预设
  3. 降低输出分辨率（如果可接受）

性能相关

Q: 应用占用内存很高？

正常范围:

  • 空闲: 150-300 MB
  • 处理中: 300-600 MB
  • 大文件: 可能达到 1 GB+

优化建议:

  1. 关闭不使用的功能页面
  2. 处理完成后重启应用释放内存
  3. 避免同时处理多个大文件

Q: CPU 占用率100%？

说明: 视频编码是 CPU 密集型任务，占用高是正常的。

优化:

  • 使用硬件加速
  • 使用"直接复制"模式
  • 降低编码质量设置

错误排查

Q: 功能突然不可用？

排查步骤:

  1. 打开"日志查看"页面查看详细日志
  2. 按 F12 打开开发者工具查看控制台错误
  3. 重启应用
  4. 重新安装 FFmpeg

Q: 如何查看详细日志？

方法 1 - 应用内:

  1. 点击左侧"日志查看"
  2. 查看所有操作记录

方法 2 - 开发者工具:

  1. 按 F12 打开开发者工具
  2. 切换到"Console"标签页
  3. 查看详细的错误信息

方法 3 - 日志文件:

  • macOS: ~/Library/Logs/VideoTool/
  • Windows: %APPDATA%\VideoTool\logs\

Q: 遇到未知错误怎么办？

解决步骤:

  1. 记录错误信息（截图或复制文字）
  2. 记录重现步骤
  3. 访问 GitHub Issues
  4. 搜索是否有类似问题
  5. 如果没有，创建新 Issue 并提供详细信息

使用技巧

Q: 如何批量处理字幕？

临时方案（批量功能开发中）:

  1. 使用相同的设置
  2. 依次拖拽文件进行转换
  3. 保存好配置设置

Q: 如何保存常用设置？

当前版本: 应用会记住上次使用的设置，下次启动自动加载。

未来版本: 将支持保存多个预设配置。

更新相关

Q: 如何检查更新？

手动更新:

  1. 访问 Releases 页面
  2. 下载最新版本
  3. 安装覆盖旧版本

Q: 更新后设置会丢失吗？

不会: 应用数据存储在用户目录，更新不会影响。

仍然有问题？

如果以上答案没有解决您的问题：

  1. GitHub Issues - 报告 Bug
  2. GitHub Discussions - 提问和讨论
  3. Email - 邮件联系

我们会尽快回复！

最后更新: 2025-10-29

Clone this wiki locally