#安装

从 releases 页面下载对应平台的最新安装包进行安装。

已安装过？参见《软件更新》了解自动更新与手动更新方式。

#Windows WebView2

对于 Windows 平台，如果因网络问题无法安装 WebView2，可以离线下载安装 WebView2。

#macOS —— 未签名应用（Gatekeeper）

macOS 版 Duckling 未签名 / 未公证，Gatekeeper 会在首次启动时拦截并提示“已损坏”或“无法验证开发者”。请移除隔离属性以允许运行：

sudo xattr -rd com.apple.quarantine /Applications/Duckling.app

如果应用（.app 包）不在 /Applications 中，请替换为实际安装路径。

-rd 参数表示递归重写属性，会清除应用包及其内部所有文件的隔离标记；每个下载副本只需执行一次。另一种方式是右键点击 Finder 中的应用并选择打开来手动批准。

#安装路径注意事项

软件安装路径要选择空白文件夹或者新建文件夹，不要选择非空文件夹，也不要将数据文件放到安装路径中。

卸载时，如果选择了清空数据文件，整个文件夹会被删除——即使不是软件自己的文件。

#Q&A

在 Windows 上，DuckDB 需要 Microsoft Visual C++ Redistributable 包作为运行时依赖项。如果 DuckDB 相关功能异常，可能就是此依赖项的问题，需要自行下载安装修复。详见《构建 DuckDB》。