【PySide6】Qt 实战-串口调试助手-搭建开发环境（1）

简介

本系列教程属于 Qt 实战系列，串口调试助手在嵌入式调试中非常有用，本教程会一步步实现一个简易的调试助手。

基于这个项目的所使用的技术，可进一步扩展为自定义串口、USB、TCP上位机等开发。

本教程将会从简单的写法开始，先注重实现功能，然后从功能方面解耦，将此项目逐步完善。

安装 Python 环境

几种安装方式的比较

安装 Python 环境有以下几种方式：

1. 直接下载 Python 安装包，安装后使用，这种方式较为简单，不再赘述；
2. 安装 Python 后，通过 virtualenv 创建虚拟环境，在虚拟环境中进行项目的开发，这种方式相对于第一种更进一步，好处是项目之间的第三方包不会相互干扰，为单独的项目提供了独立稳定的依赖环境，但 virtualenv 仍然是基于本地安装的 Python 去创建，本地的 Python2 是无法创建 Python3 的虚拟环境的，当然，版本也一定是相同的；
3. 使用 Conda 管理 Python 环境，这是笔者目前比较喜欢的管理方式，Conda 不需要本地的 Python 环境，只需要安装 Conda，然后通过 Conda 创建虚拟环境，可以创建 Python2 环境，也可以创建 Python3 环境，也可创建不同版本的 Python 环境，不同的环境也可安装不同的第三方包；

建议读者亲自尝试各种方法，以上也只是笔者个人尝试后的总结，不正之处请指出，实践才是检验真理的唯一标准。

这里我基于 Conda 实现后续的教程，Conda 有完整版和 Mini 版本，具体完整版多了哪些功能，我不太清楚，测试下来 Mini 版本完全够用，并且软件体积较小。

下载地址

国内下载地址：清华大学开源镜像站

Conda 安装的坑

Windows下通过图形界面进行安装，这里有个坑笔者曾经遇到过，就是安装界面上会出现一个添加 Conda 到环境变量的选项，我当时勾选了这个选项后安装，然后我的系统环境变量就只剩下了 Conda 相关的变量，其他的变量都消失了，因此我在安装的时候，取消了这个选项，然后手动将 Conda 安装路径下 Scripts 路径添加到环境变量。不知道现在最新的 Conda 是否还有这个问题。

Conda 初始化

安装完毕后，首次在控制台使用 Conda 时，需要执行 conda init ，打开 Powershell，执行初始化指令可能会遇到系统禁止运行脚本的错误，这由于 Conda 在启动时会自动执行初始化脚本，而 Powershell 默认（可能是基于安全考虑）禁止运行脚本，因此需要设置一下安全策略，详见 【PowerShell】错误：在此系统上禁止运行脚本

设置完毕后需要重启控制台，当地址提示符最前端出现 (base) 字样即为 conda 启动成功， base 代表 conda 默认创建的一个环境，可以直接使用，也可自己再新建其他虚拟环境。

测试 Python 环境

进入交互式 Python 控制台，测试 Python 版本及基本使用：

(base) PS C:\> python
Python 3.12.4 | packaged by Anaconda, Inc. | (main, Jun 18 2024, 15:03:56) [MSC v.1929 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> print("hello conda")
hello conda
>>>

新建虚拟环境

创建一个名字为 pyside 的虚拟环境，并安装 python3，按照提示输入 y 继续。

(base) PS C:\> conda create -n pyside python=3
Retrieving notices: ...working... done
Channels:
 - defaults
Platform: win-64
Collecting package metadata (repodata.json): done
Solving environment: done

## Package Plan ##

  environment location: E:\miniconda\envs\pyside

  added / updated specs:
    - python=3


The following packages will be downloaded:

    package                    |            build
    ---------------------------|-----------------
    setuptools-72.1.0          |  py312haa95532_0         2.9 MB
    ------------------------------------------------------------
                                           Total:         2.9 MB

The following NEW packages will be INSTALLED:

  bzip2              pkgs/main/win-64::bzip2-1.0.8-h2bbff1b_6
  ca-certificates    pkgs/main/win-64::ca-certificates-2024.7.2-haa95532_0
  expat              pkgs/main/win-64::expat-2.6.2-hd77b12b_0
  libffi             pkgs/main/win-64::libffi-3.4.4-hd77b12b_1
  openssl            pkgs/main/win-64::openssl-3.0.14-h827c3e9_0
  pip                pkgs/main/win-64::pip-24.0-py312haa95532_0
  python             pkgs/main/win-64::python-3.12.4-h14ffc60_1
  setuptools         pkgs/main/win-64::setuptools-72.1.0-py312haa95532_0
  sqlite             pkgs/main/win-64::sqlite-3.45.3-h2bbff1b_0
  tk                 pkgs/main/win-64::tk-8.6.14-h0416ee5_0
  tzdata             pkgs/main/noarch::tzdata-2024a-h04d1e81_0
  vc                 pkgs/main/win-64::vc-14.2-h2eaa2aa_4
  vs2015_runtime     pkgs/main/win-64::vs2015_runtime-14.29.30133-h43f2093_4
  wheel              pkgs/main/win-64::wheel-0.43.0-py312haa95532_0
  xz                 pkgs/main/win-64::xz-5.4.6-h8cc25b3_1
  zlib               pkgs/main/win-64::zlib-1.2.13-h8cc25b3_1


Proceed ([y]/n)? n

安装完毕后，我系统上的虚拟环境如下，我们后续将在 pyside 这个虚拟环境下进行 PySide 的学习，使用 conda activate pyside 来激活这个虚拟环境。

(base) PS C:\> conda env list
# conda environments:
#
base                  *  E:\miniconda
pyside                   E:\miniconda\envs\pyside