VoiceInk 沒反應:官方文件給的修正方法,依序檢查

VoiceInk 停止運作時,它的文件說,原因幾乎都是這五項之一:缺少 macOS 權限、麥克風選錯、Mode 使用了你沒料到的設定、本機模型對這台 Mac 來說太慢,或是你輸入文字的那個 App 有貼上時機的問題。請依這個順序檢查。大部分的修正只要一分鐘。

我做的是另一款聽寫 App YapToText,而且我自己沒有用過 VoiceInk。下面每一個步驟都來自 VoiceInk 的文件,我在 2026年10月9日閱讀。

在 Mac App Store 下載 YapToText免費下載。不需要帳號,沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

步驟

  1. 在「系統設定」裡檢查 <span lang="en">Microphone</span> 和「輔助使用」權限,然後重新啟動 VoiceInk。
  2. 在 VoiceInk 的 <span lang="en">Audio</span> 畫面選對麥克風。
  3. 檢查目前的 <span lang="en">Mode</span> 有模型、正確的語言,而且輸出是 <span lang="en">Paste</span>。
  4. 如果貼上的是舊文字,在 <span lang="en">Settings</span>,<span lang="en">Pasting</span> 裡調高 <span lang="en">Restore Delay</span>。

有錄音,但沒有文字出現

  • 權限。 在「系統設定」的「隱私權與安全性」裡,VoiceInk 需要 Microphone 才能錄音,需要「輔助使用」才能貼上。只有 Mode 用到畫面情境時,才需要 Screen Recording。更改任何設定之後,都要重新啟動 VoiceInk。
  • 麥克風。 打開 VoiceInk 側邊欄的 Audio,選對裝置或設定優先順序,插上新的麥克風之後要按 Refresh Microphones。在「系統設定」的「聲音」,「輸入」裡,你說話時音量條應該會跳動。
  • 目前使用的 Mode。 在 Modes 裡檢查這個 Mode 是否已啟用,有沒有可用的轉寫模型、正確的語言,而且輸出是 Paste。Respond 和 Custom Command 是刻意把文字送到別的地方。
  • 模型。 在 AI Models 裡,本機模型必須已經下載,雲端供應商則需要可用的 API 金鑰。

如果在 History 看得到文字,但你的 App 裡沒有,問題就出在貼上,而不是聽不到。

有轉寫,但貼上了錯誤的內容或什麼都沒貼

VoiceInk 的貼上方式,是把文字放進剪貼板,再替你按下 Command V。文件依序給出這些修正方法:

  • 先按一下文字欄位。 貼上的內容會送到目前取得焦點的地方。
  • 出現舊的剪貼板文字。 在 Settings,Pasting 裡,讓 Keep Clipboard Content 保持開啟,並調高 Restore Delay。預設值是 2 秒,最高可以到 5 秒。
  • 你的剪貼板內容一直消失。 是 Keep Clipboard Content 關閉了。請把它開啟。
  • 還是沒有東西。 把 Paste Method 從 Default 改成 AppleScript,文件也建議自訂鍵盤配置的人這樣做。

速度很慢

  • 改用比較快的本機模型。 文件建議用 Parakeet V3 或 V2 做快速的本機聽寫,如果大型模型很吃力,就改用較小的 Whisper 模型。
  • Intel Mac。 本機模型通常在 Apple 晶片上跑得比較好。在 Intel 上,文件建議使用雲端轉寫供應商。
  • 逐字稿很快,結果很慢。 這是 AI 強化的步驟。純聽寫的 Mode 請把它關掉,或是開啟 Skip short transcriptions。
  • 找出慢在哪一個階段。 Dashboard,View Insights,Model Performance 會比較各個模型,History,Analyze 則會計算每段錄音花的時間。

重複的字詞、憑空出現的文字,或語言不對

  • Voice Activity Detection。 在 AI Models、齒輪按鈕、Transcription 裡把它開啟。它能幫本機模型忽略靜音。
  • 換一個模型。 試試 Parakeet,如果較大的 Whisper 模型產生過多內容,就試 Whisper Base 或 Tiny。
  • 重試。 更改設定後,在 Settings,Shortcuts 裡按 Retry Last Transcription,會用同一段音訊重新轉寫。
  • 語言一直改變。 語言是依每個 Mode 設定的,而 Mode 可以依 App、網站或預設值自動切換。請確認目前是哪一個 Mode。

如果你現在就想要一個直接能用的

YapToText 是適用於 macOS 14 或以上版本、搭載 Apple 晶片 Mac 的免費聽寫 App,可能出錯的設定少得多。 沒有依 App 切換的 Mode,沒有雲端金鑰,也沒有需要調整的剪貼板延遲。

  • 一個鍵。 輕按 Right Command,說話,再輕按一次。文字就會出現在游標的位置。
  • 兩個模型都內建。 App Store 版本附帶語音辨識模型和文字整理模型,所以不必先下載任何東西。
  • 選項比較少。 它只有一個語音模型系列 Whisper,沒有 VoiceInk 的 Assistant Mode、自訂指令或雲端供應商。

在 Mac App Store 下載 YapToText免費下載。不需要帳號,沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

VoiceInk 替代方案頁面比較了這兩款,Mac 聽寫疑難排解指南則介紹 Apple 自己的聽寫。

重點整理

  • 沒有文字。 檢查 Microphone 和「輔助使用」權限、選取的麥克風,以及目前的 Mode。
  • 貼上的內容不對。 調高 Restore Delay,或把 Paste Method 改成 AppleScript。
  • 很慢。 使用 Parakeet,在 Intel 上使用雲端,或關閉 AI 強化。
  • 還是卡住。 VoiceInk 的支援團隊會要你提供 Settings,Diagnostics,Export Logs。

如果 VoiceInk 的文件有變動,而這裡的某個步驟已經不符,請在 GitHub 上提交 issue(英文)。每一則我都會看。

在 Mac App Store 下載 YapToText免費下載。不需要帳號,沒有鎖住的功能。需要搭載 Apple 晶片的 Mac 和 macOS 14 或以上版本。 原始碼在 GitHub 上。

關於作者。 Ryleigh Newman 從事軟體開發,用手打字有困難,每天都用本站介紹的 YapToText 聽寫。本頁譯自英文。App 的介面和網站的其他頁面是英文的。 進一步瞭解這個專案(英文)。

指南

更多指南(英文)

資料來源

常見問題

VoiceInk 為什麼什麼都沒輸入?

通常是缺少「輔助使用」權限、Mode 的輸出不是 Paste,或是焦點不在文字欄位。它的文件說要先檢查這些,再檢查麥克風和模型。

VoiceInk 為什麼貼上了我舊的剪貼板內容?

因為在 App 貼上完成之前,剪貼板就已經還原了。在 Settings,Pasting 裡,讓 Keep Clipboard Content 保持開啟,並把 Restore Delay 從預設的 2 秒調高。

VoiceInk 為什麼這麼慢?

通常是用了大型的本機模型、用的是 Intel Mac,或是 AI 強化的步驟。它的文件建議本機使用 Parakeet V3 或 V2,Intel 上使用雲端轉寫,純聽寫則關閉強化。

VoiceInk 為什麼一直改變語言?

語言是依每個 Mode 設定的,而 Mode 可以依 App、網站或預設值自動切換。請檢查目前的 Mode,以及哪一個 Mode 被標示為預設。

有比 VoiceInk 更簡單的免費替代方案嗎?

YapToText 在 macOS 14 或以上版本、搭載 Apple 晶片的 Mac 上免費,只有一個聽寫鍵,模型也已經內建在 App Store 版本裡。