第7章 macOS 下 Stash 安装与运维指南

macOS

在 macOS 上，Stash 可以打包应用（Stash.app）或命令行程序（stash-macos）的形式运行。两者都是通用应用，可原生运行在 Apple silicon 和 Intel 架构的 Mac 上。 打包应用

注意 大多数用户建议使用打包应用。 它支持桌面通知、显示菜单栏图标，且无需从终端启动。 但由于应用限制，它只支持在 $HOME/.stash 中进行设置。如果想使用其他文件夹，则需要使用命令行程序。

安装

从 GitHub 仓库下载最新的 Stash.app.zip。 打开 Stash.app.zip 压缩包，将 Stash 应用拖到你的 Applications 文件夹。 打开 Stash 应用。 如果一切正常，会自动打开浏览器标签页 http://localhost:9999 即可开始使用。

更新

停止 Stash 服务。可以通过菜单栏图标，或在活动监视器中结束进程。 从 GitHub 仓库下载最新的 Stash.app.zip。 删除旧的 Stash 应用。 打开新下载的 Stash.app.zip 压缩包，将 Stash 应用拖到 Applications 文件夹。 打开 Stash 应用。 如果一切正常，会自动打开浏览器标签页 http://localhost:9999 即可开始使用。 视新版本的变更内容，可能会要求你进行数据库迁移，按提示操作即可。 迁移前会自动备份数据库。 如果迁移过程中出现问题，数据库会自动从备份中恢复。

之后就可以正常使用了。

卸载

停止 Stash 服务。 删除 Stash 应用。 删除 $HOME/.stash。

命令行程序

注意 命令行程序只建议熟悉终端的用户使用，或者不想在 $HOME/.stash 中设置的用户。 它不支持桌面通知，也不显示菜单栏图标，必须从终端启动。

安装

从 GitHub 仓库下载最新的 stash-macos 二进制文件。

在终端中运行 ./stash-macos。

如果遇到问题，尝试运行 chmod u+x stash-macos 为文件添加可执行权限。

如果一切正常，会自动打开浏览器标签页 http://localhost:9999 即可开始使用。

更新

停止 Stash 服务。可以关闭终端窗口，或在活动监视器中结束进程。 从 GitHub 仓库下载最新的 stash-macos 二进制文件。 删除旧的 stash-macos，替换为新下载的文件。

在终端中运行 ./stash-macos。

如果遇到问题，尝试运行 chmod u+x stash-macos 为文件添加可执行权限。

如果一切正常，会自动打开浏览器标签页 http://localhost:9999 即可开始使用。

视新版本的变更内容，可能会要求你进行数据库迁移，按提示操作即可。 迁移前会自动备份数据库。 如果迁移过程中出现问题，数据库会自动从备份中恢复。

之后就可以正常使用了。

卸载

停止 Stash 服务。 删除 stash-macos。 删除 $HOME/.stash。