# 安裝

Canonical: https://specscore.md/zh-tw/cli/install/

[SpecScore CLI](/zh-tw/cli/)

# 安裝

選擇適合你的方式。所有選項安裝的都是來自同一個[GitHub 發布](https://github.com/specscore/specscore-cli/releases)的同一個`specscore` 二進位檔案。

## 快速安裝（macOS 和 Linux）

```
$ curl -fsSL https://specscore.md/install/get-cli | sh
```

指令稿自動偵測作業系統和架構，從 GitHub 最新發布中下載對應的壓縮檔， 驗證 SHA-256 總和檢查碼，然後將 `specscore` 二進位檔案安裝到`/usr/local/bin`（如果 `/usr/local/bin`不可寫入則安裝到 `~/.local/bin`）。

### 參數

 環境變數 預設值 描述 SPECSCORE_VERSION latest 發布標籤，例如 v0.1.0 。 SPECSCORE_INSTALL_DIR /usr/local/bin 或 ~/.local/bin 安裝二進位檔案的目錄。

安裝指定版本到 `~/.local/bin`：

```
$ curl -fsSL https://specscore.md/install/get-cli | \ SPECSCORE_VERSION=v0.1.0 SPECSCORE_INSTALL_DIR="$HOME/.local/bin" sh
```

### 執行前檢查指令稿

如果你希望在執行前審查指令稿：

```
$ curl -fsSL https://specscore.md/install/get-cli -o get-cli.sh $ less get-cli.sh $ sh get-cli.sh
```

## Homebrew（macOS 和 Linux）

```
$ brew install specscore/tap/specscore
```

首次安裝時新增 `specscore/homebrew-tap` tap， 後續透過該 tap 追蹤新版本。

## Windows

三種方式任選其一——都安裝來自同一個 GitHub 發布的同一個二進位檔案。

### PowerShell

```
PS> powershell -c "irm https://specscore.md/install/get-cli.ps1 | iex"
```

指令稿偵測架構，從最新發布中下載對應的 `.zip`， 驗證 SHA-256 總和檢查碼，將 `specscore.exe` 安裝到`%LOCALAPPDATA%\Programs\specscore\bin` 並將該目錄 新增到使用者 `PATH`。不需要系統管理員權限。安裝後請開啟新的終端機， 以使更新的 `PATH` 生效。

### WinGet

```
PS> winget install Synchestra.SpecScore
```

### Scoop

```
PS> scoop bucket add specscore https://github.com/specscore/scoop-bucket PS> scoop install specscore
```

## 手動安裝

- 從[GitHub 發布頁面](https://github.com/specscore/specscore-cli/releases)下載適合你平台的壓縮檔。 壓縮檔命名格式為 `specscore_ _ _ . `。
- 根據同一發布中的`specscore_ _checksums.txt` 檔案驗證 SHA-256 總和檢查碼。
- 解壓縮並將 `specscore`（Windows 上為 `specscore.exe`） 移動到 `PATH` 中的目錄。

## 從原始碼構建

```
$ go install github.com/specscore/specscore-cli/cmd/specscore@main
```

需要 [Go](https://go.dev/) 1.26 或更高版本。 安裝 `main` 分支的最新開發組建——可能包含尚未納入 正式發布標籤的變更。

要鎖定特定版本，將 `@main` 替換為標籤（如 `@v0.4.2`）， 或使用 `@latest` 取得最新的正式發布。

## 驗證安裝

```
$ specscore version specscore 0.1.0 ( )
```