# zcy_pyqt5_template

**Repository Path**: modelview/zcy_pyqt5_template

## Basic Information

- **Project Name**: zcy_pyqt5_template
- **Description**: 使用 uv 管理的 pyqt5 程序模板，添加了 qt-material 样式，并可以使用 pyinstaller 同时发布到 windows10 和 银河麒麟V10 环境，正确支持中文输入法。
不同环境采用了对应的环境变量。使用时优先修改 pyproject.toml 文件中的文件名
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# README

## linux（kylinV10）环境下使用模板

- 复制代码下来
- 执行 `./init_project.sh`
- 填写 项目名称，确认即可，否则项目名称需要手动修改

## linux（kylinV10）环境下运行

- 因为是基于pyqt5的，输入法只有这个环境可用
- 所以pyinstaller的路径不能包含中文，因此程序本身所在路径不能包含中文
- pyinstaller打包之后的文件运行路径也不能包含中文，可以考虑用软连接目录
- 输入法也必须在没有中文的目录中才能识别。
- .venv 中要复制对应的插件，否则调试的时候没有输入法

## 使用 uv 虚拟环境运行

- 激活环境
- `source ./.venv/bin/activate`
- 在有括号的环境中运行
- `python main.py`
- 退出环境
- `deactivate`

## 初始化项目名称

- 替换全部的 `zcy_pyqt5_template` 为对应的项目名称，如：`doc_project`
- 删除 .venv 和 uv.lock 并重新运行 `uv sync`