VSCode中Eclipse Java项目如何使用相对路径添加引用JAR库

问题解答 #

1. 基于项目根目录相对路径添加引用库的方法
   如果是Eclipse托管项目，直接在.classpath文件中添加类路径条目即可，path属性填写相对项目根目录的路径即可，示例：

<classpathentry kind="lib" path="lib/xxx.jar"/>

如果是非构建系统的裸Java项目，在.vscode/settings.json的java.project.referencedLibraries配置项中填写相对路径即可，相对路径默认以项目根目录为基准。

2. .classpath和settings.json配置的区别与优先级

• 区别：.classpath是Eclipse生态的标准项目配置文件，用于统一管理Eclipse项目的类路径配置；settings.json中的java.project.referencedLibraries是VSCode Java插件独有的配置项，仅适用于无Maven/Gradle/Eclipse等构建系统托管的裸Java项目。
• 优先级：当VSCode Java插件识别到项目中存在.classpath和.project文件（即Eclipse结构项目）时，会优先读取.classpath的配置，完全忽略settings.json中的类路径配置，这也是你之前通过VSCode UI添加库不生效的核心原因。

3. 批量添加整个文件夹下的JAR文件

• 如果要适配Eclipse的配置逻辑，直接在Eclipse中右键选中lib文件夹，选择Configure Build Path -> Add to Build Path，Eclipse会自动将文件夹下所有JAR文件的类路径条目写入.classpath，不需要手动逐个添加。
• Eclipse 3.5及以上版本支持通配符配置，可直接在.classpath中添加如下条目，一次性引入lib目录下的所有JAR：

<classpathentry kind="lib" path="lib/*"/>

4. .classpath、.project文件默认隐藏的原因
   VSCode文件资源管理器默认会隐藏以.开头的类Unix隐藏文件，同时Windows系统下这两个文件也默认被标记为隐藏属性。你可以点击资源管理器顶部的三个点按钮，勾选「显示隐藏文件」即可看到，也可以在VSCode设置中搜索files.exclude，删除对应条目的隐藏规则。

5. Configure Classpath功能只读的问题
   你理解的没错，该功能展示的内容和.classpath完全一致，当识别到是Eclipse托管项目时，VSCode Java插件会将类路径配置锁定为只读，避免UI修改破坏Eclipse的配置兼容性。如果要修改配置，要么直接在Eclipse中操作，要么手动编辑.classpath文件，编辑完成后按Ctrl+Shift+P执行「Java: Reload Project」即可生效。

6. 删除.classpath后「Referenced Libraries (Read Only)」消失的原因
   Eclipse结构项目的引用库配置完全依赖.classpath文件中的classpathentry条目，你删除文件或者对应条目后，VSCode Java插件无法读取到Eclipse格式的类路径配置，就会取消只读标记，将项目识别为无构建系统的裸Java项目，自然不再显示只读的引用库节点。

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