错误: 编码GBK的不可映射字符 - Android Studio 生成javadoc文档时报错

2024-05-18 05:19:08

1.运行Tools工具中的Generate JavaDoc报错

想将项目生成一个帮助文档，结果生成doc时(如下图所示)，

报下面错误

错误: 编码GBK的不可映射字符//鑾峰彇鍒板緟瑙ｆ瀽鐨勫浘鐗?

1
2

解决方法

在生成DOC弹出的对话框中,在other command line argument中输入下面命令

-encoding utf-8 -charset utf-8

1

如下图所示

完美解决上述问题，成功生成了doc文档。

2.原理解释

我的android studio中所有的代码文档都是用utf-8进行编码的,java在编译时会将uft-8编码的代码转化为unicode编码存入内存中。
这里要注意理清一个概念,JavaDoc.

JavaDoc 是用以提取注释的工具,Jdk安装的一部分。

android studio gradle里的默认编译的编码是utf-8的，而javadoc却是使用的当前电脑环境中的默认编码，即是GBK。

如果我们用的是英文，那utf-8与gbk的英文编码方式都是一样的。但一遇到中文就会报上述错误了，因为中文用的是utf-8的编码，而javadoc却用了gbk的编码去转换中文，所以就无法转换从而报错。

注： GBK中文占两个字节,utf-8中文(常用)占三个字节

因为代码中的注释部分包含了许多中文，而javadoc是会去编译这些注释从而生成HTML的帮助文档的，所以就会出现上述的编码GBK转换错误的报错。

3.解决问题时踩过的坑

1.在app的build.gradle里添加代码

添加如下代码到build.gradle中

tasks.withType(JavaCompile) {options.encoding = "UTF-8"
}

1
2
3

生成doc时依然报错，这个方案应该是指代码的编译，而不适用于doc生成。

2.更改项目的编码

如下图，我将Project Encoding的编译换成了utf-8.依然报错

本身我的文档就都是utf-8编码的,只不过之前这里的Project Encoding是显示的系统默认(即GBK)。这个方案也是跟1一样，不适用于doc生成。

错误: 编码GBK的不可映射字符 - Android Studio 生成javadoc文档时报错相关推荐

Android studio 生成JavaDoc文档
Android studio 生成JavaDoc文档 1.Tools->Generate Javadoc 2.在other command line arguments项输入: -encodin ...
解决Android Studio Gradle 错误编码GBK的不可映射字符
今天刚学习Android Studio这个IDE来写代码,然后在代码中加了中文注释导致无法编译: 提示错误:"错误: 编码 GBK 的不可映射字符". 经过查资料发现以下方法可成功 ...
【错误记录】生成 Java 文档错误 ( Xxx.java:xx: 错误: 编码GBK的不可映射字符 )
文章目录一.报错信息二.解决方案一.报错信息使用 javadoc 命令 , 生成 Java 文档 , 报错 ; javadoc Student.java D:\develop\javadoc& ...
基于Windows下处理Java错误:编码GBK的不可映射字符的解决方案
基于Windows下处理Java错误:编码GBK的不可映射字符的解决方案最近在研究Java,涉及命令行编译,使用notepad++编辑器,然后使用javac编译: 之前的几个文件没有中文的内容,都没 ...
JAVA：错误: 编码GBK的不可映射字符；错误: 找不到或无法加载主类；
目录一.编码GBK的不可映射字符: 1.现象 2.解决方法 ANSI:ANSI是什么编码? - malecrab - 博客园 (cnblogs.com) 二.找不到或无法加载主类一.编码GBK的不 ...
java命令行编译运行遇到java:5: 错误: 编码GBK的不可映射字符（涓変釜鏋勯?犲嚱鏁?）解决方法
java命令行编译运行遇到java:5: 错误: 编码GBK的不可映射字符 (涓変釜鏋勯?犲嚱鏁?)解决方法错误原因:使用简单javac 命令编译java文件,如果代码中存在中文,就算是注释有中文的 ...
【java】xxxxx.java:5: 错误: 编码 GBK 的不可映射字符_编译问题
1.出现问题 xxxxx.java:5: 错误: 编码 GBK 的不可映射字符 (0x80) System.out.println("璇疯緭鍏ョ涓?涓拰灏氱殑韬珮锛?"); ...
IDEA Generate JavaDoc时控制台报错误: 编码GBK的不可映射字符
一.生成JavaDoc 为了方便查看功能解释,除了使用Swagger-ui以外,还需要知道非控制器(controller)类的功能,比如Service.Resource等.于是尝试了一下IDEA的生成 ...
java错误: 编码 GBK 的不可映射字符 (0x9C)
java错误: 编码 GBK 的不可映射字符 (0x9C) 目录 java错误: 编码 GBK 的不可映射字符 (0x9C) 错误情况示例: 解决办法: 错误情况示例: E:\myJavaCode&g ...

最新文章

热门文章