Enviroment on 双生介の个人博客

Qt环境配置

Sun, 17 Nov 2024 23:45:48 +0800

Qt环境配置

本文主要对Windows + WSL的Qt环境配置进行说明。代码编辑工具对VScode和Clion进行了说明，理论上来说使用nvim等其他支持cmake的工具也可以进行配置，但不在此处进行说明（~~因为真的没有用过~~）。另外本文仅针对Qt Widgets进行说明。

Windows环境配置

基础环境配置

在下列网址下载Qt 非商用版本在线安装包，选择对应的系统及CPU架构进行下载。

https://www.qt.io/download-qt-installer-oss

下载后运行并输入在Qt官网注册的账号和密码后。阅读协议并根据个人情况进行勾选或输入公司名称。

配置Qt的安装路径并选择自定义安装。

根据个人需求选择Qt的版本及相关的编译工具。如果需要安装Qt5需要选中右侧筛选器的Archive选项。如果在这一步安装了不需要的工具链或者少装了所需的工具链，后续可在Qt Maintenance Tool中进行安装或者删除，基本流程与安装类似。对于Windows平台最好在 Developer and Designer Tools 处将对应的工具链勾选一起安装。cmake和ninja-build如果已经安装可以不勾选。

📌 重要

在Windows中使用mingw工具链时最好使用Qt安装工具安装对应的mingw工具链而不是选择自行下载类似w64devkit之类的发行版。就算已经自行安装了gcc、g++工具，最好也使用Qt Maintenance Tool安装一个对应的mingw版本。在安装的时候需要注意保持 Qt 中选择的mingw版本与 Developer and Designer Tools 中勾选的mingw版本保持一致。

确认并勾选已阅读协议，点击Next进行安装并等待完成。至此Qt已经安装完成。

VScode配置

如果不想使用Qt Creator进行代码编辑，可以在使用QC创建完工程后使用VScode打开。

如果需要使用VScode进行Qt开发，需要在VScode中搜索并安装Qt C++ Extension Pack。

之后用 ctrl + shift + p 打开VScode的命令面板，并在其中搜索：Qt Register Qt Installation，并将该路径配置到Qt的安装路径下。如果路径配置正确，Qt将自动添加对应的gcc、g++、ninja等工具链。

📌 重要

在VScode中配置Qt的安装路径时需要注意将路径选择到Qt文件夹中。例如：在Qt安装时选择在D:\Dev_Tools\Qt路径下，在VScode中进行配置的时候也需要选择到D:\Dev_Tools\Qt，而不能只选择到D:\Dev_Tools。

最后最好在QC生成的CMakeLists.txt文件中加入以下语句：

1
2
3
4
5


# 假设Qt的安装路径为 D:/Dev_Program/Qt ，并且创建的工程使用的是5.15.2版本的mingw8.1 64位工具链
set(CMAKE_PREFIX_PATH "D:/Dev_Program/Qt/5.15.2/mingw81_64")

# 如果不进行该项配置，在不能在Terminal中读取到qDebug()的消息。
set(<PROJECT-NAME> PROPERTIES WIN32_EXECUTABLE FALSE)

配置完成后即可在VScode中进行Qt的项目开发。

Clion配置

如果不想使用QC或者VScode进行开发，也可以使用Clion进行开发。配置Clion中的Qt环境可遵循以下步骤:

在创建工程的时候选择Qt的版本及对应的工具链。

图示为使用Qt 5.15.2 mingw8.1的工具链进行开发。这一步相当于在配置CMakeLists.txt中Cmake预设的路径。

在 Build,Execution,Deplotment -> Toolchains 中配置好与Qt一起安装的工具链的位置。图示为Qt Maintenance Tool在 D:\Dev_Program\Qt\ 路径下与Qt一起安装的mingw的位置。

在 Tools -> External Tools 中点击新建，添加Qt Designer如下图。Qt Designer用于使用GUI工具对ui文件进行编辑。

这一步可选。在 Tools -> External Tools 中点击新建，添加UIC工具。UIC工具用于将ui文件转换为cpp头文件。但是实测在Clion 2024.2中就算不在编译前使用该工具进行转换，也可以正常编译。在Clion中创建新的Qt UI Class后虽然会出现头文件报错，但是在将该类添加到CMakeLists.txt后进行构建，就可以消除该错误。

1
2


Arguments: $FileName$ -o ui_$FileNameWithoutExtension$.h
Working directory: $ProjectFileDir$

在使用Clion做Qt项目的时候，一般不需要额外对CMakeLists.txt进行修改，一般来说可以直接运行。只需要在CMakeLists.txt添加自己创建的Qt类即可。

