YFWu's Notes

macOS 使用 FUSE-T 與 ntfs-3g 讀寫 NTFS 硬碟

使用 FUSE-T + ntfs-3g 讀寫 NTFS。以下 DataDrive 與 diskNsM 均為範例，請替換成實際卷宗名稱與分割區代號。

1. 安裝 FUSE-T

安裝 FUSE-T，或執行：

brew install macos-fuse-t/homebrew-cask/fuse-t

本次使用 FUSE-T 1.2.7、Apple Silicon 與 backend=nfs，不需要啟用 FSKit Modules。

2. 編譯相容的 ntfs-3g

安裝建置工具（已有 Command Line Tools 可略過第一行）：

xcode-select --install
brew install autoconf automake libtool pkgconf libgcrypt

使用下列相容分支與固定版本；建置目錄必須尚未使用：

(
set -e
BUILD_DIR="$HOME/Builds/ntfs-fuse"
INSTALL_DIR="$HOME/.local/share/ntfs-fuse"
mkdir -p "$BUILD_DIR/pkgconfig"
git clone https://github.com/macos-fuse-t/ntfs-3g.git "$BUILD_DIR/source"
cd "$BUILD_DIR/source"
git checkout --detach f0e5cb0274e30334dd03aefb4fd5a14c239e6756

cp /usr/local/lib/pkgconfig/fuse-t.pc "$BUILD_DIR/pkgconfig/fuse.pc"
export ACLOCAL_PATH="$(brew --prefix)/share/aclocal"
export PKG_CONFIG_PATH="$BUILD_DIR/pkgconfig:/usr/local/lib/pkgconfig"
export CPPFLAGS='-I/usr/local/include/fuse'
export LDFLAGS='-L/usr/local/lib -Wl,-rpath,/usr/local/lib'
export MACOSX_DEPLOYMENT_TARGET=12.0

./autogen.sh
./configure --prefix=/usr/local --with-fuse=external \
  --disable-crypto --disable-library \
  --disable-mount-helper --disable-ldconfig
make -j4
make install DESTDIR="$INSTALL_DIR" rootbindir=/bin rootsbindir=/sbin
for tool in ntfs-3g ntfs-3g.probe ntfscat; do
  codesign --force --sign - "$INSTALL_DIR/bin/$tool"
done
)

3. 確認磁碟並卸載原有掛載

diskutil list external physical
diskutil info /dev/diskNsM

核對名稱、NTFS 格式、容量與 UUID。替換正確裝置編號，不格式化磁碟。

若已掛載，先卸載：

diskutil unmount /dev/diskNsM

若卸載失敗，先關閉檔案與傳輸再重試，不強制卸載。

4. 以讀寫模式掛載並開啟 Finder

在一般使用者的 Terminal 執行；掛載目錄須為空，且未被其他卷宗占用：

NTFS_BIN="$HOME/.local/share/ntfs-fuse/bin"

# 探測失敗就停止，不繼續掛載
sudo "$NTFS_BIN/ntfs-3g.probe" --readwrite /dev/diskNsM &&
sudo mkdir -p /Volumes/DataDrive &&
sudo "$NTFS_BIN/ntfs-3g" /dev/diskNsM /Volumes/DataDrive \
  -o "backend=nfs,volname=DataDrive,rw,noatime,uid=$(id -u),gid=$(id -g)" &&
open -a Finder /Volumes/DataDrive

5. 檢查讀寫與卸載

先確認掛載來源及選項：

mount | grep -F ' on /Volumes/DataDrive ('

確認來源為 fuse-t:/DataDrive、包含 nfs，且沒有 read-only。

在 Finder 建立臨時文字檔，確認能修改、重新命名與刪除。

本次亦完成寫入雜湊、中文改名、卸載後直接讀取與重掛驗證。

使用完畢後卸載：

diskutil unmount /Volumes/DataDrive

拔線前，確認其他分割區也未使用，再透過 macOS 退出整顆硬碟。

常見問題

  • Operation not permitted：若 NFS 已掛載，檢查「隱私權與安全性 → 檔案與檔案夾 → Terminal → 網路卷宗」。官方說明
  • 讀寫探測失敗：停止操作，不自動修復或清除 Windows 休眠資訊。NTFS-3G 手冊
  • 完全偵測不到硬碟：先檢查 USB 連線與供電，恢復辨識後重新核對裝置編號。
  • macOS
  • NTFS
  • filesystem