Spring Boot+Maven项目含TXT文件的跨环境运行与Git共享解决方案咨询

嗨，别担心这绝对不是傻问题！刚入门编程时遇到路径相关的坑太正常了，我来帮你理清怎么解决这个问题，让你的项目在自己和朋友的机器上都能正常运行～

为什么你的代码本地能用，朋友那边却找不到文件？ #

你现在用的是src\main\resources\List.txt这种本地文件系统的相对路径，但这里有两个核心问题：

1. 不同操作系统的路径分隔符不一样（Windows用反斜杠\，Linux/macOS用正斜杠/），跨机器运行时路径会失效；
2. 当Maven项目打包成jar包后，resources目录下的文件会被嵌入到jar内部，不再是单独的磁盘文件，这时FileReader根本找不到这个路径。
   另外还要确认你有没有把List.txt正确提交到Git仓库，如果.gitignore里不小心忽略了这个文件，朋友拉取代码时自然拿不到它。

正确的解决方案：通过Classpath读取资源文件 #

Spring Boot和Maven项目中，resources目录下的文件会被自动加入到项目的classpath中，所以我们应该通过classpath来访问这些文件，而不是依赖本地路径。这里有两种可靠的方式：

方式1：用ClassPathResource（兼顾开发环境和打包后运行）

try {
    // 直接写文件名即可，因为resources是classpath的根目录之一
    ClassPathResource resource = new ClassPathResource("List.txt");
    // 开发时指向本地的src/main/resources/List.txt，打包后指向jar内的资源
    try (CSVReader csvReader = new CSVReader(new FileReader(resource.getFile()))) {
        String[] nextRecord;
        csvReader.readNext();
        while ((nextRecord = csvReader.readNext()) != null) {
            // 你的原有解析逻辑，和之前一致
            try {
                Long id = Long.parseLong(nextRecord[0].trim());
                String nome = nextRecord[1].trim();
                String tipo = nextRecord[2].trim();
                int hp = Integer.parseInt(nextRecord[3].trim());
                int attacco = Integer.parseInt(nextRecord[4].trim());
                int difesa = Integer.parseInt(nextRecord[5].trim());
                int velocità = Integer.parseInt(nextRecord[6].trim());

                Pokemon pokemon = new Pokemon(id, nome, tipo, hp, attacco, difesa, velocità);
                pokemonList.add(pokemon);

            } catch (NumberFormatException e) {
                System.out.println("Errore nel parsing dei dati per la riga: " + String.join(",", nextRecord));
                e.printStackTrace();
            }
        }
    }
} catch (IOException e) {
    e.printStackTrace();
}

方式2：用getResourceAsStream（更适合jar包运行场景）

如果你的项目最终要打包成jar运行，用流的方式读取更稳妥——因为jar内的资源无法直接用File对象访问：

try (InputStream is = getClass().getResourceAsStream("/List.txt");
     // 用InputStreamReader包装输入流，适配CSVReader的要求
     CSVReader csvReader = new CSVReader(new InputStreamReader(is))) {
    String[] nextRecord;
    csvReader.readNext();
    while ((nextRecord = csvReader.readNext()) != null) {
        // 你的原有解析逻辑
        try {
            Long id = Long.parseLong(nextRecord[0].trim());
            String nome = nextRecord[1].trim();
            String tipo = nextRecord[2].trim();
            int hp = Integer.parseInt(nextRecord[3].trim());
            int attacco = Integer.parseInt(nextRecord[4].trim());
            int difesa = Integer.parseInt(nextRecord[5].trim());
            int velocità = Integer.parseInt(nextRecord[6].trim());

            Pokemon pokemon = new Pokemon(id, nome, tipo, hp, attacco, difesa, velocità);
            pokemonList.add(pokemon);

        } catch (NumberFormatException e) {
            System.out.println("Errore nel parsing dei dati per la riga: " + String.join(",", nextRecord));
            e.printStackTrace();
        }
    }
} catch (IOException e) {
    e.printStackTrace();
}

额外的注意事项 #

• Git提交检查：打开你的.gitignore文件，确保没有忽略.txt或者resources目录下的文件，把List.txt正常提交到Git仓库，这样朋友拉取代码时就能获取到这个文件。
• Maven资源配置：默认情况下Maven会自动把src/main/resources下的文件复制到编译后的target/classes目录，打包时也会包含到jar里。如果你的pom.xml有自定义的资源配置，要确保包含**/*.txt，比如：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.txt</include>
                <include>**/*.properties</include>
            </includes>
        </resource>
    </resources>
</build>

• 本地测试打包：自己先执行mvn clean package打包成jar，然后用java -jar your-project-name.jar运行，确认文件能正常读取，这样就能提前排除问题啦。

备注：内容来源于stack exchange，提问作者Garrett