AI 助理
备案控制台
开发者社区 开发与运维 文章 正文

Eclipse中.setting目录下文件介绍

2016-01-07 44624
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介：

Eclipse项目中系统文件介绍

一. 写在前面

  1. 文章较长，可以直接到感兴趣的段落，或者直接关键字搜索；
  2. 请原谅作者掌握的编程语言少，这里只研究Java相关的项目；
  3. 每一个文件仅仅做一个常见内容的简单介绍，这些知识多数来自于实践理解和网络搜索，可能会不全面，更详细的可以看相关的参考资料。

二. 概述

Eclipse在新建项目的时候会自动生成一些文件。这些文件比如.project、.classpath、.settings目录下的所有文件等。这些文件是Eclipse项目的元数据，描述了一个Eclipse项目。

通常这些文件里的内容可以通过配置具体Eclipse项目的Properties来进行修改，而且普通用户无需知道这些文件具体的用处，但是本着探究问题本质的态度，我们不妨可以了解一下这些文件及内容具体是干什么用的。当熟悉了这些文件的内容后，往往在项目配置中可以直接查看和修改文件内容，可以起到事半功倍的效果。

三. 项目根目录下的文件

Eclipse项目根目录下通常有两个文件：.project和.classpath，.project是Eclipse项目必须有的文件，而.classpath是Java项目必须有的文件。这两个文件均是XML格式的文本文件，用普通文本编辑器即可打开。

1. 文件：.project

.project描述了一个Eclipse项目。

典型内容

<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
    <!-- name里的内容代表项目名字，对应了Eclipse项目的名称，不是Maven的finalName -->
    <name>demo</name>
    <!-- 项目的注释 -->
    <comment></comment>
    <!-- 引用的项目的名字 -->
    <projects>
    </projects>
    <!-- 有序的列表，定义了一系列的构建命令（buildCommand） -->
    <buildSpec>
        <buildCommand>
            <!-- 项目构建命令的名字 -->
            <name>org.eclipse.wst.jsdt.core.javascriptValidator</name>
            <!-- 构建命令初始化时需要传递的参数（一般看到的都是空的） -->
            <arguments>
            </arguments>
        </buildCommand>
        <buildCommand>
            <name>org.eclipse.jdt.core.javabuilder</name>
            <arguments>
            </arguments>
        </buildCommand>
        <buildCommand>
            <name>org.eclipse.wst.common.project.facet.core.builder</name>
            <arguments>
            </arguments>
        </buildCommand>
        <buildCommand>
            <name>org.eclipse.m2e.core.maven2Builder</name>
            <arguments>
            </arguments>
        </buildCommand>
    </buildSpec>
    <!-- 项目中用到的一些特性的列表 -->
    <natures>
        <!-- 每一个特性的的名字 -->
        <nature>org.eclipse.jem.workbench.JavaEMFNature</nature>
        <nature>org.eclipse.wst.common.modulecore.ModuleCoreNature</nature>
        <nature>org.eclipse.jdt.core.javanature</nature>
        <nature>org.eclipse.m2e.core.maven2Nature</nature>
        <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
        <nature>org.eclipse.wst.jsdt.core.jsNature</nature>
    </natures>
</projectDescription>

