64位MinGW编译Unicode控制台程序遇WinMain未定义链接错误

问题描述 #

我用64位MinGW构建的控制台彩色目录列表工具，之前运行正常但不支持Unicode。为处理Unicode文件名，我修改了Makefile，添加-DUNICODE -D_UNICODE编译宏，将main()改为_tmain()，并把数百处char替换为TCHAR，适配了相关函数调用。8000行代码编译全部通过，但链接时出现错误：undefined reference to 'WinMain'。我尝试在编译和链接阶段添加-mconsole标记强调是控制台程序，但没有效果。

编译及链接日志 #

d:\tdm64\bin\g++ -Wall -s -O3 -c -Weffc++ -Wno-write-strings -DUSE_64BIT -DUNICODE -D_UNICODE read_link.cpp
d:\tdm64\bin\g++  Ndir32.o cmd_line.o config.o conio32.o Diskparm.o err_exit.o Filelist.o Fileread.o common.o Ndisplay.o nio.o Qualify.o nsort.o treelist.o tdisplay.o mediatype.o read_link.o -s -O3 -dUNICODE -d_UNICODE  -o ndir64.exe -lmpr -lshlwapi -lole32 -luuid
d:/tdm64/bin/../lib/gcc/x86_64-w64-mingw32/5.1.0/../../../../x86_64-w64-mingw32/lib/../lib/libmingw32.a(lib64_libmingw32_a-crt0_c.o): In function `main':
C:/crossdev/src/mingw-w64-v4-git/mingw-w64-crt/crt/crt0_c.c:18: undefined reference to `WinMain'
collect2.exe: error: ld returned 1 exit status
make: *** [ndir64.exe] Error 1

解决方案 #

1. 修正_tmain的签名格式 #

MinGW下，_tmain必须匹配标准控制台入口的参数格式，确保你的定义为：

int _tmain(int argc, TCHAR* argv[])

或包含环境变量参数的版本：

int _tmain(int argc, TCHAR* argv[], TCHAR* envp[])

签名不匹配会导致链接器无法识别控制台入口，转而寻找WinMain。

2. 修复链接命令的参数错误 #

你的链接命令中存在两个问题：

• 宏定义使用了小写的-d，MinGW正确的宏参数是大写-D
• 未正确添加-mconsole参数

修改后的链接命令应为：

d:\tdm64\bin\g++ Ndir32.o cmd_line.o config.o conio32.o Diskparm.o err_exit.o Filelist.o Fileread.o common.o Ndisplay.o nio.o Qualify.o nsort.o treelist.o tdisplay.o mediatype.o read_link.o -s -O3 -DUNICODE -D_UNICODE -mconsole -o ndir64.exe -lmpr -lshlwapi -lole32 -luuid

3. 统一全局编译宏 #

确保Makefile的全局编译FLAGS中添加-DUNICODE -D_UNICODE，而非仅在单个文件编译时指定，避免不同编译单元的宏定义不一致导致入口冲突。

4. 备选：直接使用wmain入口 #

如果_tmain仍存在问题，可以直接使用宽字符原生入口wmain，签名为：

int wmain(int argc, wchar_t* argv[])

该方式无需依赖TCHAR宏，直接明确处理Unicode，同时保持链接时添加-mconsole参数。

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