Maven学习总结(十)——使用Maven编译项目gbk的不可映射问题



一、问题描述

今天在MyEclipse中使用Maven编译项目源代码时,结果如下了如下的错误


百思不得其解啊,java源代码在MyEclipse中显示是没有任何错误的,可是执行"maven install"命令编译项目时就会出现上述的错误,导致项目编译失败。这个问题还是第一次遇到,还好在这里http://capslk.iteye.com/blog/1419958看到了解决问题的办法。

二、解决办法

解决这个问题的思路: 在maven的编译插件中声明正确的字符集编码编码——编译使用的字符集编码与代码文件使用的字符集编码一致!!

安装系统之后,一般中文系统默认字符集是GBK。我们安装的软件一般都继承使用操作系统的默认字符集。所以当在中文XP或者win7系统开发,在使用maven(mvn compile)编译项目的时候,就会出现“编码 gbk 的不可映射字符”: 这个是由于代码使用的UTF-8,而maven编译的时候使用的GBK的缘故。 可以通过修改项目的pom文件,可以告诉maven这个项目使用UTF-8编码来编译。在项目的pom.xml文件中添加下面的配置:


1 <!-- 指明编译源代码时使用的字符编码,maven编译的时候默认使用的GBK编码, 通过project.build.sourceEncoding属性设置字符编码,告诉maven这个项目使用UTF-8来编译 --> 2     <properties> 3         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 4     </properties>


或者在pom.xml的/project/build/plugins/下的编译插件声明 中加入下面的配置:


1 <encoding>utf8</encoding>


即:

Maven学习总结(10)——使用Maven编译项目gbk的不可映射问题_字符集编码

1 <plugin>  2     <artifactId>maven-compiler-plugin</artifactId>  3     <configuration>  4         <source>1.6</source>  5         <target>1.6</target>  6         <!-- 指明编译源代码时使用的字符编码,  7         maven编译的时候默认使用的GBK编码,   8           通过encoding属性设置字符编码,  9           告诉maven这个项目使用UTF-8来编译 --> 10         <encoding>utf8</encoding>  11     </configuration> 12 </plugin>

Maven学习总结(10)——使用Maven编译项目gbk的不可映射问题_字符集编码

这两种方案都可以解决上述的问题,可以根据个人习惯来设置,如下图所示方式是采用配置<project.build.sourceEncoding>属性来指明编译采用的字符编码。


今天被这个问题折腾够久了,还好及时找到了解决办法,在此记录一下解决方案。