Eclipse中将Xtext项目转为Maven时出现未知字符�问题

乱码问题的核心是文件编码不一致：Eclipse环境默认多使用UTF-8编码，但Maven若未明确配置编码，会默认采用平台编码（如Windows下的GBK/ISO-8859-1），导致Unicode字符«（U+00AB）和»（U+00BB）被错误解析为�。以下是具体解决步骤：

1. 全局配置Maven编码为UTF-8 #

在pom.xml的<properties>节点中添加编码配置，强制Maven构建全流程使用UTF-8：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <!-- 根据你的JDK版本调整下面两行 -->
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

2. 给Xtext Maven插件指定编码 #

若项目使用xtext-maven-plugin，需在插件配置中明确编码参数，确保模板文件读取、生成时用UTF-8：

<build>
    <plugins>
        <plugin>
            <groupId>org.eclipse.xtext</groupId>
            <artifactId>xtext-maven-plugin</artifactId>
            <version>${xtext.version}</version> <!-- 替换为你的Xtext版本 -->
            <executions>
                <execution>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <encoding>UTF-8</encoding> <!-- 关键配置项 -->
                <language>com.yourpackage.MyLang</language> <!-- 替换为你的语言类全路径 -->
            </configuration>
        </plugin>
    </plugins>
</build>

3. 对齐Eclipse与Maven的编码设置 #

• 打开Eclipse偏好设置：Window > Preferences > General > Workspace，将Text file encoding设为UTF-8；
• 清理项目缓存：执行mvn clean install，同时在Eclipse中选Project > Clean，避免残留乱码文件。

4. 备选方案：替换符号为转义字符 #

若上述配置仍不生效，可在Xtend模板中直接用转义字符替代«»：

• HTML转义：«（对应«）、»（对应»）
• Unicode转义：\u00AB（对应«）、\u00BB（对应»）

修改后的模板示例：

<?xml version='1.0' encoding='UTF-8'?>

<Entities>
                &laquo;GetItem(entities)&raquo;
                &laquo;IF isValid&raquo;
                &laquo;GetFoo(entities)&raquo;
                &laquo;ENDIF&raquo;     
</Entities>

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