01 / 07

安裝與驗證

四種安裝方式，結果都是同一個檔案：一個沒有執行期相依的二進位檔。

一行指令

官方安裝腳本會偵測作業系統與 CPU 架構、下載對應的發行檔，先用 SHA-256 驗證、再安裝，並在安裝目錄不在 PATH 時提醒你。

curl -fsSL https://raw.githubusercontent.com/doggy8088/mgit/main/install.sh | sh

macOS 與 Linux（POSIX sh）。

irm https://raw.githubusercontent.com/doggy8088/mgit/main/install.ps1 | iex

Windows PowerShell 5.1 與 PowerShell 7+（在 macOS、Linux 的 PowerShell 7 上也可以用）。

想先看腳本再執行？把網址直接開起來或先存成檔案即可：這兩個腳本就是倉庫裡的 install.sh 與 install.ps1，沒有另一份。

驗證安裝

安裝完之後確認版本，順便確認 PATH 找到的是你剛裝的那一個：

$ mgit --version
mgit 2.0.2

$ command -v mgit
/usr/local/bin/mgit

npm 與 npx

需要 Node.js 20 以上。套件內已經含有 6 個平台的官方二進位檔，安裝時不會執行任何程式碼（沒有 postinstall）。

npm install -g @willh/mgit

也可以用 pnpm 或 yarn；npx @willh/mgit 與 bunx @willh/mgit 可以不安裝直接執行。

手動下載並驗證

從 GitHub Releases 下載對應平台的壓縮檔。每個檔案都有對應的 .sha256，所有檢查碼也彙整在 SHA256SUMS.txt。

8 個發行目標
平台	發行檔
Linux x86_64（musl，靜態連結）	`mgit-x86_64-unknown-linux-musl.tar.gz`
Linux aarch64（musl，靜態連結）	`mgit-aarch64-unknown-linux-musl.tar.gz`
Linux x86_64（glibc）	`mgit-x86_64-unknown-linux-gnu.tar.gz`
Linux aarch64（glibc）	`mgit-aarch64-unknown-linux-gnu.tar.gz`
macOS Apple Silicon	`mgit-aarch64-apple-darwin.tar.gz`
macOS Intel	`mgit-x86_64-apple-darwin.tar.gz`
Windows x64	`mgit-x86_64-pc-windows-msvc.zip`
Windows on ARM	`mgit-aarch64-pc-windows-msvc.zip`

# macOS
shasum -a 256 -c mgit-aarch64-apple-darwin.tar.gz.sha256

# Linux
sha256sum -c mgit-x86_64-unknown-linux-musl.tar.gz.sha256

從原始碼建置

需要 Rust 1.85 或更新版本（rust-version 已宣告，CI 會驗證）。

git clone https://github.com/doggy8088/mgit.git
cd mgit
cargo build --release      # target/release/mgit
cargo install --path .     # 或安裝到 ~/.cargo/bin

升級與移除

升級就是再跑一次同一個安裝指令：腳本會覆蓋舊的二進位檔。要移除的話，刪掉那一個檔案就好，mgit 不會在其他地方留下任何東西。

用 MGIT_VERSION=2.0.1 可以指定安裝的版本。
用 MGIT_INSTALL_DIR 可以指定安裝目錄。
npm 安裝的話，npm uninstall -g @willh/mgit 即可。