VSCode C++ IntelliSense Doxygen悬停预览Windows1251编码问题

问题原因 #

VSCode的C++语言服务（IntelliSense/Clangd）读取未打开的头文件时，默认采用编辑器全局编码或系统编码（通常为UTF-8），而非文件实际的Windows1251编码，导致西里尔文注释解码失败，显示为问号。打开头文件时，VSCode会自动识别文件编码，因此预览正常。

解决方案 #

1. 强制VSCode针对C++/头文件使用Windows1251编码 #

打开VSCode设置（快捷键Ctrl+,），点击右上角的打开设置(JSON)按钮，添加以下配置：

// 全局设置所有文件默认编码为Windows1251（可选，若仅需针对C++文件则用下方配置）
"files.encoding": "windows1251",
// 自动检测文件编码，优先匹配实际编码
"files.autoGuessEncoding": true,

// 仅针对C++源文件和头文件指定编码（更精准）
"[cpp]": {
    "files.encoding": "windows1251"
},
"[h]": {
    "files.encoding": "windows1251"
}

保存配置后重启VSCode，此时语言服务读取未打开的头文件时会采用指定的Windows1251编码，解析西里尔文注释。

2. 针对Clangd扩展指定编码（若使用Clangd作为语言服务） #

如果你的VSCode使用Clangd作为C++语言服务，需额外在设置中添加Clangd启动参数，强制其用Windows1251读取文件：

"clangd.arguments": [
    "-encoding=windows-1251"
]

Clangd默认以UTF-8读取文件，添加该参数后会适配Windows1251编码的注释内容。

3. 备选：转换文件编码为UTF-8（推荐长期方案） #

若无需保留Windows1251编码，可将头文件和源文件转换为UTF-8编码（Windows下建议带BOM）：

• 打开header.h，点击右下角的编码标识（如Windows1251），选择通过编码重新打开，选UTF-8，再选择通过编码保存为UTF-8。
• 转换后VSCode默认即可正确识别编码，无需额外配置，从根源解决编码兼容问题。

验证 #

重启VSCode后，不打开header.h标签页，直接在test.cpp中悬停sum_int函数，确认预览窗口的西里尔文注释正常显示，无问号乱码。

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