使用示例

  1. Maven项目的配置

    一个Maven项目要确保有如下的内容，如果没有，可以手工加上下面的BuildCommand和natures：

    <projectDescription>
        <buildSpec>
            <buildCommand>
                <name>org.eclipse.m2e.core.maven2Builder</name>
                <arguments>
                </arguments>
            </buildCommand>
        </buildSpec>
        <natures>
            <nature>org.eclipse.m2e.core.maven2Nature</nature>
        </natures>
    </projectDescription>

  2. 禁止Javascript的正确性校验

    其实禁止正确性校验是一个不好的习惯，但很多人有这样的需求（唐僧：配置一下exclude路径多好啊，即能进行正确性校验又不会太影响速度），这里给出方案。删除如下的buildCommand即可，也可选择性的删除如下的nature：

    <buildCommand>
        <name>org.eclipse.wst.jsdt.core.javascriptValidator</name>
        <arguments>
        </arguments>
    </buildCommand>
    <natures>
        <nature>org.eclipse.wst.jsdt.core.jsNature</nature>
    </natures>

  3. 把一个Java项目变为dynamic web项目

    加入如下的buildSpec、nature元素即可：

    <buildSpec>
        <buildCommand>
            <name>org.eclipse.wst.common.project.facet.core.builder</name>
            <arguments>
            </arguments>
        </buildCommand>
    </buildSpec>
    <natures>
        <nature>org.eclipse.wst.common.modulecore.ModuleCoreNature</nature>
        <nature>org.eclipse.wst.common.project.facet.core.nature</nature>
    </natures>

拷贝攻略

.project文件可以从同类型的项目中直接拷贝，但需要修改/projectDescription/name里的项目名称。

参考资料

The project description file

2. 文件：.classpath

.classpath描述了一个Eclipse项目。

典型内容

<?xml version="1.0" encoding="UTF-8"?>
<classpath>
    <!-- 含义：src/main/java属于源码，编译后放到target/classes目录下 -->
    <classpathentry kind="src" output="target/classes" path="src/main/java">
        <attributes>
            <attribute name="optional" value="true"/>
            <attribute name="maven.pomderived" value="true"/>
        </attributes>
    </classpathentry>
    <classpathentry excluding="**" kind="src" output="target/classes" path="src/main/resources">
        <attributes>
            <!-- 代表了配置是从POM.xml里来的，受maven管理，非maven项目可以去掉这个 -->
            <attribute name="maven.pomderived" value="true"/>
        </attributes>
    </classpathentry>
    <!-- 这里的including代表了目录下所有.java文件才会被处理，其他文件一概忽略，不会出现在target/test-classes目录下 -->
    <classpathentry including="**/*.java" kind="src" output="target/test-classes" path="src/test/java">
        <attributes>
            <attribute name="optional" value="true"/>
            <attribute name="maven.pomderived" value="true"/>
        </attributes>
    </classpathentry>
    <classpathentry excluding="**" kind="src" output="target/test-classes" path="src/test/resources">
        <attributes>
            <attribute name="maven.pomderived" value="true"/>
        </attributes>
    </classpathentry>
    <!-- 这里代表使用标准的JavaSE-1.7 JDK，相比来说如果用default和直接写当前系统中安装的JDK是不推荐的 -->
    <classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.7">
        <attributes>
            <attribute name="maven.pomderived" value="true"/>
        </attributes>
    </classpathentry>
    <!-- 代表了Maven中的dependencies也都放到classpath里 -->
    <classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">
        <attributes>
            <attribute name="maven.pomderived" value="true"/>
            <!-- web工程中把依赖的jar都放到输出的webapp里/WEB-INF/lib下面 -->
            <attribute name="org.eclipse.jst.component.dependency" value="/WEB-INF/lib"/>
        </attributes>
    </classpathentry>
    <!--  -->
    <classpathentry kind="con" path="org.eclipse.jst.server.core.container/org.eclipse.jst.server.tomcat.runtimeTarget/Apache-Tomcat v7.0">
        <attributes>
            <attribute name="owner.project.facets" value="jst.web"/>
        </attributes>
    </classpathentry>
    <!-- 统一的输出为target/classes -->
    <classpathentry kind="output" path="target/classes"/>
</classpath>

