### 正确设置 Visual Studio 2017 的环境变量以支持 Python C++ 扩展构建 为了使 Visual Studio 2017 支持 Python C++ 扩展的构建，需要完成以下几个方面的配置： #### 1. 安装必要的工作负载 在安装 Visual Studio 2017 时，需确保选择了以下两个主要的工作负载： - **使用 C++ 的桌面开发**：此选项会安装所需的 C++ 编译器及相关工具链[^1]。 - **Python 开发**：该选项提供对 Python 脚本的支持以及集成开发体验[^3]。 如果未预先选择上述两项，则可以通过重新运行 `Visual Studio Installer` 并修改现有安装来添加它们。 #### 2. 添加编译器路径至系统 PATH 环境变量 为了让命令行或其他外部程序能够识别并调用 Visual Studio 提供的 C++ 工具集（如 cl.exe），必须将其对应的目录加入系统的 PATH 变量中。具体操作如下： - 对于 Visual Studio 2017，默认情况下，C++ 编译器位于类似于以下路径的位置： ``` C:\Program Files (x86)\Microsoft Visual Studio\2017\<Edition>\VC\Tools\MSVC\<version>\bin\<architecture>\ ``` 其中 `<Edition>` 表示版本（Community/Professional/Enterprise），而 `<version>` 和 `<architecture>` 则分别代表工具集的具体版本号与目标架构（例如 x86 或 amd64）。实际路径可能因安装情况略有不同[^2]。 - 将找到的确切路径追加到 Windows 系统环境变量中的 PATH 中去。这一步可通过控制面板 -> 系统属性 -> 高级系统设置 -> 环境变量 来实现。 #### 3. 设置 MSBuild 属性文件 当通过 pip 构建某些依赖本地扩展的 Python 包时，可能会触发 MSBuild 进程执行相应的编译任务。此时可以创建或编辑一个全局性的 `.props` 文件用于指定特定版本的工具集合（Toolset Version）和平台工具集（Platform Toolset）。通常建议新建名为 `Directory.Build.props` 的 XML 文件放置于项目根目录下或者用户主目录下的 `%USERPROFILE%\AppData\Local\Microsoft\MSBuild\v4.0` 目录内，其内容大致形式如下所示： ```xml <Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> <PropertyGroup> <!-- 指定使用的工具集 --> <PlatformToolset>v141</PlatformToolset> <!-- v141 对应 VS2017 --> </PropertyGroup> </Project> ``` 这样做的目的是让所有的基于 MSBuild 的构建过程都能自动应用所定义好的参数设定，从而减少手动干预的需求。 #### 4. 测试配置有效性 最后验证整个流程是否成功的关键在于尝试安装某个需要用到 C++ 后端支持的第三方库。比如 NumPy, SciPy 等知名科学计算类库往往都含有部分由 Cython 编写的高效组件，在首次安装期间便会启动内部机制利用已有的 C++ 基础设施来进行定制化组装。因此可以直接打开 CMD 输入类似下面这样的指令看看效果如何： ```bash pip install numpy --no-cache-dir ``` 如果没有报错并且顺利完成下载、解压、编译直至最终部署全过程的话即表明当前机器上的相关软硬件条件均已满足预期标准。 --- ### 注意事项 尽管以上方法适用于大多数常规场景，但在特殊条件下仍可能出现兼容性问题或是其他异常状况。遇到困难时可查阅官方文档获取进一步指导信息，亦或者寻求社区帮助共同探讨解决方案。