GnuCash內置了「線上報價」(Finance::Quote) 功能，允許軟體自動從網路獲取股票、基金和貨幣的最新價格。

但在Windows系統上，安裝此功能時常因缺少依賴項或權限設定而導致失敗。本教程將說明完整的安裝步驟，以及如何修復常見的依賴安裝錯誤，以確保功能正常運作。

先決條件

1. 已經在Windows 上安裝了GnuCash（安裝包內含Strawberry Perl環境）。
2. 擁有電腦的管理員權限。

第1步：以管理員身份開啟PowerShell

安裝過程需要使用PowerShell操作。

1. 點擊「開始」選單。
2. 輸入PowerShell。
3. 在搜尋結果中，找到 “Windows PowerShell”。
4. 右鍵點擊它，選擇「以管理員身份執行」。
5. 開啟後應會看到標示為管理員的PowerShell視窗。

第2步：更改PowerShell執行策略

Windows預設可能會限制腳本執行。需要先為當前的PowerShell視窗解除限制。

• 在藍色窗口中，複製並貼上以下指令，然後按Enter鍵：

  Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
  

• 如出現提示，請輸入Y並按Enter鍵確認。

第3步：切換至GnuCash目錄並執行安裝

接下來執行GnuCash提供的安裝腳本。

1. 切換到GnuCash的程式目錄。複製並貼上以下指令，然後按Enter（一般來說是此路徑，但還是要確認下自己電腦內實際的安裝路徑）：

   cd "c:\Program Files (x86)\gnucash\bin"
   

2. 執行.ps1安裝腳本（注意是.ps1文件，不是.cmd）：

   .\install-fq-mods.ps1
   

第4步：處理依賴項安裝失敗的問題

執行上述腳本時，日誌中可能會出現Result: FAIL或NOT OK的錯誤訊息。這是因為Finance::Quote依賴許多Perl模組，若其中任何一個測試失敗，安裝過程就會受到影響。

即使安裝腳本最後顯示：

>> Installation succeeded <<

Press Enter to continue...

若前方的日誌中有報錯，代表並未真正安裝成功。必須手動修復這些失敗的依賴項。

例1：修復Date::Simple失敗

如果日誌顯示類似以下的錯誤：

Result: FAIL Failed 1/3 test programs. 1/233 subtests failed. gmake: *** [makefile:1034: test_dynamic] Error 1 IZUT/Date-Simple-3.03.tar.gz C:\STRAWB~1\c\bin\gmake.exe test -- NOT OK Stopping: 'install' failed for 'Date::Simple'.

這表示Date::Simple模組因測試未通過而中止安裝。

修復方法：

1. 在同一個管理員PowerShell視窗中，輸入以下指令啟動Perl的CPAN安裝環境（一般來說是此路徑，但還是要確認下自己電腦內實際的安裝路徑）：

   c:\Strawberry\perl\bin\cpan.bat
   

2. 提示符會變為cpan[1]>。
3. 輸入force install指令強制安裝該模組（跳過測試）：

   force install Date::Simple
   

4. 等待安裝完成。
5. 輸入exit並按Enter鍵，退回到PowerShell提示符。

例2：修復Module::CPANTS::Analyse失敗

修復完前一個模組後，必須重新執行安裝腳本：

.\install-fq-mods.ps1

此時可能會發現另一個模組失敗。例如：

Result: FAIL ［中略］ Stopping: 'install' failed for 'I/IS/ISHIGAKI/Module-CPANTS-Analyse-1.02.tar.gz'.

修復方法：

1. 再次啟動CPAN（一般來說是此路徑，但還是要確認下自己電腦內實際的安裝路徑）：

   c:\Strawberry\perl\bin\cpan.bat
   

2. 強制安裝這個失敗的模組：

   force install Module::CPANTS::Analyse
   

3. 安裝完成後，輸入exit退出。

重複此過程

重複上述步驟，即：

1. 執行.\install-fq-mods.ps1。
2. 檢查日誌是否有... NOT OK的錯誤。
3. 若有，進入cpan.bat使用force install [模組名]進行修復。
4. 直到最後一次執行安裝腳本（.\install-fq-mods.ps1）時，日誌顯示所有測試均為PASS和OK，並顯示：

BPSCHUCK/Finance-Quote-1.67.tar.gz C:\STRAWB~1\c\bin\gmake.exe install UNINST=1 -- OK >> Installation succeeded <<

此時才代表安裝真正成功。

第5步：驗證安裝

安裝完成後，需驗證GnuCash能否正確載入模組。

1. 關閉目前的管理員PowerShell視窗。
2. 以一般使用者身份開啟一個新的「命令提示字元」 (CMD) 視窗。
3. 輸入以下指令進行測試（一般來說是此路徑，但還是要確認下自己電腦內實際的安裝路徑）：

   "c:\Program Files (x86)\gnucash\bin\gnucash-cli.exe" --quotes info
   

4. 判斷結果：
   • 如果出現Failed to initialize... missing_modules，表示安裝仍未成功，需回頭檢查依賴項。
   • 如果出現一條警告（WARN），如下所示，則代表安裝成功：

   * 20:09:31  WARN <gnc.price-quotes> [GncFQQuoteSource::set_api_key()] No Alpha Vantage API key set...
   

此Alpha Vantage API key警告屬於正常現象，僅提示未設定特定數據源的API金鑰，但證明GnuCash已成功載入Finance::Quote模組。

總結

1. 開啟GnuCash。
2. 進入工具 (Tools) -> 證券編輯器 (Security Editor)。
3. 選擇一個證券（如股票），點擊「編輯」。
4. 勾選「獲取在線報價(G)」。
5. 此時原本顯示「Finance::Quote 未正確安裝」的警告訊息應已消失。

注意，Finance::Quote適用於獲取股票和主要貨幣匯率，但通常無法自動獲取——比方說中國的場外基金淨值等。對於此類基金，大概還是得定期前往 工具 -> 價格編輯器 (Price Editor) 手動更新淨值。