JAR程序如何读写外部文件？分发应用是否该用JAR？（Maven项目）

一、JAR包外部文件的读写实现 #

打包成JAR后，不能再依赖src目录下的相对路径操作文件，核心思路是基于当前工作目录或用户指定路径来处理外部文件：

1. 获取当前工作目录 #

用System.getProperty("user.dir")获取JAR运行时的当前工作目录，所有外部文件操作都基于这个路径构建：

// 获取JAR所在的当前工作目录
String workingDir = System.getProperty("user.dir");
// 拼接目标文件路径，比如保存tilemap的文件
File tilemapFile = new File(workingDir + File.separator + "my_tilemap.tmx");

2. 读写文件示例 #

保存文件

try (FileWriter writer = new FileWriter(tilemapFile)) {
    // 写入tilemap的具体数据（比如XML格式内容）
    writer.write(tilemapXmlContent);
    System.out.println("文件已保存至：" + tilemapFile.getAbsolutePath());
} catch (IOException e) {
    e.printStackTrace();
    // 这里可以给用户弹窗提示保存失败
}

读取文件

try (BufferedReader reader = new BufferedReader(new FileReader(tilemapFile))) {
    String line;
    StringBuilder content = new StringBuilder();
    while ((line = reader.readLine()) != null) {
        content.append(line);
    }
    // 解析读取到的tilemap内容
} catch (IOException e) {
    e.printStackTrace();
    // 提示用户文件不存在或读取失败
}

3. 更友好的交互：让用户选择文件路径 #

如果不想固定在工作目录，可使用JFileChooser让用户手动选择保存/读取路径，彻底规避路径问题：

JFileChooser fileChooser = new JFileChooser();
fileChooser.setSelectedFile(new File("my_tilemap.tmx"));
int result = fileChooser.showSaveDialog(null);
if (result == JFileChooser.APPROVE_OPTION) {
    File selectedFile = fileChooser.getSelectedFile();
    // 执行保存操作
}

二、应用分发的选择：JAR还是其他方式 #

1. 用JAR分发的优势与注意事项 #

• 优势：跨平台（只要用户安装Java）、体积小巧、打包流程简单。
• 关键注意点：必须打包成可执行JAR，否则用户需要通过命令行运行。用Maven的maven-shade-plugin可将所有依赖打包进单个JAR，配置示例：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.4.1</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <!-- 替换为你的程序入口主类 -->
                                <mainClass>com.yourpackage.TilemapEditorMain</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

2. 更友好的分发方式（面向普通用户） #

如果面向不懂Java的普通用户，可使用工具生成原生安装包：

• jpackage：Java 14+自带工具，可生成Windows exe、Mac dmg、Linux deb/rpm，把JRE和应用打包在一起，用户无需单独安装Java。
• Launch4j：将JAR转换为Windows exe，支持自定义图标、启动参数。
• Packr：跨平台打包工具，可生成各系统的原生程序包。

这类方式配置稍复杂，但用户体验更流畅，适合正式分发场景。

内容的提问来源于stack exchange，提问作者Clafted