Wispr Flow 搭配 Cursor 與 VS Code：變數辨識、檔案標記，以及貼進終端機

作者 · 發佈於

Wispr Flow 在 Mac 和 Windows 上有兩項給程式碼編輯器用的功能，它的設定把這兩項歸在 Vibe coding 底下。變數辨識會讀取編輯器裡看得到的名稱，所以你說 user ID，輸出可能是 userId。檔案標記則會把你說出的檔名，變成 AI 聊天面板裡的 @ 標記。兩項功能都有容易忽略的條件，而且第一項要靠編輯器裡的設定，而不是 Flow 裡的設定。

我做了另一款 Mac 語音輸入 App，叫 YapToText，所以請在閱讀我對 Wispr Flow 的說明時把這一點考慮進去。這裡關於 Wispr Flow 的每項事實，都來自它自己的說明中心，我在 2026年10月10日查閱。

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

用其他語言閱讀： English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文

哪項功能在哪裡能用

出自 Wispr Flow 的說明文章 Use Flow with Cursor, VS Code, and other IDEs，2026年10月10日查閱。在 Mac 上，Flow 需要輔助使用權限才能讀取編輯器。

功能能用的地方
變數辨識Mac 和 Windows 上的 Cursor 和標準版 VS Code，以及 Wispr 列出的另一個 AI 編輯器
檔案標記Cursor 的 AI 聊天面板，以及那個另一個編輯器。VS Code 不行
兩項都不支援VS Code Insiders

開啟變數辨識

  1. 在 Flow 裡打開 Settings（設定）、Vibe coding，在 Variable recognition 旁邊選擇 Set up，就能看到操作說明。
  2. 在編輯器裡打開 Command Palette（命令面板）：Mac 上按 Command Shift P，Windows 上按 Control Shift P。
  3. 執行 Toggle Screen Reader Accessibility Mode。再執行一次就會關閉。
  4. 確認編輯器的狀態列顯示 Screen Reader Optimized。
  5. 讓檔案保持開啟，然後聽寫一句帶有可見變數名稱或函式名稱的話。

Flow 裡沒有這項功能的開關：只有編輯器處於 Screen Reader Optimized 模式時，它才會運作。不在畫面上的名稱、預留位置文字和非常大的檔案可能會被略過，而且高度客製化的編輯器可能讓 Flow 偵測不到這個模式。說明中心表示，在 Windows 上辨識效果可能比較弱。

用語音標記檔案

  1. 把檔案開在分頁裡，或讓它顯示在側邊欄。
  2. 按一下支援 @ 自動完成的 AI 聊天輸入框。
  3. 說出含副檔名的完整檔名，或在主檔名前面說 tag、at 或 @。
  • 說明中心的範例。 說 Check index dot ts for errors（檢查 index.ts 有沒有錯誤），會標記 index.ts。說 Explain this code, tag my python script（解釋這段程式碼，標記我的 Python 腳本），會標記 my_python_script.py。
  • 名稱需要有一個點。 沒有點的檔名無法標記。如果是 .env，要在名稱前面說 dot。
  • 字典項目會讓它失效。 一段聽寫裡只要有任何字典或片語取代，那整段聽寫的標記功能就會關閉。
  • 沒有符合的檔案，就不做更動。 如果沒有任何符合的項目，聽寫會原樣貼上，包括觸發字詞。
  • 終端機裡不行。 在 Flow 認為是終端機的地方，它會略過標記。

貼進編輯器和它的終端機

按一下輸入欄位，按住快速鍵（Mac 上是 Fn，Windows 上是 Control Windows），說話，放開，然後等整段貼上完成再打字。在 Windows 上，支援的編輯器和它們內建的終端機裡，Flow 是用 Shift Insert 貼上，而不是 Control V，而且這一點無法更改。如果有文字不見了，可以用 Paste last transcript（貼上上一則逐字稿），在 Mac 上是 Command Control V，在 Windows 上是 Shift Alt Z，也可以先拷貝文字，再用終端機自己的貼上，有些終端機是 Control Shift V。其他情況請見 Wispr Flow 無法貼上頁面。

辨識或標記沒有作用時

  • 檢查條件。 編輯器要對、Mac 上要有輔助使用權限、變數辨識要開啟 Screen Reader Optimized、檔案要看得到、標記要在聊天輸入框裡進行。
  • 關掉用不到的分頁。 如果覺得讀取編輯器很慢，說明中心建議這麼做。
  • 兩邊都重新啟動。 結束後再重新打開 Flow 和編輯器，然後再聽寫一次看得到的名稱。

改用 YapToText 寫程式

Wispr Flow 的內容出自它的說明中心，2026年10月10日查閱。YapToText 的內容出自它自己的設定。

Wispr FlowYapToText
讀取編輯器裡的名稱變數辨識，搭配 Screen Reader Optimized 模式沒有。改用字典來教它名稱
在 AI 聊天裡標記檔案有，在 Cursor 和另一個編輯器沒有
程式碼的格式這篇文章沒有談到Auto 模式在 VS Code、Cursor、Xcode 和其他編輯器裡會偏向 Code Comment
終端機會貼上，但略過標記在 Terminal、iTerm2、Warp、Ghostty 等終端機裡，Insert adjustments 會自動關閉
網際網路需要不需要

程式碼裡的名稱，YapToText 的字典是比較接近的工具：它每次都會把 swift ui 變成 SwiftUI，而且字典裡的字詞也會引導語音模型。Wispr 的這兩項編輯器功能，YapToText 沒有對應的功能。各個編輯器的做法，請見 在 Cursor 裡聽寫、在 VS Code 裡聽寫和寫程式的聽寫。

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

重點整理

  • 變數。 在編輯器裡開啟 Screen Reader Optimized 模式。
  • 檔案標記。 在 AI 聊天面板裡說出含副檔名的檔名。
  • VS Code 不行。 檔案標記在 Cursor 能用，在 VS Code 不行。
  • Windows 貼上。 編輯器裡是 Shift Insert，貼上上一則逐字稿是 Shift Alt Z。
  • 字典項目。 它們會讓那一段聽寫的標記功能失效。

如果 Wispr 改了這些功能，請到 GitHub 上提交 issue（英文），我會更新這一頁。每一則我都會看。

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

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

指南

更多指南（英文）

資料來源

常見問題

Wispr Flow 可以在 Cursor 裡用嗎？

可以，在 Mac 和 Windows 上都行。Cursor 支援變數辨識，也支援在它的 AI 聊天面板裡標記檔案。

Wispr Flow 為什麼辨識不出我的變數名稱？

變數辨識只有在編輯器處於 Screen Reader Optimized 模式時才會運作。請從 Command Palette 執行 Toggle Screen Reader Accessibility Mode。

Wispr Flow 可以在 VS Code 裡標記檔案嗎？

不行。它的說明中心表示，標準版 VS Code 支援變數辨識，但不支援檔案標記。

怎麼用 Wispr Flow 標記檔案？

在 Cursor 的 AI 聊天輸入框裡，說出含副檔名的完整檔名，或在主檔名前面說 tag。檔案必須是開啟的，或是看得到的。

Wispr Flow 在 Windows 的 VS Code 裡為什麼用 Shift Insert 貼上？

在 Windows 上支援的編輯器裡，Flow 是用 Shift Insert 而不是 Control V 貼上，而且沒有設定可以更改。