如何模拟全新Windows环境测试Python包的安装行为

核心问题解答 #

• 为什么干净虚拟环境无法满足需求：虚拟环境仅隔离Python的包依赖与解释器上下文，底层共享宿主系统的全部系统组件，只要宿主安装了MSVC编译工具、Windows SDK等编译依赖，虚拟环境中安装需要编译的包时仍然可以正常调用这些工具，无法模拟全新系统无编译环境的状态
• 是否必须使用完整虚拟机：如果需要100%匹配普通全新Windows用户的真实使用场景，优先推荐使用虚拟机方案；如果只是需要近似模拟编译失败的效果，也可以用轻量级配置方案无需虚拟机

方案1：虚拟机方案（还原度最高） #

操作步骤：

• 下载你需要覆盖测试的Windows版本官方镜像（如Win10 22H2、Win11 23H2），完成系统全新安装后，不要安装任何Visual Studio相关组件、C++编译工具、Windows SDK
• 安装对应版本的官方Python，安装时不要勾选任何可选的编译工具、调试组件相关选项，保持默认最小安装
• 此时直接在系统Python环境或者新建虚拟环境中执行pip install 你的测试包命令，所有需要编译C/C++扩展的包都会因为找不到编译工具抛出错误，完全匹配新用户的真实使用场景
• 为了方便重复测试，可以在配置完干净系统+Python的基础环境后生成虚拟机快照，每次测试完成后恢复快照即可快速回到干净测试环境

方案2：轻量配置方案（无需虚拟机） #

如果不想部署虚拟机，可以在现有Windows系统上通过修改Python配置强制禁用编译，模拟相同效果：

• 先卸载当前系统中所有的Visual Studio生成工具、MSVC组件、Windows SDK
• 打开Python安装目录，进入Lib/distutils文件夹，新建名为distutils.cfg的配置文件，写入以下内容：

[build]
compiler = nonexistent

• 此时不管使用全局Python还是新建的虚拟环境执行包安装，只要遇到需要编译的包，都会因为找不到指定的编译器直接抛出错误，效果和全新系统基本一致
• 测试完成后删除该distutils.cfg文件即可恢复系统原有Python编译能力

注意：该方案存在极小概率的适配问题，部分硬编码指定编译器路径的包可能不会触发错误，对测试还原度要求高的场景不推荐使用

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