# 一、问题现象

qt版本：6.5.3
蓝牙不可用：
qt.bluetooth: Dummy backend running. Qt Bluetooth module is non-functional.
![1749118548952](https://developer.qcloudimg.com/http-save/yehe-11910509/a208bf8a0d3bfab12f2e71b9a6bc4713.png)
# 二、问题原因

在 Windows 开发环境下使用 **Qt + MinGW** 时遇到 `qt.bluetooth: Dummy backend running. Qt Bluetooth module is non-functional` 错误，说明 Qt 的蓝牙模块无法正常工作。这是因为 MinGW 编译的 Qt 默认不支持 Windows 的蓝牙 API（仅 MSVC 支持）。
# 三、解决方案

**使用MSVC编译器**
使用MSVC编译器有很多方法，但我找到一个对小白最友好的方法，下载对应版本的**`Visual Studio`**即可
# 1. 查看qt的MSVC版本

![image-20250606100445952](https://developer.qcloudimg.com/http-save/yehe-11910509/adbf8204e6183b37e89aacd570d44da0.png)
如果没有在下载组件的时候需要把MSVC勾选上
![image-20250606101027564](https://developer.qcloudimg.com/http-save/yehe-11910509/ed23fceaa40a5219ab1294d10f46600c.png)
# 2. 安装MSV[C编译器](https://so.csdn.net/so/search?q=C%E7%BC%96%E8%AF%91%E5%99%A8&spm=1001.2101.3001.7020)和Windows 11 SDK

打开`Visual Studio Installer`，如点击**修改**（没安装vs的跳过这里直接看下载组件）：
![image-20250606101526133](https://developer.qcloudimg.com/http-save/yehe-11910509/89486e1cc0c72dc4af400f124c741fdf.png)
在**工作负荷**中勾选**使用C++的桌面开发**，以及`Windows 11 SDK`：（如果电脑是win10 就选win10 不确定的可以11和10都选上）
![image-20250606104310414](https://developer.qcloudimg.com/http-save/yehe-11910509/7c1e758e734565d953b24d3a3f21a730.png)
在**单个组件**中勾选自己要安装的编译器：
![image-20250606104545845](https://developer.qcloudimg.com/http-save/yehe-11910509/61a81bffa5cea0ffda5bd8edd90fdde7.png)
然后下载等待安装完成即可，后面开始配置qt
# 3. qt配置MSVC编译器

打开`Qt Creator`，进去kits，添加msvc编辑器
![image-20250606105228250](https://developer.qcloudimg.com/http-save/yehe-11910509/aa54a51897929cd9fff7681e1451485a.png)
![image-20250606110106001](https://developer.qcloudimg.com/http-save/yehe-11910509/ab981a01a9fc3c7caa2d2322466ff70c.png)
以上则已配置完成
# 4. 测试

配置时则可选择刚才配置好的MSVC编译器
![image-20250606110735945](https://developer.qcloudimg.com/http-save/yehe-11910509/fefa9b9ba8bda326d42852f2410b4f0b.png)
# 5. 注意

我这边编译时出了又出了两个问题：（大家若也遇到给大家参考下）
### 5.1 问题1

编译时出现版本问题：QMAKE_MSC_VER，这是msvc版本切换时没对应上
![image-20250606111140012](https://developer.qcloudimg.com/http-save/yehe-11910509/947b0c42b81eb048cdeee82d533f1e9c.png)
解决方法：
找到对应qt版本目录下common文件夹下的msvc-version.conf文件添加自己msvc的版本号：
![image-20250606111734381](https://developer.qcloudimg.com/http-save/yehe-11910509/4075f667a6b5daedb3f5f30d65c975ec.png)
![image-20250606111923501](https://developer.qcloudimg.com/http-save/yehe-11910509/3a40b05a1652891fd401f8958ef685ba.png)

`QMAKE_MSC_VER = 1920`我用的2019对应的是1920：下面几个版本可以参考
```
    # MSVC 2022 (v143)
 &nbsp;  QMAKE_MSC_VER = 1930
 &nbsp; &nbsp;
 &nbsp;  # MSVC 2019 (v142)
 &nbsp;  # QMAKE_MSC_VER = 1920
 &nbsp; &nbsp;
 &nbsp;  # MSVC 2017 (v141)
 &nbsp;  # QMAKE_MSC_VER = 1910
```改完保存重新编译即可
### 5.2 问题2

编译时遇到编码格式问题：
 warning: C4819: 该文件包含不能在当前代码页(936)中表示的字符。请将该文件保存为 Unicode 格式以防止数据丢失
error: C2001: 常量中有换行符
解决方法：
QT界面菜单栏->编辑->Slect Encoding...->system>按编码保存
![image-20250606114927700](https://developer.qcloudimg.com/http-save/yehe-11910509/96a460d44d8ed5d4efd493e06b925620.png)

# 四、总结

在Windows平台开发Qt蓝牙应用时，必须使用MSVC编译器而非MinGW，通过安装匹配版本的Visual Studio和Windows SDK，并在Qt Creator中正确配置MSVC工具链，可解决"qt.bluetooth: Dummy backend running"问题。开发过程中需注意版本匹配和文件编码问题，建议采用UTF-8 with BOM编码格式以确保项目顺利编译运行。

以上参考博客： [Qt 添加MSVC2017编译器（2022年保姆级教程，不安装完整VS）_qt msvc2017-CSDN博客](https://blog.csdn.net/Copperxcx/article/details/122540629)
[关于 Qt使用MSVC版本编译出现“QMAKE_MSC_VER” 的解决方法_qmake msc ver-CSDN博客](https://blog.csdn.net/qq21497936/article/details/116544980)
[qt.bluetooth: Dummy backend running. Qt Bluetooth module is non-functional | Qt Forum](https://forum.qt.io/topic/154215/qt-bluetooth-dummy-backend-running-qt-bluetooth-module-is-non-functional/9)
[[解决方法]C++ : warning C4819: 该文件包含不能在当前代码页(936)中表示的字符-CSDN博客](https://blog.csdn.net/a924282761/article/details/123513541)
[解决VS编译中文报错 error C2001:常量中有换行符_vs编译 error c2001: 常量中有换行符-CSDN博客](https://blog.csdn.net/love_0_love/article/details/120024094)

qt版本：6.5.3蓝牙不可用：qt.bluetooth: Dummy backend running. Qt Bluetooth module is non-functional.

Qt Debug——qt.bluetooth Dummy backend running.Qt Bluetooth module is non-function

在Windows平台开发Qt蓝牙应用时，必须使用MSVC编译器而非MinGW，通过安装匹配版本的Visual Studio和Windows SDK，并在Qt Creator中正确配置MSVC工具链，可解决"qt.bluetooth: Dummy backend running"问题。开发过程中需注意版本匹配和文件编码问题，建议采用UTF-8 with BOM编码格式以确保项目顺利编译运行。

编程语言

开发工具

客户端

解决Qt蓝牙模块报错"Dummybackendrunning"问题：Windows开发需使用MSVC编译器而非MinGW。安装对应版本VisualStudio和WindowsSDK，配置QtCreator工具链，注意版本匹配和UTF-8编码设置。提供详细步骤解决编译时的版本不匹配和中文编码问题，确保Qt蓝牙功能正常运行。

数据丢失

编译器

Windows

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

解决Qt蓝牙模块报错"Dummybackendrunning"问题：Windows开发需使用MSVC编译器而非MinGW。安装对应版本VisualStudio和WindowsSDK，配置QtCreator工具链，注意版本匹配和UTF-8编码设置。提供详细步骤解决编译时的版本不匹配和中文编码问题，确保Qt蓝牙功能正常运行...

Qt Debug——qt.bluetooth Dummy backend running.Qt Bluetooth module is non-function-腾讯云开发者社区-腾讯云

Qt Debug——qt.bluetooth Dummy backend running.Qt Bluetooth module is non-function

Qt Debug——qt.bluetooth Dummy backend running.Qt Bluetooth module is non-function

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