使用示例

  1. 项目有test/resources或test/java目录，但是不识别为classpath

    酌情加入如下的classpathentry：

    <classpathentry including="**/*.java" kind="src" output="target/test-classes" path="src/test/java" />
    <classpathentry excluding="**" kind="src" output="target/test-classes" path="src/test/resources" />

  2. 项目是maven工程，但是构建路径貌似怎么也配置不对

    Maven是约定优于配置（convention over configuration）的，但是.classpath是配置型的，一般不会出现这种情况，如果出现了，检查maven约定的类路径（比如src/main/java、org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER）中是否有如下的元素：

    <attributes>
        <attribute name="maven.pomderived" value="true"/>
    </attributes>

  3. Maven的依赖jar文件放不到/WEB-INF/lib里

    确认或加入如下的配置：

    <classpathentry kind="con" path="org.eclipse.m2e.MAVEN2_CLASSPATH_CONTAINER">
        <attributes>
            <attribute name="maven.pomderived" value="true"/>
            <attribute name="org.eclipse.jst.component.dependency" value="/WEB-INF/lib"/>
        </attributes>
    </classpathentry>
  4. 界面配置方法

在项目Properties配置界面中，具体位置参考下图：

.classpath的界面配制方法

  1. 可移植的JDK配置

JDK配置

拷贝攻略

.classpath文件可以从同类型的项目中直接拷贝，有些目录没有的话，注意删掉对应的classpathentry，其他基本无需修改，如果有问题再考虑去改。但如果从别人的机器里拷贝，需要关注三点：

  1. Java SDK的配置：如果Java SDK类型设置的是配置界面中的“Alternate JRE”，那么除非自己机器上装了对方机器名字一样的JDK（不是类型或者版本，而是Installed JREs配置中的名字），否则就需要修改JDK的配置。推荐使用配置界面中的“Execution Environment”来配置，避免绑定具体的JDK版本和实现，如<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/JavaSE-1.7" />
  2. 如果Web项目使用了Web容器且绑定了project facet，那么就需要考虑Web容器配置的问题了，以Apache-tomcat为例，需要增加<classpathentry kind="con" path="org.eclipse.jst.server.core.container/org.eclipse.jst.server.tomcat.runtimeTarget/Apache-Tomcat v7.0" />，而"Apache-Tomecat v7.0"字符串需要与Eclipse Preferences里Server/Runtime Environments里的name一列保持一致。

参考资料

JDK为什么建议配置成Execution Environment

四. /.settings目录下的文件

Eclipse项目.settings目录下的配置比较杂，各种后缀名的都可以见到，绝大多数是文本文件，格式为properties（多数以.prefs为后缀名）或XML（多数以.*、.xml为文件名）格式的为主。下面挨个讲一些典型的文件。

1. 文件：.jsdtscope

.jsdtscope文件定义了web项目中的源码路径，也就意味着只有web project才会有这个配置。这些源码Eclipse会进行validate（如果validate没有禁用）。这个文件在实际开发中最大的价值在于定义JS文件的例外路径，在配置界面中配置的话挨个选很烦人。

典型内容

<?xml version="1.0" encoding="UTF-8"?>
<classpath>
    <classpathentry excluding="**/*.min.js|**/bower_components/*|**/custom/*|**/node_modules/*|**/target/**|**/vendor/*" kind="src" path="src/main/webapp"/>
    <classpathentry kind="con" path="org.eclipse.wst.jsdt.launching.JRE_CONTAINER"/>
    <classpathentry kind="con" path="org.eclipse.wst.jsdt.launching.WebProject">
        <attributes>
            <attribute name="hide" value="true"/>
        </attributes>
    </classpathentry>
    <classpathentry kind="con" path="org.eclipse.wst.jsdt.launching.baseBrowserLibrary"/>
    <classpathentry kind="output" path=""/>
</classpath>

使用示例

  1. 配置JS的例外（一般用于让Eclipse不校验第三方JS文件，避免开启JS校验后Eclipse假死）

在.jsdtscope文件的<classpathentry kind="src" path="src/main/webapp"/>增加excluding属性，写法见“典型内容”一节。

  1. 界面配置方法

这一部分在Eclipse不同版本里不一样，Eclipse 4.5及以后版本可以参考下面的配置，4.4.X版本（更早的版本没有考证）只能配置到具体项目中，不能全局配置。若针对具体项目配置，配置界面在项目的properties里的如下位置：