WSL配置（Linux配置）

基础环境配置

事前准备：

1
2
3


sudo apt-get update && sudo apt-get upgrade -y
sudo apt update && sudo apt upgrade -y
sudo apt install gdb build-essential cmake ninja-build git -y

在下列网址下载Qt 非商用版本在线安装包，选择对应的系统及CPU架构进行下载。

https://www.qt.io/download-qt-installer-oss

下载后的文件为 qt-online-installer-linux-xxx-xxx.run 的格式。在WSL中打开该文件的路径并运行。

1
2
3
4
5
6


chmod +x qt-online-installer-linux-xxx-xxx.run

sudo ./qt-online-installer-linux-xxx-xxx.run

# 如果不能运行，检查所缺少的依赖项
ldd ./qt-online-installer-linux-xxx-xxx.run

与Windows中的基础环境配置的步骤类似，Linux的默认安装路径是/opt/Qt，此处个人没有修改，保持默认设置。

如果使用的是Linux单系统或者只想要在WSL中做Qt开发，可以参考Windows基础环境配置部分进行选择，对于已经安装过的ninja、cmake可以不用勾选。如果已经在Windows中配置安装过Qt，可以参考下图，并根据各人的需求进行选择，在WSL中不需要安装Qt Designer和Qt Creator。

点击Next并等待Qt安装完成。安装完成后Qt的安装路径为 /opt/Qt/。该路径后续将用于配置工具链等。

VScode WSL配置

使用VScode在WSL中开发需要在VScode中连接WSL后搜索并在WSL中安装Qt C++ Extension Pack。
用 ctrl + shift + p 打开VScode的命令面板，并在其中搜索：Qt Register Qt Installation，并将该路径配置到Qt的安装路径下（/opt/Qt）。
使用Windows的QC创建一个Qt工程，并用WSL打开该工程的路径，在CMakeLists.txt中添加如下代码

1
2


# 假设Qt的安装路径为 /opt/Qt ，并且创建的工程使用的是5.15.2版本的gcc工具链
set(CMAKE_PREFIX_PATH "/opt/Qt/5.15.2/gcc_64")

如果需要在多个平台使用同一套代码，可以将上面的语句替换为下面的语句：

1
2
3
4
5
6
7
8
9


# 假设Qt的Windows安装路径为 D:/Dev_Program/Qt ，并且创建的工程使用的是5.15.2版本的mingw8.1 64位工具链
# 假设Qt的WSL安装路径为 /opt/Qt ，并且创建的工程使用的是5.15.2版本的gcc工具链
if(WIN32)
 set(CMAKE_PREFIX_PATH "D:/Dev_Program/Qt/5.15.2/mingw81_64")
 set(untitled PROPERTIES WIN32_EXECUTABLE FALSE)
endif(WIN32)
if(LINUX)
 set(CMAKE_PREFIX_PATH "/opt/Qt/5.15.2/gcc_64")
endif(LINUX)

之后，即可使用VScode在WSL中开发Qt Linux程序。

开发的时候如果需要使用ui文件和Qt designer，可以使用VScode插件调用WSL中的Designer进行界面开发，也可以使用Windows中的Qt designer进行配置。

Clion配置

在 Build,Execution,Deplotment -> Toolchains 中配置一个WSL工具链，如图所示。

按照正常的正常的Windows中Clion新建Qt项目的流程先创建一个项目，然后将CMakeLists.txt中的 CMAKE_PREFIX_PATH 配置修改为WSL中的Qt安装路径。

1

set(CMAKE_PREFIX_PATH "/opt/Qt/5.15.2/gcc_64/")

或者也可以像VSCode中一样配置两个平台的Cmake预设路径。

1
2
3
4
5
6
7
8
9


# 假设Qt的Windows安装路径为 D:/Dev_Program/Qt ，并且创建的工程使用的是5.15.2版本的mingw8.1 64位工具链
# 假设Qt的WSL安装路径为 /opt/Qt ，并且创建的工程使用的是5.15.2版本的gcc工具链
if(WIN32)
 set(CMAKE_PREFIX_PATH "D:/Dev_Program/Qt/5.15.2/mingw81_64")
 set(untitled PROPERTIES WIN32_EXECUTABLE FALSE)
endif(WIN32)
if(LINUX)
 set(CMAKE_PREFIX_PATH "/opt/Qt/5.15.2/gcc_64")
endif(LINUX)

配置完成后右键单击CMakeLists.txt选择Reload CMake Project。

在 Build,Execution,Deplotment -> CMake 中添加配置

如果需要使用ui文件可以跟Windows中一样操作（使用Windows中安装的Qt Designer进行配置）。

