QT工程中文出现乱码的解决方案编译后中文显示不正确显示乱码utf-8编码编译编码

# 情况说明
最开始是用msvc+CMakeList.txt来管理的工程项目，有的工程是通过原有工程项目转换过来，文件使用的编码可能是ASIC码，后面新建的文件大部分是utf-8编码文件。有的中文用QStringLiteral包裹起来，中文显示是正常的。但编译到Linux下时，这部分被包裹的中文会报错，无法编译成功。去除该QStringLiteral后，又会显示乱码。去掉后，在win下编译也会在有中文输入的地方提示“含有常量换行符”，无法编译成功...

# 解决方案
==解决方案就是，将cpp或者h文件全部转为utf-8编码，并在编译指令中显示指定编码为utf-8即可！==

## 转换编码为utf-8
这一部分可以使用python脚本一次性转换所有的文件。参考代码：
```python
import os
import codecs
import chardet

def detect_encoding(file_path):
    """检测文件编码"""
    with open(file_path, 'rb') as f:
        raw_data = f.read()
        result = chardet.detect(raw_data)
        return result['encoding'], raw_data

def convert_file(file_path):
    """转换单个文件到UTF-8编码"""
    try:
        # 检测文件原始编码
        encoding, raw_data = detect_encoding(file_path)
        
        if not encoding:
            print(f"警告: 无法检测 {file_path} 的编码，跳过")
            return
        
        # 读取文件内容
        try:
            content = raw_data.decode(encoding)
        except (UnicodeDecodeError, LookupError) as e:
            print(f"错误: 解码 {file_path} 时出错时出错 ({encoding}): {str(e)}")
            return
        
        # 统一换统一换行符为LF
        content = content.replace('\r\n', '\n').replace('\r', '\n')
        
        # 以UTF-8编码保存文件
        with codecs.open(file_path, 'w', encoding='utf-8') as f:
            f.write(content)
        
        print(f"已转换: {file_path} (从 {encoding})")
        
    except Exception as e:
        print(f"处理 {file_path} 时发生错误: {str(e)}")

def process_directory(directory='.'):
    """递归处理目录中的所有CPP文件"""
    for root, dirs, files in files in os.walk(directory):
        for file in files:
            if file.endswith('.cpp'):
                file_path = os.path.join(root, file)
                convert_file(file_path)

if __name__ == "__main__":
    current_dir = os.getcwd()
    print(f"开始处理目录: {current_dir}")
    
    process_directory(current_dir)
    
    print("转换完成！")
```

## 显示指定编译时编码为utf-8
参考写法：
```
cmake_minimum_required(VERSION 3.15)
project(MyUtf8Project LANGUAGES CXX)

# 创建一个接口库来管理编码设置
add_library(utf8_config INTERFACE)

if(MSVC)
    # Visual Studio / MSVC
    target_compile_options(utf8_config INTERFACE /utf-8)
    target_compile_definitions(utf8_config INTERFACE
        _UNICODE
        UNICODE
    )
else()
    # GCC, Clang, Intel etc.
    target_compile_options(utf8_config INTERFACE
        -finput-charset=UTF-8
        -fexec-charset=UTF-8
        -fwide-exec-charset=UTF-8
    )
endif()

# 对每个目标应用编码设置
add_executable(my_program main.cpp source1.cpp source2.cpp)
target_link_libraries(my_program PRIVATE utf8_config)

# 如果是库项目
add_library(my_library STATIC lib_source1.cpp lib_source2.cpp)
target_link_libraries(my_library PUBLIC utf8_config)
```
关键点解释：
对于 MSVC (/utf-8)：
    /utf-8 选项告诉编译器源代码文件和字符串字面量都使用 UTF-8 编码
    同时设置 _UNICODE 和 UNICODE 宏启用 Windows Unicode API
对于 GCC/Clang：
    -finput-charset=UTF-8：指定源文件编码为 UTF-8
    -fexec-charset=UTF-8：指定执行时字符集为 UTF-8
    -fwide-exec-charset=UTF-8：指定宽字符执行字符集为 UTF-8

![](/media/202511/2025-11-23_232501_9333250.6168967207074909.jpeg)

至此，能够使得中文编译和显示是正常的。

编辑：myhappyandy