Win7 環境下 R 語言安裝 RMySQL 套件完整步驟 (含 Rtools、環境變數、DBI 依賴)

在 Windows 7 上安裝 RMySQL 常因缺少編譯工具鏈 (Rtools)、環境變數未設、MySQL 函式庫路徑問題而失敗。本文提供經實測可行的完整流程。

環境準備

• R 版本：R-3.0.0 (安裝路徑 F:\Program Files\R\R-3.0.0)。
• Rtools：對應版本 Rtools30.exe (安裝路徑 F:\Rtools)，下載自 CRAN。
• 關鍵：將下列路徑加入系統環境變數 PATH (順序很重要)：
  F:\Program Files\R\R-3.0.0\bin\x64
F:\Rtools\bin
F:\Rtools\gcc-4.6.3\bin

安裝步驟

1. 開啟 R x64 3.0.0 主控台，安裝依賴套件：
   install.packages('DBI')
2. 嘗試原始碼安裝 RMySQL (會失敗，但會下載 tarball)：
   install.packages('RMySQL', type='source')
   記住下載儲存路徑 (通常在 C:\Users\用戶名\AppData\Local\Temp\Rtmp...\RMySQL_0.9-3.tar.gz)。
3. 在 R 安裝目錄 etc 資料夾建立 Renviron.site 檔案，內容：
   MYSQL_HOME="D:/Program Files/MySQL/MySQL Server 5.5"
   (路徑含空格必須雙引號括住)
4. 進入 MySQL 安裝目錄 lib 資料夾，新建 opt 子資料夾，複製 libmysql.dll 與 libmysql.lib 至 opt。
5. 再將 libmysql.dll 複製至 MySQL bin 目錄 (D:\Program Files\MySQL\MySQL Server 5.5\bin)。
6. 以管理員身分開啟 CMD，執行編譯安裝：
   R CMD INSTALL "<上述 tarball 完整路徑>/RMySQL_0.9-3.tar.gz"

常見失敗原因排查

• MySQL 路徑含空格未加雙引號 → Renviron.site 必須用雙引號。
• R 與 Rtools 的 bin 目錄未加入 PATH → 請檢查系統環境變數。
• 直接用 install.packages('RMySQL', type='source') 安裝 → 無法編譯，必須用 R CMD INSTALL 對本地 tarball 安裝。

建議：使用 RStudio 作為 IDE，整合度更高。新版 R (4.x+) 與 RMySQL 可能有不同相依性，請參考 CRAN 套件頁面最新說明。