PyInstaller打包报错：参数-F/--onefile的显式参数'--'被忽略，求排查

问题场景 #

编写了依赖numpy、os（路径处理）、matplotlib.pyplot的箱线图交互脚本，执行以下PyInstaller打包命令时出现报错：

错误的打包命令：

(spyder_env) D:\Scipts_homemade>pyinstaller -F-- hiddenimport=numpy -F--hiddenimport=os -F--hiddenimport=matplotlib.pyplot -F--collect-submodules=numpy -F--collect-submodules=matplotlib.pyplot -F--onefile BOX_PLOT_interactive.py

报错信息：

pyinstaller: error: argument -F/--onefile: ignored explicit argument '--''

错误原因及修正方案 #

核心错误：命令格式错误 #

1. 参数分隔失效：-F与后续的--hiddenimport等参数之间没有空格，导致PyInstaller无法识别参数边界，把-F--当成了错误的参数组合。
2. 参数重复冗余：-F和--onefile是完全等价的参数（均表示单文件打包），重复多次会导致解析混乱；同时os是Python标准库，PyInstaller会自动处理，无需额外指定--hiddenimport=os。

修正后的打包命令 #

(spyder_env) D:\Scipts_homemade>pyinstaller -F --hiddenimport=numpy --hiddenimport=matplotlib.pyplot --collect-submodules=numpy --collect-submodules=matplotlib.pyplot BOX_PLOT_interactive.py

额外提示 #

如果打包后的可执行文件运行时出现matplotlib图表无法正常显示的问题，可以添加--collect-data matplotlib参数，确保收集到matplotlib的字体、配置等资源文件：

pyinstaller -F --hiddenimport=numpy --hiddenimport=matplotlib.pyplot --collect-submodules=numpy --collect-submodules=matplotlib.pyplot --collect-data matplotlib BOX_PLOT_interactive.py

内容的提问来源于stack exchange，提问作者Francesco La Fauci