故障排除
遇到问题？以下是修复常见问题和获取帮助的方法。
常见问题
便签消失了
不要慌——BetterStickies 有自动备份。尝试关闭并重新打开应用。如果便签重新出现，说明备份恢复成功。
如果没有恢复，便签文件可能已损坏。便签数据位于：
| 平台 | 便签位置 |
|---|---|
| Linux | ~/.config/BetterStickies/data/notes.json |
| Windows | %APPDATA%\BetterStickies\data\notes.json |
| macOS（即将推出） | ~/Library/Application Support/BetterStickies/data/notes.json |
修改前请先备份 data 文件夹。
全局快捷键不起作用（Linux）
Linux 上，全局快捷键需要在桌面环境设置中配置。打开 BetterStickies，进入设置 > 全局快捷键——对话框会引导完成设置。
Windows SmartScreen 警告
首次在 Windows 上运行 BetterStickies 时，SmartScreen 可能显示"Windows 已保护你的电脑"警告。这是因为应用较新，尚未在 Microsoft 建立足够的下载信誉——不是安全风险。
解决方法：
- 点击 SmartScreen 对话框中的更多信息
- 点击仍要运行
警告仅在首次启动时出现。之后 Windows 会记住选择。
应用无法启动
尝试删除配置文件夹来重置设置。请先备份 data 子文件夹以保留便签。
| 平台 | 配置文件夹 |
|---|---|
| Linux | ~/.config/BetterStickies/ |
| Windows | %APPDATA%\BetterStickies\ |
| macOS（即将推出） | ~/Library/Application Support/BetterStickies/ |
报告 Bug
发现 Bug 请在 github.com/HimaSphere/BetterStickies/issues 提交 Issue。
需要包含的信息
- 发生了什么以及期望的结果
- 日志文件（见下文）——帮助快速诊断问题
- 系统信息——操作系统名称和版本（如"Ubuntu 24.04"、"Windows 11"）
- 复现步骤——发生时正在做什么？
查找日志文件
BetterStickies 自动保存包含诊断信息的日志文件。报告 Bug 时请附上。
| 平台 | 日志文件位置 |
|---|---|
| Linux | ~/.config/BetterStickies/betterstickies.log |
| Windows | %APPDATA%\BetterStickies\betterstickies.log |
| macOS（即将推出） | ~/Library/Application Support/BetterStickies/betterstickies.log |
日志文件保持较小（不到 1 MB）并自动轮转——可以放心附上整个文件。
获取更多详情
如果需要更多关于疑难 Bug 的详情，可以在详细模式下启动 BetterStickies：
TEXT
betterstickies --verbose
这会在终端输出额外的诊断信息。将终端输出连同日志文件一起分享。