与Windows平台一样，只需要在CMakeLists.txt文件中添加自己的文件即可完成构建和调试。

Python安装及包管理

Thu, 27 Jun 2024 00:39:27 +0800

⚠️ 警告

该文初衷是作为给我两个非CS相关专业的同学作为引导，不一定适合CS相关专业的开发。目前个人更推荐安装一个基础的 Python 版本后使用 astral-sh.uv 作为包管理工具，但 pipenv 仍然也可以作为一个备选方案

01_Python安装及包管理

本文将主要就Windows操作系统和Linux操作系统中python的安装以及包管理相关操作进行说明。

Windows操作系统的Python安装

Python安装

安装纯Python是个人相对来说更推荐的方法。相较于Anaconda体积更小，使用命令直接操作也比较便捷。而且Anaconda存在商用版本和社区版的区别，虽然对个人开发者和研究人员可以使用社区版，但相较于Python而言存在一定的法律风险。而且Anaconda所占的硬盘空间也较多。~~总之个人十分不推荐，即便它算是Python最成功的包管理及Python环境管理软件。~~

首先，Python的安装包可以从下面的链接处下载：

Python安装包

请务必注意，虽然Windows自带的 Microsoft Store 中也可以搜到Python，但是一定不要从里面安装！！！

另外，虽然Windows现在可以使用winget进行类似Linux的软件安装，但是由于其默认的安装路径不可控，因此不推荐使用。

确定Python版本

在该页面下可以找到Python到目前为止的所有Windows系统的安装包。可以在该页面安装一些已经被Python官方停止支持的Python版本（部分项目会用到非最新的Python，有些上古项目甚至可能用到Python2）。

选择Python版本的时候可以选择一个与项目组匹配的Python版本，如果只是自学也可以只安装最新的Python版本（一般尽量选择稳定版本）。

选择完版本号后，还需要根据电脑的处理器架构选择正确的处理器版本。

在此以Python 3.12.4为例，一般选择 Windows installer(64-bit) ，点击后即开始下载。

安装

由于本人已经安装过Python3.12，故后续以Python3.11做示例，一般来说Python的安装过程不会因版本变化产生较大差别。

以管理员身份运行安装程序，将两个复选框勾选后点击Customize installation

除 for all user之外全部勾选，点击Next

勾选红框框中的4个复选框，并修改安装路径

由于本人使用的Python版本较少且C盘容量够大，一般建议在非系统盘的根目录建立单独的Python文件夹，在Python文件夹下再单独存放不同版本的Python。下面是一个示例

1
2
3
4
5


D:\Python
	├─Python311
	├─Python312
	├─........
	└─Python38

举个例子，本次安装的Python 3.11，在Customize install location中需要填入：

1

D:\Python\Python311

点击Install即可完成安装。

安装后的确认

按Win键搜索Powershell，输入Python，如果能够正确输出如图的版本号则安装成功。

若安装正确，则关闭当前窗口，或输入下面命令回车，即可退出。

1

quit()

如果未正确输出，请查看下一节中关于环境变量的说明进行修改。

多版本Python的安装及管理

如果需要安装多个版本的Python，一般按照上述内容，重复确定Python版本 –> 安装即可。

但是多个Python包安装后，其Python解释器的启动文件都叫python.exe，且这些多个版本的Python都在安装的时候选择了将各版本的python注册到系统的环境变量中。如果继续在Powershell中使用python来调用python可能就不能找到所需的Python版本。其解决方法已经被Python内置（安装时选择的 py launcher），其调用方法如下：

1

py

输入该指令后，py launcher将从系统环境变量中查找安装的Python版本。如果没有任何的参数输入，将调用默认的Python版本。

设置Python的默认版本的方法如下：

按win键搜索 “环境变量”
在弹出的窗口点击“环境变量(N)”

如果在安装的时候没有勾选 Install Python for all users，则python的环境变量应保存在上半框中的Path中；如果安装的时候勾选了Install Python for all users，则python的环境变量应保存在下班框中的Path中。（是否勾选需要所有python版本在安装时保持一致）
双击Path变量，可以看到如下界面。以下图为例，可以看到本机共安装了 Python 3.12 和 Python 3.11 两个版本，且Python3.12的两个相关变量位于Path中更靠前的位置。假设本机只安装了这两个Python版本，Path变量这样的排列这意味着：在这台机器如果使用只使用 py 指令而不加任何其他参数，系统将优先调用3.12版本的Python（直接输入python也将调用3.12版本）。如果需要将3.11设置为默认版本，则需要分别选中python311的两个相关路径，点击右侧的 Move Up，让两个python311变量均在python312之前，并点击ok进行保存（三层都要点ok），保存完后关闭已打开的powershell重新打开，输入py 或者python就会调用3.11版本的Python。

