JBang：重新定义Java单文件开发体验

30秒了解JBang

项目定位：一款让Java开发者告别繁琐配置，直接运行单文件源码的创新工具
核心优势：零构建配置、依赖自动管理、跨平台兼容
适用人群：Java初学者、教育工作者、需要快速验证想法的专业开发者

为什么Java开发需要JBang？

传统Java开发是否让你感到沮丧？每次想验证一个简单想法，都要经历创建项目、配置pom.xml、编译打包的漫长流程。JBang就像给Java装上了"快速启动器"，让你如同使用微波炉加热食物般无需预热，直接进入代码编写与运行的核心环节。

Java开发的三大痛点

• 配置门槛高：即使HelloWorld程序也需要至少3个XML配置文件
• 反馈周期长：修改代码后需重新编译打包才能看到效果
• 依赖管理繁：手动处理JAR包版本冲突耗费大量精力

JBang如何突破传统开发模式？

JBang通过创新的"注释驱动开发"模式，将所有配置信息直接嵌入Java源码。当你运行jbang hello.java时，背后发生了三件事：

1. 解析源码顶部的//DEPS注释自动下载依赖
2. 临时生成最小化的项目结构
3. 编译并执行代码，输出结果

💡 核心原理：JBang就像餐厅的"快速料理台"，提前准备好常用食材（依赖库），让你专注于烹饪（代码逻辑）而非准备工作。

实战指南：从安装到编写实用工具

需求场景：创建命令行天气查询工具

解决方案：三步实现天气查询器

1. 安装JBang

curl -Ls https://sh.jbang.dev | bash -s - app setup

执行后系统会自动配置环境变量，输入jbang --version验证安装成功。

2. 创建源码文件
   新建weather.java并输入：

//DEPS com.squareup.okhttp3:okhttp:4.9.3, com.google.code.gson:gson:2.9.1
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;

public class weather {
    public static void main(String[] args) throws Exception {
        String city = args.length > 0 ? args[0] : "beijing";
        String url = "https://wttr.in/" + city + "?format=j1";
        
        OkHttpClient client = new OkHttpClient();
        Request request = new Request.Builder().url(url).build();
        
        try (Response response = client.newCall(request).execute()) {
            JsonObject data = JsonParser.parseString(response.body().string()).getAsJsonObject();
            String temp = data.getAsJsonArray("current_condition").get(0).getAsJsonObject().get("temp_C").getAsString();
            System.out.println(city + "当前温度: " + temp + "°C");
        }
    }
}

3. 直接运行

jbang weather.java shanghai

输出结果：shanghai当前温度: 23°C

进阶优化：添加命令行参数解析

使用JBang的CLI模板增强用户体验：

jbang init --template=cli weather.java

生成的代码自动集成Picocli库，支持--city参数和帮助信息。

生态拓展：JBang的无限可能

JBang不仅仅是运行工具，更是一个不断成长的生态系统。通过jbang catalog list可以发现社区贡献的各类实用脚本，从JSON处理到AWS管理无所不包。教育领域，教师可以用它创建互动式教程；企业开发中，它能作为微服务原型的快速验证工具。

💡 效率技巧：使用jbang edit weather.java命令直接打开默认编辑器，保存后自动运行，实现"编辑-测试"无缝循环。

避坑指南：常见问题解决方案

1. 依赖冲突
   ❌ 错误：NoClassDefFoundError
   ✅ 解决：在//DEPS后添加具体版本号，如//DEPS com.google.guava:guava:31.1-jre

2. Java版本问题
   ❌ 错误：UnsupportedClassVersionError
   ✅ 解决：通过jbang --java 17 weather.java指定运行时版本

3. 网络代理设置
   ❌ 错误：依赖下载失败
   ✅ 解决：配置环境变量JBANG_PROXY=http://proxy:port

通过JBang，Java开发者终于可以享受脚本语言般的便捷，同时保留Java的强大生态。无论是日常脚本编写、教学演示还是快速原型开发，JBang都能显著提升Java开发效率，让你专注于解决问题而非配置环境。

官方文档：docs/official.adoc