.classpath的界面配制方法

若全局进行配置，在Window/Preferences/JavaScript/Include Path中进行配置，如下图：

.classpath的界面配制方法

拷贝攻略

.jsdtscope文件可以从同类型的项目中直接拷贝，基本无需修改。

2. 文件：org.eclipse.core.resources.prefs

org.eclipse.core.resources.prefs文件其实就是规定项目内的文件的编码用的。一般来说一个项目里的文件编码需要一致，特别是文件文本内容本身无法指示文件本身编码的（比较绕，XML文件第一行能指示自身编码，CSS也有这个能力但用得不多），尽量不要多种编码同时存在（最好在编码规范中禁止多重编码同时存在的现象发生）。

典型内容

eclipse.preferences.version=1
encoding//src/main/java=UTF-8
encoding//src/main/resources=UTF-8
encoding//src/test/java=UTF-8
encoding//src/test/resources=UTF-8
encoding/<project>=UTF-8

使用示例

一般正常的项目打开后，应该看到是统一的编码，如果存在例外，可以对例外的文件进行转码，然后删除这个文件中例外的那一行。

拷贝攻略

org.eclipse.core.resources.prefs文件可以从同类型的项目中直接拷贝，无需修改。

3. 文件：org.eclipse.jdt.core.prefs

org.eclipse.jdt.core.prefs文件指定了一些Java编译的特性，比如Java版本之类的，看文件每一行的key能猜出具体的用处。

典型内容

eclipse.preferences.version=1
org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled
org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.7
org.eclipse.jdt.core.compiler.compliance=1.7
org.eclipse.jdt.core.compiler.problem.assertIdentifier=error
org.eclipse.jdt.core.compiler.problem.enumIdentifier=error
org.eclipse.jdt.core.compiler.problem.forbiddenReference=warning
org.eclipse.jdt.core.compiler.source=1.7

使用示例

如果项目中源文件版本不正确，编译出来的目标版本不对，那么可以在这里进行修改。界面中修改的话，可以参考：

.classpath的界面配制方法

拷贝攻略

org.eclipse.jdt.core.prefs文件可以从同类型的项目中直接拷贝，无需修改。

4. 文件：org.eclipse.m2e.core.prefs

org.eclipse.m2e.core.prefs是一些maven相关的配置。

典型内容

eclipse.preferences.version=1
activeProfiles=dev
resolveWorkspaceProjects=true
version=1

使用示例

一般在Maven项目开发时和生产环境中配置不一样，可以在pom.xml中指定不同的profile来实现，Eclipse项目开发时指定profile的话（比如指定名叫dev的profile），就可以配置这个文件的activeProfiles属性。如果在界面中配置，在这里：

.classpath的界面配制方法

拷贝攻略

org.eclipse.m2e.core.prefs文件可以从同类型的项目中直接拷贝，无需修改。

5. 文件：org.eclipse.wst.common.component

org.eclipse.wst.common.component文件规定了项目怎么组装成一个webapp，这里可以玩很多种组装方式。

典型内容

<?xml version="1.0" encoding="UTF-8"?>
<project-modules id="moduleCoreId" project-version="1.5.0">
    <wb-module deploy-name="inkfish-web">
        <wb-resource deploy-path="/" source-path="/target/m2e-wtp/web-resources"/>
        <wb-resource deploy-path="/" source-path="/src/main/webapp" tag="defaultRootSource"/>
        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src/main/java"/>
        <wb-resource deploy-path="/WEB-INF/classes" source-path="/src/main/resources"/>
        <property name="context-root" value="inkfish-web"/>
        <property name="java-output-path" value="/inkfish-web/target/classes"/>
    </wb-module>
</project-modules>

使用示例

在某些项目中，从远程maven仓库下载zip组件（当然war组件最好，是maven自带支持的）解压并放到target，作为webapp一部分，就可以在这里修改组装webapp的方式。如果在界面中配置，在这里：

