Debian11下使用cx_Freeze执行bdist_msi命令生成MSI安装包报错

错误原因 #

bdist_msi是cx_Freeze仅针对Windows平台提供的命令，Linux（包括Debian 11）环境下无法使用该命令。因为MSI是Windows专属的安装包格式，依赖Windows系统的安装服务与组件，Linux系统没有对应的底层支持，所以cx_Freeze在Linux环境中不会加载MSI相关的构建模块，执行命令时就会提示“Invalid command 'bdist_msi'”。

解决办法 #

方案一：切换到Windows系统构建 #

直接在Windows机器上完成以下步骤：

• 安装Python、cx_Freeze以及项目所需的所有依赖
• 切换到项目目录，执行python setup.py bdist_msi即可生成MSI安装包

方案二：用Wine在Linux下模拟Windows环境构建 #

如果无法切换到Windows系统，可以通过Wine在Debian 11中模拟Windows环境来构建：

1. 安装Wine：

   sudo apt update && sudo apt install wine
   

2. 下载Windows版本的Python安装包，通过Wine运行完成安装
3. 在Wine的Python环境中安装cx_Freeze：

   wine python -m pip install cx_Freeze
   

4. 切换到项目目录，执行构建命令：

   wine python setup.py bdist_msi
   

注意：这种方式可能会遇到依赖兼容问题，需要根据实际情况调试。

代码优化建议 #

可以修改配置代码，根据当前平台动态添加bdist_msi相关配置，避免非Windows环境下加载无效配置：

import sys
from pathlib import Path
from cx_Freeze import setup, Executable

company_name = '...'
product_version = '...'
product_name = '...'
product_description = '...'

base = None
build_exe_options = {}
options = {'build_exe': build_exe_options}

if sys.platform == 'win32':
    base = 'Win32GUI'
    bdist_msi_options = {
        'initial_target_dir': r'[ProgramFilesFolder]\%s\%s' % (company_name, product_name),
    }
    options['bdist_msi'] = bdist_msi_options

setup(
    name=product_name,
    version=product_version,
    description=product_description,
    options=options,
    executables=[Executable(
        'app.py',
        base=base,
        shortcut_name=product_name,
        shortcut_dir='DesktopFolder',
        icon=str(Path(__file__).parent / 'icon.jpg')
    )],
)

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