常見問題

Dropstone 使用者最常遇到的問題，以及修復步驟。如需執行時期錯誤與各功能的除錯資訊，請參閱 CLI 疑難排解 頁面。

macOS 安裝失敗

「Command not found: brew」

您需要先安裝 Homebrew。只需安裝一次：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

在 Apple Silicon 上，還需要將 Homebrew 加入您的 PATH：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

然後重新執行 Dropstone 安裝：

brew tap blankline-org/dropstone-cli
brew install dropstone

「Cannot install: package already exists」

強制覆寫現有的安裝：

brew uninstall dropstone
brew install dropstone

Homebrew tap 重新整理失敗

清除快取並重新加入 tap：

brew untap blankline-org/dropstone-cli
brew cleanup
brew tap blankline-org/dropstone-cli
brew install dropstone

Windows 安裝失敗

「irm is not recognized as an internal or external command」

您目前位於 CMD，而非 PowerShell。請切換到 PowerShell：

irm https://dropstone.io/install.ps1 | iex

或使用 CMD 安裝程式：

curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd

「The token '&&' is not a valid statement separator」

您正在 PowerShell 中嘗試執行 CMD 指令。請改用上述的 PowerShell 指令。

待處理的更新未生效

如果 dropstone update 回報成功，但 dropstone --version 仍顯示舊版本，請重新啟動您的終端機。在 Windows 上，新二進位檔會在下次啟動時替換。

如果仍然無效，請強制重新安裝：

irm https://dropstone.io/install.ps1 | iex

驗證

「Failed to sign in」

1. 再次執行 dropstone。首次啟動時，它會開啟 dropstone.io/login 進行 PKCE 登入。
2. 如果瀏覽器流程失敗，請改為貼上權杖。前往 dropstone.io/account 取得權杖，然後在登入提示中選擇「貼上權杖」。

「Session expired」

在 Dropstone 內部執行 /login 以重新整理您的憑證。

卡在錯誤的帳戶

若要切換帳戶，請在 Dropstone 內部執行 /login，然後在瀏覽器提示中選擇正確的帳戶。

更新問題

dropstone update 回報「Update Available」但沒有動作

這通常表示自動安裝程式沒有二進位檔目錄的寫入權限。請使用您原本的安裝方式重新安裝：

卡在舊版本

檢查目前安裝的版本：

dropstone --version

與 download.dropstone.io/latest.txt 的最新版本比對。如果不相符，請使用上方對應平台的指令重新安裝。

仍有問題？

如果上述方法都無法解決您的問題，請參閱更詳細的 CLI 疑難排解 頁面，或在 dropstone.io/contact 開啟問題回報，並附上：

• 您的作業系統與版本
• dropstone --version 的輸出
• 完整的錯誤訊息以及您執行的確切指令