官方下載來源
Eclipse 專案導入步驟
方法一:Maven 專案 (推薦)
<!-- pom.xml -->
<dependency>
<groupId>org.json</groupId>
<artifactId>json</artifactId>
<version>20231013</version>
</dependency>
右鍵專案 → Maven → Update Project 自動下載至 Maven Dependencies。
方法二:普通 Java 專案 (手動導入)
- 下載
json-20231013.jar
- 專案根目錄建立
lib 資料夾,放入 JAR
- Eclipse 中右鍵 JAR →
Build Path → Add to Build Path
- 確認
Project → Properties → Java Build Path → Libraries 包含該 JAR
- (可選) 專案匯出時勾選
Runnable JAR → Package required libraries into generated JAR
方法三:Gradle 專案
// build.gradle
dependencies {
implementation 'org.json:json:20231013'
}
常用 JSON 處理庫對比 (若 org.json 功能不足)
| 庫 | Maven 坐標 | 特點 |
| Jackson | com.fasterxml.jackson.core:jackson-databind | 效能最強、功能最全、Spring Boot 預設 |
| Gson | com.google.code.gson:gson | API 簡潔、Google 維護、Android 常用 |
| Fastjson | com.alibaba:fastjson2 | 國產、速度快、近期有安全漏洞需升級 |
| org.json | org.json:json | 輕量、標準 API、無依賴、功能基礎 |
org.json 基本用法範例
import org.json.JSONObject;
import org.json.JSONArray;
public class JsonDemo {
public static void main(String[] args) {
// 建立 JSON 物件
JSONObject obj = new JSONObject();
obj.put("name", "張三");
obj.put("age", 25);
obj.put("skills", new JSONArray().put("Java").put("Python"));
// 序列化
String jsonStr = obj.toString(4); // 縮排 4 空格
System.out.println(jsonStr);
// 反序列化
JSONObject parsed = new JSONObject(jsonStr);
String name = parsed.getString("name");
int age = parsed.getInt("age");
JSONArray skills = parsed.getJSONArray("skills");
System.out.println("Name: " + name);
System.out.println("Skills: " + skills.toString());
}
}
常見問題
| 問題 | 解決 |
| ClassNotFoundException: org.json.JSONObject | JAR 未加入 Build Path、或執行時 Classpath 缺失 (檢查部署組件) |
| JSONException: 無法解析 | 輸入字串非合法 JSON、編碼問題、特殊字元未轉義 |
| 版本衝突 | 多模組專案統一版本、排除傳遞依賴 |