Windows 11下使用mosaicshapes处理图片报错求助（Python已安装）

一、前置检查 #

• 确认Python版本：打开命令提示符（Win+R输入cmd），执行python --version，确保版本在3.6以上，版本过低请先升级。
• 确认pip可用：执行pip --version，能正常输出版本信息即可。

二、获取项目代码 #

• 方法1（有Git）：打开命令提示符，切换到目标存储文件夹（比如cd D:\MyProjects），执行git clone https://github.com/helenst/mosaicshapes.git。
• 方法2（无Git）：直接去项目页面下载zip压缩包，解压到本地任意非系统盘文件夹（比如D盘）。

三、配置独立环境（避免依赖冲突） #

1. 进入项目文件夹：执行cd mosaicshapes（路径根据你实际的解压/克隆位置调整）。
2. 创建虚拟环境：执行python -m venv venv。
3. 激活虚拟环境：执行venv\Scripts\activate，命令行开头出现(venv)标识即为激活成功。

四、安装依赖包 #

在激活的虚拟环境中执行：
pip install -r requirements.txt
如果出现单个包安装失败，可单独安装核心依赖：
pip install numpy pillow

五、运行代码处理图片 #

1. 将需要处理的图片放到项目文件夹中，重命名为简单英文名称（比如myphoto.jpg）。
2. 执行基础处理命令：
   python mosaicshapes.py --input myphoto.jpg --output result.jpg
3. 可选参数调整（参考项目说明）：
   比如生成圆形马赛克：python mosaicshapes.py --input myphoto.jpg --output circle_result.jpg --shape circle --size 30

六、常见错误解决 #

• ModuleNotFoundError：提示缺失模块，重新执行pip install -r requirements.txt，或单独安装报错里提到的模块。
• PermissionError：右键命令提示符选择「以管理员身份运行」，或把项目移到非系统盘（如D盘）。
• 图片读取失败：确保输入图片路径无中文、格式为jpg/png等常见格式，路径要准确。
• 虚拟环境激活失败：若用PowerShell，先执行Set-ExecutionPolicy RemoteSigned（按提示选Y），再激活环境。

内容的提问来源于stack exchange，提问作者RogerSwords