Python解决Fatal error in launcher错误及PyInstaller打包配置指南

解决Fatal error in launcher错误

在Python终端执行pip list命令时，若遇到Fatal error in launcher:错误提示，通常意味着pip执行环境与当前Python解释器路径不匹配。

解决该问题的核心方法是，在终端中所有涉及pip的操作前，显式指定Python模块调用方式，即统一使用python -m pip代替直接调用pip，例如执行python -m pip list。

通过上述调整，即可消除启动器错误，恢复正常使用。

PyInstaller安装与打包配置

补充知识：在使用pip安装pyinstaller库进行exe打包时，若遇到报错，可通过配置国内镜像源解决下载慢或连接失败的问题。

执行pip install pyinstaller命令时，若出现红色报错信息，通常与网络源连接有关。

推荐使用国内镜像源进行安装，具体命令如下。

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyinstaller

执行上述命令后，若终端仍显示黄色警告或报错，建议先升级pip版本，可尝试运行python -m pip install --upgrade pip。

若升级过程中仍出现报错，可继续结合国内镜像源进行强制升级。

python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple --upgrade pip

当pip升级成功后，可继续验证PyInstaller是否安装正确。

pyinstaller -v

若终端输出版本号如3.6，表明PyInstaller库已成功安装并可查看版本。

pyinstaller start.py

若打包成功，当前目录下将生成build和dist两个文件夹。进入dist文件夹，可见与源脚本同名的目录（如start），该目录下包含start.exe文件，即为最终的可执行启动程序。

----------------------------------------------------------

国内pip镜像源配置方法

本文内容参考了cnblogs上江coder分享的技术文章，特此致谢。

使用pip管理工具安装库文件时，默认连接国外源，国内下载速度可能受限至50KB/s左右。国内多家科研机构提供了高速镜像，下载速度可达2MB/s以上。

常用的国内镜像源包括以下地址：

（1）阿里云 http://mirrors.aliyun.com/pypi/simple/ （2）豆瓣http://pypi.douban.com/simple/ （3）清华大学 https://pypi.tuna.tsinghua.edu.cn/simple/ （4）中国科学技术大学 http://pypi.mirrors.ustc.edu.cn/simple/ （5）华中科技大学http://pypi.hustunique.com/

注意：新版Ubuntu系统要求必须使用https协议的源。

配置方法以清华大学镜像为例，其他镜像配置逻辑相同。

（1）临时使用：

在使用pip命令时，通过添加-i参数指定镜像地址（如

https://pypi.tuna.tsinghua.edu.cn/simple），

例如执行pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pandas，即可从清华镜像快速安装pandas库。

（2）永久修改，实现一劳永逸的配置：

（a）Linux系统下，需修改~/.pip/pip.conf文件，若该路径不存在，需手动创建包含“.”的隐藏文件夹及配置文件。

配置文件内容如下：

[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = https://pypi.tuna.tsinghua.edu.cn

(b) Windows系统下，需在用户目录（如C:\Users\xx\pip）创建pip文件夹，并新建pip.ini文件（路径为%HOMEPATH%\pip\pip.ini），在文件中输入以下内容（以豆瓣镜像为例）：

[global] index-url = http://pypi.douban.com/simple [install] trusted-host = pypi.douban.com

以上即为解决Python Fatal error in launcher错误及配置PyInstaller国内镜像的完整指南，希望对读者有所帮助。