对于安装之后在Powershell中输入python无反应的情况，需要在上图所示界面将python路径加入：

python.exe所在的路径

pip.exe所在路径：python.exe所在路径的基础上加上"PYTHON_PATH\Scripts"

关于py的使用下面给一个较为简单的说明：

查看当前已成功安装的python版本：

1

py --list

使用该命令后，输出的log如下：

可以看到，示例电脑共安装了3.12、3.11、3.8三个python版本。想要调用具体版本的python，使用下面的命令：

1

py -V:VERSION

下面给三个具体的示例：

关于py指令的更多使用方法，使用如下命名查看：

1

py --help

pip包管理

一般来说，很多python教程都会在安装包的时候建议直接输入下列命令进行包的安装：

1
2
3
4
5
6
7


pip install PACKAGENAME

#If above command can't install package, use the command below
python -m pip install PACKAGENAME

#Recommend command
py -V:VERSION -m pip install PACKAGENAME

但是如果使用这个方法安装所有包，在不同的项目中很容易因为包过多、每个包之间的依赖关系等问题带来问题。因此强烈不建议使用pip安装所有的包。

但是，还是需要使用pip安装一些基础支持包和环境。

建议安装的包如下：

Package Name	Description
wheel	安装类似Numpy之类的使用.whl格式的Python包
pipenv	Python虚拟环境管理包

除这两个包之外，其他所有包都不建议直接使用pip安装，而是使用pipenv创建虚拟环境后在各项目的虚拟环境中单独安装。

安装上述的这两个包，请在Powershell中下面的两个命令：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


#Install wheel
pip install wheel
#If above command can't install package, use the command below
python -m pip install wheel
#Recommend command
py -V:VERSION -m pip install wheel

#Install pipenv
pip install pipenv
#If above command can't install package, use the command below
python -m pip install pipenv
#Recommend command
py -V:VERSION -m pip install pipenv

安装完成后，在Powershell中输入下一条命令：

1
2
3
4
5


pip list
#If above command can't install package, use the command below
python -m pip list
#Recommend command
py -V:VERSION -m pip list

输出的log如下所示：

版本不需要与此处所示的版本相同，只需要保证包已安装完成即可。

后续操作请转到共用操作出查看pipenv的具体使用及pip的相关指令。

Linux安装Python

Python安装

对于初次使用Linux使用的新手，不建议上来就开始配置多版本的Python环境，本文将只对单版本的Python安装进行解释。

一般的Linux发行版都会预装python，对于Linux可以先直接在bash中输入：

1

python3

查看是否安装了python，如果没有类似Windows的python环境显示出来，则需要使用下列命令进行安装（需要注意的时，接下来的操作都将使用到管理员权限，没有管理员密码将无法操作）：

1
2
3
4
5
6
7
8


#Debian \ Ubuntu
sudo apt-get install python3

#Arch Linux
sudo pacman -S python3

#Red Hat / Cent OS
sudo yum -y install python3

Linux 发行版一般不会预装pip，需要手动安装，安装pip的指令如下：

1
2
3
4
5
6
7
8


#Debian \ Ubuntu
sudo apt-get install python3-pip

#Arch Linux
sudo pacman -S python3-pip

#Red Hat / Cent OS
sudo yum -y install python3-pip

Linux环境下的Python包管理

与Windows使用pip直接安装包不同，Linux中Python包采用的不同的发行策略，一般都需要使用系统的包管理软件进行安装。因此，安装pipenv和wheel需要使用对应的包管理软件指令进行安装。

1
2
3
4
5
6
7
8


#Debian \ Ubuntu
sudo apt-get install pipenv python3-wheel

#Arch Linux
sudo pacman -S pipenv python3-wheel

#Red Hat / Cent OS
sudo yum -y install pipenv python3-wheel

安装完后，就可以使用pipenv进行环境配置了。

pipenv & pip

pipenv

pipenv是一个非常好用的python虚拟环境配置工具。这个工具可以实现为不同的工程设置不同的python版本、不同的python包依赖环境。同时对于Linux来说，还可以使用pip在虚拟环境中安装所需的python包，使得在Linux中需要使用的命令与Windows环境基本一致。

pipenv的官网如下：

关于pipenv的所有文档都在该网站。

或者也可以在Powershell或者bash中输入下面的命令以得到一些基础参数的提示：

1

pipenv --help

该命令的输出log如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70


