彻底解决使用Doxygen 1.5.6自动生成的chm文件导航栏中文乱码问题-优快云博客

升级Doxygen至1.5.6后，生成的chm文件导航栏出现中文乱码问题。本文介绍了解决该问题的方法，核心在于将index.hhc文件由UTF-8转为GBK编码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

最近升级了一下doxygen到最新版1.5.6，结果发现生成的chm文件导航栏中文会出现乱码，折腾了一天，终于查明原因并解决，特此分享给大家。

原因：
doxygen 1.5.6版（不知道从哪个版本开始的）内部一律使用UTF-8编码，生成的index.hhc文件也是使用UTF-8编码，然而微软的hhc编译工具不支持UTF-8编码，结果导致编译出的chm文件正文部分中文一切正常，但导航栏全是乱码。从网上搜了一圈，好像大家基本都遇到了这一情况，解决办法各异。

解决办法：
解决办法的核心就是将index.hhc文件用编码转换工具（例如iconv,ultraedit等）转换成GBK，再用hhc编译即可。

由于doxygen会生成index.hhc之后直接自动调用hhc进行编译，中间并未留有供我进行转换的机会，而我又不想在doxygen运行完毕生成了chm文件之后再重新修改index.hhc文件（自动或手动），然后再次重新生成chm文件，没办法，只有修改doxygen的源码重新编译了。

修改过程：
首先下载源码并编译doxygen，注意一定要先阅读编译指南，我就是没看编译指南导致走了不少弯路，因为doxygen编译过程中要用到UnxUtil工具，需要下载并装好。

编译通过后，找到生成index.hhc文件的源代码文件HtmlHelp.h/HtmlHelp.cpp，进行修改。修改思路为：
在保存index.hhc文件之前先进行编码转换，直接转换到GBK编码在存储，这样就可以直接生成GBK编码的index.hhc文件，后续过程就水到渠成了。

相关代码：
HtmlHelp.h

classHtmlHelp:publicIndexIntf
{
...

private:
...
QFile*cf,*kf;

QBuffer*cb;//Addedbyzwjia
QTextStreamcts,kts;
...
};

HtmlHelp.cpp

voidHtmlHelp::initialize()
{

constchar*str=Config_getString("CHM_INDEX_ENCODING");

if(!str)str="Windows-1250";

m_fromUtf8=portable_iconv_open(str,"UTF-8");

/*openthecontentsfile*/

QCStringfName=Config_getString("HTML_OUTPUT")+"/index.hhc";

cf=newQFile(fName);

if(!cf->open(IO_WriteOnly))
{

err("Couldnotopenfile%sforwriting\n",fName.data());
exit(1);
}

cb=newQBuffer();//Addedbyzwjia

cb->open(IO_WriteOnly);//Addedbyzwjia

/*Writetheheaderofthecontentsfile*/
cts.setDevice(cb);
cts.setEncoding(QTextStream::Latin1);
...
}

voidHtmlHelp::finalize()
{

//endthecontentsfile

cts<<"</UL>\n";

cts<<"</BODY>\n";

cts<<"</HTML>\n";
cts.unsetDevice();

////////////////////////////////////////////////

//Modifiedbyzwjia
QByteArraybuf=cb->buffer();

void*handle=portable_iconv_open("GBK","UTF-8");
size_tinputsize=buf.size();
size_toutputsize=inputsize*4+1;

char*in=buf.data();
QByteArrayoutbuf;
outbuf.resize(outputsize);

char*out=outbuf.data();

size_tlen=portable_iconv(handle,(constchar**)&in,&inputsize,&out,&outputsize);

outbuf.resize(out-outbuf.data());
cf->writeBlock(outbuf);
cf->close();
deletecf;
deletecb;
portable_iconv_close(handle);

//Modifiedbyzwjia--end

//////////////////////////////////////////////////////////////
...
}