.classpath的界面配制方法

拷贝攻略

org.eclipse.wst.common.component文件不可直接拷贝，如需拷贝注意修改deploy-name、某些value等一些与项目名称相关的信息。

6. 文件：org.eclipse.wst.common.project.facet.core.xml

org.eclipse.wst.common.project.facet.core.xml指示了项目中启用那些facet及facet的版本。

典型内容

<?xml version="1.0" encoding="UTF-8"?>
<faceted-project>
  <runtime name="Apache Tomcat v8.0"/>
  <fixed facet="wst.jsdt.web"/>
  <installed facet="wst.jsdt.web" version="1.0"/>
  <installed facet="java" version="1.7"/>
  <installed facet="jst.web" version="3.1"/>
</faceted-project>

使用示例

界面配置在下面的位置：

.classpath的界面配制方法

在实际使用中有时候在Eclipse的facet配置了以后又恢复回去了，总是配不成功，那么就可以直接修改这个文件。常见的比如servlet版本不匹配，那么就可以修改jst.web这个facet的version，如果java版本不对，那么可以修改java这个facet的version。

拷贝攻略

org.eclipse.wst.common.project.facet.core.xml文件可以从同类型的项目中直接拷贝，基本无需修改。

7. 文件：org.eclipse.wst.jsdt.ui.superType.container

使用不多，无研究，略去。

典型内容

org.eclipse.wst.jsdt.launching.baseBrowserLibrary

或者也见过

org.eclipse.wst.jsdt.launching.JRE_CONTAINER

拷贝攻略

org.eclipse.wst.jsdt.ui.superType.container文件可以在项目间项目直接拷贝，无需修改。

8. 文件：org.eclipse.wst.jsdt.ui.superType.name

使用不多，无研究，略去。

典型内容

Window

或者也见过

Global

拷贝攻略

org.eclipse.wst.jsdt.ui.superType.name文件可以在项目间项目直接拷贝，无需修改。

9. 文件：org.eclipse.wst.validation.prefs

使用不多，无研究，略去。

典型内容

disabled=06target
eclipse.preferences.version=1

拷贝攻略

org.eclipse.wst.validation.prefs文件可以在项目间项目直接拷贝，无需修改。

五. 写在后面

有的配置是前后关联的，不是调整一个配置文件就能完事的，比如修改web工程里的Java版本，可能需要修改好几个配置文件。

这篇文章主要介绍了Eclipse项目中常见的自动生成的文件，这些文件都可以通过界面配置来修改，如果大量项目同时修改感觉界面配置比较麻烦，或者纯粹是极客类型的，可以学习这些配置文件的内容。普通程序员只需要了解有这么个东西，出了一些界面上配置失灵的情况，可以直接修改文件。