Usage: pipenv [OPTIONS] COMMAND [ARGS]...

Options:
 --where Output project home information.
 --venv Output virtualenv information.
 --py Output Python interpreter information.
 --envs Output Environment Variable options.
 --rm Remove the virtualenv.
 --bare Minimal output.
 --man Display manpage.
 --support Output diagnostic information for use in
 GitHub issues.
 --site-packages / --no-site-packages
 Enable site-packages for the virtualenv.
 [env var: PIPENV_SITE_PACKAGES]
 --python TEXT Specify which version of Python virtualenv
 should use.
 --clear Clears caches (pipenv, pip). [env var:
 PIPENV_CLEAR]
 -q, --quiet Quiet mode.
 -v, --verbose Verbose mode.
 --pypi-mirror TEXT Specify a PyPI mirror.
 --version Show the version and exit.
 -h, --help Show this message and exit.


Usage Examples:
 Create a new project using Python 3.7, specifically:
 $ pipenv --python 3.7

 Remove project virtualenv (inferred from current directory):
 $ pipenv --rm

 Install all dependencies for a project (including dev):
 $ pipenv install --dev

 Create a lockfile containing pre-releases:
 $ pipenv lock --pre

 Show a graph of your installed dependencies:
 $ pipenv graph

 Check your installed dependencies for security vulnerabilities:
 $ pipenv check

 Install a local setup.py into your virtual environment/Pipfile:
 $ pipenv install -e .

 Use a lower-level pip command:
 $ pipenv run pip freeze

Commands:
 check Checks for PyUp Safety security vulnerabilities and against
 PEP 508 markers provided in Pipfile.
 clean Uninstalls all packages not specified in Pipfile.lock.
 graph Displays currently-installed dependency graph information.
 install Installs provided packages and adds them to Pipfile, or (if no
 packages are given), installs all packages from Pipfile.
 lock Generates Pipfile.lock.
 open View a given module in your editor.
 requirements Generate a requirements.txt from Pipfile.lock.
 run Spawns a command installed into the virtualenv.
 scripts Lists scripts in current environment config.
 shell Spawns a shell within the virtualenv.
 sync Installs all packages specified in Pipfile.lock.
 uninstall Uninstalls a provided package and removes it from Pipfile.
 update Runs lock, then sync.
 upgrade Resolves provided packages and adds them to Pipfile, or (if no
 packages are given), merges results to Pipfile.lock
 verify Verify the hash in Pipfile.lock is up-to-date.

一般来说，比较常用的命令有：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


#Use Default python version to create a virtual enviroment
pipenv install

#Use python VERSION to create a virtual enviroment
pipenv --python VERSION

#Open a shell in virtual enviroment
pipenv shell

#Already used "pipenv shell" command, want to quit this virtual enviroment
exit

#Remove virtual enviroment in current path
pipenv -rm

#Show all package in this virtual enviroment
pipenv graph

其中需要特别提出的是，当使用了"pipenv shell"命令后，只要还没有使用"exit"，则在该环境中可以使用pip安装python包（不论是Windows还是Linux）。

此处列出的仅仅只是pipenv极基础的用法，更多用法建议参考pipenv手册（Linux中使用 “man pipenv"或查看本节中列出的两个链接）。

pip

上文实际上已经提及了pip的安装命令，本节将主要就pip安装包、卸载包、更新包、导出当前依赖包列表、pip自更新进行解释。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


#Install a package
#Only recommend in a virtual enviroment
pip install PACKAGENAME

#Uninstall a package
#Only recommend in a virtual enviroment
pip uninstall PACKAGENAME

#List all package in current enviroment
pip list
#For a specific version python 
py -V:VERSION -m pip list

#Only recommend in a virtual enviroment
python -m pip install –-upgrade PACKAGENAME

#Update pip
py -V:VERSION -m pip --uppgrade pip

#Freeze current pip package enviroment in requirements.txt at CURRENT PATH
#Only recommend in a virtual enviroment
#Use "pipenv shell" before using this command
pip freeze > requirements.txt

#Unfreeze a pip package enviroment from requirements.txt at CURRENT PATH
#Only recommend in a virtual enviroment
#Use "pipenv shell" before using this command
pip install -r requirements.txt

#For help
pip --help

上面已经包含了一些常用的pip命令。这些命令不强求需要记住，只需要有一个大概的了解。在使用PyCharm进行开发的时候这些操作都可以使用图形化界面进行配置。但是还是需要有个印象，因为如果不使用PyCharm等现代IDE做项目开发的时候，或者极小可能的情况下IDE或网络抽风的情况下，只能使用命令行做应急的时候还是需要这些命令的。