主题
常见问题
按场景分类整理瓜子音乐的常见问题与排查指南。如果以下内容未能解决你的问题，可通过 官网 联系开发者反馈。
安装与启动
安装时杀毒软件报警？
瓜子音乐已通过 VirScan 多引擎在线检测平台 的安全扫描，30 款主流杀毒引擎 0 检出，确认安装包安全无病毒。详见 安全报告。
由于应用尚未进行数字签名（代码签名证书年费高昂，个人开发者难以负担），部分杀毒软件可能基于启发式扫描误判为可疑程序。请在杀毒软件中选择允许运行或添加信任。
运行时杀毒软件拦截某些功能？
任务栏播控、灵动岛桌面歌词等功能需要调用 Windows 系统底层 API（窗口嵌入、进程间通信等），这些操作可能被杀毒软件的行为监控标记为「可疑行为」并拦截。
这不是安全问题，而是杀毒软件对系统级操作的过度保护。如果上述功能不生效，请尝试：
- 在杀毒软件中将瓜子音乐加入信任列表 / 排除项
- 关闭杀毒软件的行为防护或主动防御功能后重试
- 如使用 Windows Defender，可在「病毒和威胁防护 → 排除项」中添加瓜子音乐安装目录
详细说明可参考 安全报告 中关于误报原因的说明。
双击图标没有反应？
- 打开任务管理器（Ctrl + Shift + Esc），查看是否有「瓜子音乐」进程在运行
- 如果有：结束该进程后重新启动
- 如果没有：尝试右键以管理员身份运行
- 仍然无效：卸载后从官网重新下载安装
启动后界面空白或加载不出来？
- 检查网络连接是否正常
- 确认防火墙没有阻止瓜子音乐的网络连接
- 尝试关闭后重新打开
- 清除缓存（设置 -> 缓存 -> 清除缓存）
- 检查显卡驱动是否为最新
安装后打不开，提示缺失 DLL？
- 这是 Windows 系统组件缺失导致
- 安装最新的 Visual C++ Redistributable
- 更新 Windows 到最新版本
播放问题
点击歌曲无法播放？
这是最常见的问题，请按以下步骤逐一排查：
第一步：确认是否安装了在线播放插件
- 进入 设置 -> 插件，查看插件状态
- 如果显示「未安装」或「已过期」，需要下载并导入新插件
- 详见 在线播放插件
第二步：尝试换源
- 当前平台的音源可能暂时不可用
- 在歌曲上右键 -> 换源，或尝试从其他平台搜索同首歌曲
- 详见 搜索歌曲 - 换源播放
第三步：检查网络
- 确认网络连接正常
- 部分网络环境（公司网络、校园网）可能限制了音乐服务的访问
- 尝试切换网络后重试
第四步：检查音源平台状态
- 某些平台的接口偶尔会出现临时故障
- 等待一段时间后再试，或直接换源到其他平台
第五步：尝试洛雪音源
- Pro 用户可导入 洛雪音源 扩展取链渠道
播放到一半自动暂停？
- 蓝牙设备断连：如果使用蓝牙耳机或音箱，设备断开时瓜子音乐会自动暂停。这是正常设计，重新连接后继续播放
- 网络问题：在线播放时网络不稳定可能导致缓冲暂停，检查网络连接
- 系统休眠：播放时瓜子音乐会阻止系统自动休眠。如果发现休眠导致暂停，可能是系统电源策略的冲突
音质不如预期？
- 播放详情页可以切换当前歌曲的音质，尝试选择更高音质档位
- 并非所有歌曲都有高品质资源，取决于音源平台
- 设置 -> 播放 -> 默认播放音质中可设置全局默认
- 无损 / Hi-Res 音质需要 Pro 权益，详见 Pro 权益
播放没有声音？
- 检查系统音量是否静音或过低
- 检查瓜子音乐音量是否被调到了最低（底部播放栏音量滑块）
- 确认电脑音频输出设备正确（扬声器 / 耳机切换）
- 尝试播放一首本地歌曲（本地音乐页面的文件），确认是否是在线播放特有问题
- 检查是否有其他应用占用了音频输出设备
搜索问题
搜索结果为空？
- 检查网络连接
- 尝试更简单的关键词（如只搜歌手名）
- 尝试换一个平台搜索（不要用聚合，直接搜索某个平台）
- 如果所有平台都无结果，可能是网络限制了音乐服务访问
搜索速度慢？
- 聚合搜索同时请求 6 个平台，通常 3-5 秒完成
- 如果持续超过 10 秒，可能是某个平台接口响应慢，或网络延迟高
- 查看是否有防火墙或代理影响了连接速度
搜到的歌和我想要的不一样？
- 尝试用更精确的关键词（歌手 + 歌名）
- 如果有同名歌曲，注意查看歌手是否一致
- 使用歌词搜索功能（搜索页 -> 歌词标签）找到记忆中的歌曲
VIP 歌曲搜得到但播不了？
下载问题
下载失败？
- 确认磁盘剩余空间充足（至少 500MB）
- 确认下载目录有写入权限（默认在文档目录下）
- 尝试换源后再下载
- 在下载管理页面点击 重试
- 确认已安装 在线播放插件
下载速度慢？
- 下载速度主要取决于音源平台服务器和你的网络
- 尝试在网络空闲时段下载
- 检查是否有其他下载任务占用带宽
- 不同平台的下载速度可能有差异，尝试换源
下载的歌曲在其他播放器没有封面/歌词？
- 确认设置 -> 通用 -> 嵌入元数据 开关已开启
- 下载完成后会写入 ID3 标签，部分非 MP3 格式可能不支持写入
- 详见 下载歌曲 - 下载文件信息
下载的文件在哪里？
- 默认在
文档/瓜子音乐/下载文件夹 - 可在 设置 -> 通用 -> 下载目录 中查看或修改
- 下载管理页面右键已完成歌曲也可「打开所在文件夹」
账号问题
登录后数据没同步？
- 确认登录账号和之前使用的是同一个
- 在用户中心点击 立即同步 手动触发同步
- 首次登录时如果云端为空、本地有数据，系统会把本地数据推送到云端（而非从云端拉取空数据覆盖本地）
- 详见 账号与云端同步
注册收不到验证码？
- 检查垃圾邮件箱
- 确认邮箱地址输入无误
- 等待 60 秒后重新点击发送
- 部分企业邮箱可能屏蔽验证码邮件，建议使用个人邮箱
- 如果多次尝试仍收不到，可能是邮件服务暂时异常
换电脑后数据不见了？
- 在新电脑上登录同一账号
- 在用户中心点击 立即同步 从云端拉取数据
- 确保旧电脑在换之前已成功同步过数据（数据在云端才有）
- 详见 账号与云端同步
忘记密码？
- 在登录界面点击 忘记密码
- 输入注册邮箱，获取验证码后重置密码
- 重置后新密码立即生效
歌词问题
歌词不显示？
- 部分歌曲可能没有歌词资源（尤其冷门歌曲）
- 检查网络连接，歌词需要联网获取
- 在设置 -> 歌词设置中调整歌词源优先级
- 对于本地歌曲，尝试将同名
.lrc歌词文件放在歌曲同目录下 - 详见 歌词与翻译 - 常见问题
逐字歌词和歌曲不同步？
- 逐字歌词的时间数据来源于歌曲平台，如果源数据有偏差可能导致不同步
- 尝试在歌词设置中降低歌词源优先级，切换到其他源的歌词
- 可能是音源版本与歌词版本不匹配（如 Live 版用了录音室版歌词），尝试换源
翻译不准确？
- AI 翻译结果仅供参考，特别是口语化表达可能不够自然
- 部分歌曲的官方翻译来自音源平台，质量更可靠
- 如果不需要翻译，可以在歌词设置中关闭自动翻译
其他问题
程序突然闪退？
- 重新启动瓜子音乐
- 如果频繁闪退，尝试卸载后重新安装
- 检查系统内存是否充足
- 查看是否安装了与瓜子音乐冲突的软件
如何联系技术支持？
目前通过以下渠道：
- 官网：guazi.fun
- 向开发者反馈问题
瓜子音乐收费吗？
瓜子音乐基础功能免费使用。Pro 可享受更多高品质播放权益，详见 Pro 权益。
当前免费权益
目前所有注册用户均享受月度 Pro 权益（截至 2026/07/31），体验到期后可斟酌是否继续支持瓜子音乐。
数据存在哪里？
- 本地数据：存储在 SQLite 数据库中（位于 userData 目录）
- 云端数据：登录后同步到瓜子音乐服务器
- 设置数据：本地存储，可同步的部分会随账号同步
- 详见 账号与云端同步
支持哪些操作系统？
- 目前仅支持 Windows 10 1809 及以上
- 暂无 macOS / Linux 版本计划
- 推荐使用 Windows 11 获得最佳体验
如何卸载？
- 通过 Windows 设置 -> 应用 -> 找到瓜子音乐 -> 卸载
- 或运行安装目录下的
Uninstall.exe - 卸载不会删除用户数据（位于 userData 目录），如需彻底清除需手动删除