文章标签：
Java
Android开发
Web App开发
Maven
JavaScript
关键词：
Eclipse目录
Eclipse文件
Eclipse setting文件
Eclipse setting
Eclipse setting目录
激酶
目录
相关文章
zcq5jk6y5y5e4
|
4月前
|
应用服务中间件 定位技术 Android开发
Eclipse部署虚拟项目目录
Eclipse部署虚拟项目目录
zcq5jk6y5y5e4
39 0
宁波阿成.
|
7月前
|
Android开发
STS(eclipse)批量修改文件里的某个内容
STS(eclipse)批量修改文件里的某个内容
宁波阿成.
61 0
蓝易云
|
7月前
|
Java Android开发
修改Eclipse新建jsp文件的默认编码
现在，当你在Eclipse中新建JSP文件时，默认的编码就会被设置为你所选择的编码（例如UTF-8）。这样可以确保新建的JSP文件使用了指定的编码格式。 买CN2云服务器，免备案服务器，高防服务器，就选蓝易云。百度搜索：蓝易云
蓝易云
59 0
零零年夏
|
Java Android开发
【Eclipse】eclipse中让Button选择的文件显示在文本框里
【Eclipse】eclipse中让Button选择的文件显示在文本框里
零零年夏
93 0
祈澈菇凉
|
前端开发 数据库 Android开发
修改Eclipse文件连接数据库
修改Eclipse文件连接数据库
祈澈菇凉
45 0
IT012201
|
Java Android开发
eclipse中Java文件生成jar包
eclipse中Java文件生成jar包
IT012201
81 0
Designer小郑
|
API Android开发 数据安全/隐私保护
Android（三） 基于 eclipse 的 Android配置 APK文件的导出
Android（三） 基于 eclipse 的 Android配置 APK文件的导出
Designer小郑
99 0
阿里云博主-阿演
|
开发工具 Android开发 git
eclipse导入git项目过滤target .setting 等文件
eclipse中导入git项目
阿里云博主-阿演
200 0
零一成城
|
XML Java 数据库连接
Eclipse MyBatis1.4.2 generatorConfig 默认不生成XML文件，加了type="XMLMAPPER"也不起作用，解决方法
今天下载了最新的mybatis插件，生成不了XML文件，然后是一堆java注解文件，还有一堆报错。心头各种不爽，网上搜了很久，都是很旧的帖子，根据解决不了问题。最后自己在官网找到了答案，以后大家在搜索找不到答案，还是自己到官网翻文档吧！ MyBatis 的官网generatorConfig说明如下： http://mybatis.org/generator/configreference/xmlconfig.html
零一成城
481 0
Eclipse MyBatis1.4.2 generatorConfig 默认不生成XML文件，加了type="XMLMAPPER"也不起作用，解决方法
唐城子
|
Android开发
eclipse中打开.class文件（安装jadclipse）
eclipse中打开.class文件（安装jadclipse）
唐城子
388 0
eclipse中打开.class文件（安装jadclipse）

热门文章

最新文章

  • 1
    Eclipse 插件市场安装 Cloud Toolkit
  • 2
    关于Eclipse提示Failed to create the java virtual machine问题解决办法
  • 3
    Myeclipse常用优化1
  • 4
    关于启动 Eclipse 弹出“Failed to load the JNI shared library jvm.dll”错误的解决方法！
  • 5
    使用eclipse生成html格式注释文档 [ javadoc ]
  • 6
    Android项目在非Eclipse下安装到模拟器以及导入到Eclipse
  • 7
    Myeclipse下web工程怎么样发布
  • 8
    Eclipse 打开鼠标悬停提示功能
  • 9
    沫沫金讲：Eclipse卡死cup内存双爆，取消验证无效--看这里修改.project跟我做
  • 10
    设置 Eclipse 智能代码提示,大幅度减少 alt+/ 使用频率，打每个字都出现代码提示的办法
  • 1
    Eclipse或STS里如何跟踪jar包里的源代码代码
    101
  • 2
    STS(eclipse)批量修改文件里的某个内容
    62
  • 3
    解决Eclipse中文乱码
    81
  • 4
    建立ubuntu下基于eclipse的android开发环境
    51
  • 5
    如何在Eclipse中查看Android源码或者第三方组件包源码（转）
    55
  • 6
    在Eclipse配置安装Android详细教程(新手)
    165
  • 7
    【Eclipse安装及使用(面向小白)】
    122
  • 8
    eclipse安装教程
    94
  • 9
    双击eclipse提示an error has occurred See the log file E:\javatool\eclipse-mars-2\configuration\156991769
    79
  • 10
    【eclipse】pom.xml 红叉的解决办法
    134

    • 相关电子书

    更多
  • NO MORE "SBT ASSEMBLY":RETHINK
  • 低代码开发师（初级）实战教程
  • 阿里巴巴DevOps 最佳实践手册

    • 推荐镜像

    更多
  • eclipse
  • maven
  • msys2
    • 下一篇
    阿里云无影云电脑免费试用，最长可试用3个月