How To Develop Cross-Platform GUI Programs with PySide6

1. In-Depth Comparison of PySide and PyQt: Choose the Right Tool for Fewer Detours

In the field of Python cross-platform GUI development, PySide and PyQt are two mainstream tools. Many beginners often fall into the dilemma of choosing between them when starting out. In fact, the two are essentially homologous with almost no differences in core functions, but the difference in license agreements directly determines the adaptability of development scenarios, which is also the key to selection.

From the perspective of underlying logic, both PySide and PyQt are Python bindings for the Qt framework, meaning they both rely on Qt’s powerful capabilities to realize the development of graphical interfaces. The two have an extremely high degree of functional overlap, with a code compatibility rate of over 95%. Whether developing basic GUI components such as windows, buttons, and message boxes, or realizing cross-platform operation, both can perform perfectly, with almost no difference in user experience.

The core difference lies in the licensing model: PySide is an officially maintained tool by Qt, adopting the LGPL open-source license, which is completely free to use. Even for closed-source commercial projects, no fees are required, with full compatibility and compliance; PyQt is maintained by a third-party team, with relatively strict license agreements. For closed-source commercial scenarios, you must pay to purchase a license, which is the core reason why most developers prefer PySide. For personal development, startup projects, or enterprise development pursuing cost control, PySide is undoubtedly a better choice.

2. Preparations: Full Steps for PySide6 Environment Setup

Before starting development, you need to complete the installation and environment verification of the PySide6 library to ensure that the development tools can call related functions normally. Taking VS Code as an example, the following details the environment setup process, and the operation logic of other editors is similar.

1. Open the development tool and terminal: After launching VS Code, click “View” in the top menu bar, select “Terminal” to bring up the command line window; if using a virtual environment, activate the corresponding Python virtual environment first to avoid affecting the global environment configuration.
2. Verify if PySide6 is installed: Enter the command “pip show PySide6” in the terminal. If the terminal returns information such as the version and installation path of PySide6, it means it has been successfully installed; if it prompts “WARNING: Package(s) not found: pyside6“, you need to perform the installation operation.
3. Install the PySide6 library: Enter the command “pip install PySide6” in the terminal, wait for the pip tool to automatically download and install the latest version of the PySide6 library. After the installation is complete, it will prompt “Successfully installed pyside6-xxx” (xxx is the specific version number).
4. Uninstallation and version management (optional): To uninstall PySide6, enter the command “pip uninstall PySide6” and enter “y” as prompted to confirm; to install a specified version, enter “pip install pyside6==version number” (e.g., pip install pyside6==6.5.2).

3. Step-by-Step Development: PySide Hello World Pop-Up Program

This time, we will develop a basic GUI program to realize window display and button click pop-up functions. The steps are clear throughout, and beginners can follow the actual operation directly to quickly master the basic usage of PySide.

1. Import required libraries and modules: Create a new Python file (named hello_pyside.py), first import the sys library (for program exit control), then import QApplication, QMainWindow, QPushButton, QVBoxLayout, QWidget, QMessageBox from PySide6.QtWidgets (corresponding to application, main window, button, vertical layout, container, message box respectively), and finally import Qt from PySide6.QtCore (for calling Qt-related constants).
2. Define the main window class: Create the HelloWorldWindow class, inherited from QMainWindow (Qt’s main window component), and complete the basic window configuration in the class’s initialization method (__init__). First call the parent class initialization method, then set the window title to “Hello PySide6”, and set the window size and position (e.g., resize(400, 300) to set width and height, move(500, 300) to set the display position on the screen).
3. Create layout and button components: In the main window class, first create a QWidget container as the central widget, then create a QVBoxLayout vertical layout (to ensure the components are displayed in the center), and bind the layout to the container. Next, create a QPushButton, set the button text to “Click Me“, and fix the button size through setFixedSize(100, 40) to avoid adaptive deformation.
4. Bind button click event: Define the show_message method. In the method, call QMessageBox.information() to create a pop-up window, set the pop-up title to “Prompt“, the pop-up content to “Hello, PySide“, and the parent component of the pop-up to the current window. Then bind the button click event to the show_message method through the button’s clicked.connect() method to realize the effect of triggering the pop-up window by clicking the button.
5. Add components to the layout: Add the created button to the vertical layout, then set the central widget as the central component of the window to ensure the button is displayed in the center of the window.
6. Write the program entry: Add the main function logic at the end of the file, judge whether the current module is the main module (if __name__ == “__main__”:), then create a QApplication object (receive sys.argv parameters for processing command-line parameters), instantiate the HelloWorldWindow class to get the window object, call window.show() to display the window, and finally start the application main loop through sys.exit(app.exec()), wait for user events (such as clicking buttons, closing windows), and exit the program normally when the window is closed.

4. Program Operation and Function Verification, Troubleshooting Common Problems

After the program is written, it is necessary to run and verify whether the function is normal, and master the troubleshooting methods of common problems to ensure a smooth development process.

1. Run the program: In VS Code, right-click the blank area of the file, select “Run Python” or “Run Python in Terminal“. After starting the program, a window titled “Hello PySide6” will pop up, with a “Click Me” button displayed in the center of the window.
2. Function verification: After clicking the button, a prompt pop-up window will appear, displaying “Hello, PySide”. Click the “OK” button in the pop-up window to close it; click the close button in the upper right corner of the window, the program will exit normally, and there will be no error messages in the terminal, indicating that the function is normal.
3. Troubleshooting common problems: If a module import error is prompted during operation, check whether PySide6 is installed successfully or whether the virtual environment is activated; if the window cannot be displayed, confirm whether the window.show() method is called; if the button click has no response, check whether the event binding is correct (whether the parameter of the clicked.connect() method is the target function).

5. Advanced Learning Directions for PySide to Strengthen GUI Development Capabilities

After mastering the development of basic Hello World programs, you can advance your learning in multiple directions to improve your PySide development capabilities. For example, in-depth learning of Qt layout management (such as horizontal layout, grid layout) to realize more complex interface layout; learning signal and slot mechanism to realize interaction logic between components; exploring advanced components of PySide (such as text boxes, list boxes, menus) to develop more comprehensive functions; at the same time, combining cross-platform characteristics, test program compatibility in Windows, macOS, Linux systems, and optimize operation effects. For commercial development, focus on the details of the LGPL license to ensure compliant use of the program.

6. Demo Video

You can watch the following demo video by select the subtitle to your preferred subtitle language.