# pyside6_qml_serialport_demo

**Repository Path**: kid-kid/pyside6_qml_serialport_demo

## Basic Information

- **Project Name**: pyside6_qml_serialport_demo
- **Description**: pyside6+qml+serialport+charview+自定义控件
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-09
- **Last Updated**: 2026-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PySide6 /QML +QtCreator预览开发项目流程

---

本项目目的是采用QtCreator进行qml可视化开发，然后逻辑使用pyside6实现，这样以免每次都要运行项目才能看到

qml实际效果，提高开发效率。

![1767946077894](image/README/1767946077894.png)

**文件夹说明：**

**📦1.pyside6_qml_ui_prototype_demo（推荐） :**

    pyside+qml+Qt Quick UI Prototype项目，轻量化预览qml效果，相对方便。

**📦2.pyside6_qml_application_demo   :**

    pyside+qml+QtQuick Application项目，使用QtQuick Application C++项目来预览，可以观察整个效果

---

**备注：如果是只是想布局简单的预览效果可以使用Creator新建Quick UI Prototype这种格式的项目。如下图所示：这种可以静态的显示效果，但是用到ChartView等高级组件只预览不运行是没问题的，运行的话程序会崩溃，需要创建完整的QtQcuik项目。**

---

## 方法一：Qt Quick UI Prototype预览（推荐，简单明了）


#### 1.创建Qt Quick UI Prototype项目


#### 2.添加文件并修改路径

自己的项目文件直接拷贝到工程目录下，Creator会自动加载，主文件换成自己的主文件路径即可


#### 3.预览编辑与运行

打开Main.qml后即可选中设计器打开就能看到预览的效果


Ctrl+R也能看到运行效果，这里注意如果用到了类似ChartView等高级组件就要创建完整的QtQuick项目了。


如果是只是想布局简单的预览效果可以使用Creator新建Quick UI Prototype这种格式的项目。如下图所示：这种可以静态的显示效果，但是用到ChartView等组件运行的话程序会崩溃。


**✅ 总结：这种方式只需要2部，1.拷贝文件夹到项目下、2.修改主文件路径即可**

---

## 方法二：Qt Quick Application预览

### 1.创建Qt Quick Application项目


### 2.添加文件并修改路径

**⚠️ ！！！切记：自己的qml文件名首字母一定要大写否则识别失败，自定义控件首字母也尽量大写。**

**⚠️ ！！！切记：自己的qml文件名首字母一定要大写否则识别失败，自定义控件首字母也尽量大写。**

**⚠️ ！！！切记：自己的qml文件名首字母一定要大写否则识别失败，自定义控件首字母也尽量大写。**


### 另外需要关注的点：

#### 1.根据项目可以添加自己需要的包：


#### 2.自定义控件预览问题

在 Qt Designer 中预览自定义控件时，由于使用的是相对路径引用图像资源，可能导致无法正常显示。这是已知限制，可以考虑放在相同目录这样引用可以实时预览，或者采用资源文件的方式（后续验证一下）。


## 其他：

新建Qt for python项目这种方式已经没办法实时预览了，推荐方法一或者方法二。