NetBeans 整合 JRuby 開發完整指南：從專案建立到測試部署

前言

JRuby 是 Ruby 語言在 JVM 上的完整實作，結合 Ruby 簡潔優雅的語法與 Java 生態系的強大函式庫。NetBeans IDE 內建支援 JRuby 專案開發，本文將手把手教學如何在 NetBeans 中建立、編譯、測試 JRuby 專案。

前置需求

• NetBeans 6.0 或更新版本
• JRuby 原始碼（建議 0.9.8 版以上）
• Ant 1.6.5+（JRuby 專案建置需求）

環境準備

1. 下載 JRuby 原始碼：https://dist.codehaus.org/jruby/jruby-src-0.9.8.tar.gz
2. 解壓縮至目錄 <jruby_src_root>
3. 關鍵步驟：將 <jruby_src_root>/lib/ant.jar 替換為 Ant 1.6.5+ 版本，否則建置會失敗並提示 "The existing ant.jar is an old 1.5 version."

在 NetBeans 中建立 JRuby 專案

步驟 1：新增專案

選單 File → New Project，類別選擇 Java Project with Existing Ant Script。

步驟 2：指定專案位置

• 專案資料夾：C:\tmp\jruby-0.9.8（依實際解壓路徑調整）
• Build Script：指向專案根目錄下的 build.xml

步驟 3：設定建置動作

步驟 4：設定來源封包

• Source Package Folders：<jruby_src_root>/src
• Test Package Folders：<jruby_src_root>/test

步驟 5：設定類別路徑

• 將 <jruby_src_root>/lib 下所有 .jar 加入 Java Sources Classpath
• Test 封包額外加入：bsf.jar、junit.jar 及 src 資料夾

編譯 JRuby 專案

在專案視窗右鍵點選專案 → Build Project 或 Clean and Build Project。輸出視窗顯示 BUILD SUCCESSFUL 即表示成功產出 jruby.jar。

執行測試

專案視窗右鍵 → Test Project，或按 Alt+F6。NetBeans 會透過 Ant 執行 JRuby 內建的 JUnit 測試套件。

常見問題排除

結語

透過 NetBeans 整合 JRuby 開發，開發者可同時享有：Ruby 的動態語言生產力、Java 平台的企業級函式庫、NetBeans 的視覺化除錯與專案管理。此架構特別適合：既有 Java 系統導入腳本化擴充、快速原型開發、測試腳本撰寫等情境。