【VS2017】 一个使用 cl 和 link 命令例子

编译脚本build_windows_x86.batecho off :: 初始化 VS2017 x86 编译环境 call%VS2017%\vcvars32.batiferrorlevel1(echo[ERROR]无法初始化 VS2017 编译环境请检查安装路径 pauseexit/b1)::5. 编译测试程序(必须 /MD ENABLE_DEEP_PLC/DRED/OSCE)echo[5/5]编译测试程序 test_opus_plc_multi_dred.exe... cl /c /Fotest_opus_plc_multi_dred.obj /nologo /MD /O2 ^ /DENABLE_DEEP_PLC /DENABLE_DRED /DENABLE_OSCE ^ .\test_opus_plc_multi_dred.c ^ /I./I include/opusiferrorlevel1goto errorlink/OUT:test_opus_plc_multi_dred.exe ^ test_opus_plc_multi_dred.obj .\libopus.libiferrorlevel1goto error echo.echoecho编译完成!echo测试:test_opus_plc_multi_dred.exeechogoto end :error echo.echo[ERROR]编译失败!pause :end逐行解释这个完整的批处理文件并结合提供的环境变量截图说明关键配置。完整代码解析第 1 行关闭命令回显echo off执行时不显示命令本身只显示命令的输出结果让控制台输出更整洁第 3-9 行初始化 VS2017 编译环境:: 初始化 VS2017 x86 编译环境 call %VS2017%\vcvars32.bat if errorlevel 1 ( echo [ERROR] 无法初始化 VS2017 编译环境请检查安装路径 pause exit /b 1 )内容说明call调用另一个批处理脚本执行完后返回当前脚本继续%VS2017%系统环境变量值来自您截图中的配置vcvars32.batVS2017 自带的 x86 环境初始化脚本if errorlevel 1如果初始化失败显示错误并暂停 环境变量关联您的截图变量名: VS2017 变量值: C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Auxiliary\Build所以实际调用的是C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\VC\Auxiliary\Build\vcvars32.batvcvars32.bat的作用将cl编译器、link链接器等工具添加到当前命令行的 PATH 中设置INCLUDE、LIB等环境变量这是必须的一步否则直接运行cl会提示找不到命令第 11-17 行编译生成目标文件:: 编译测试程序 (必须 /MD ENABLE_DEEP_PLC/DRED/OSCE) echo [5/5] 编译测试程序 test_opus_plc_multi_dred.exe... cl /c /Fotest_opus_plc_multi_dred.obj /nologo /MD /O2 ^ /DENABLE_DEEP_PLC /DENABLE_DRED /DENABLE_OSCE ^ .\test_opus_plc_multi_dred.c ^ /I . /I include/opus if errorlevel 1 goto error详细参数参数含义clMSVC C/C 编译器/c只编译不链接生成.obj文件/Fotest_opus_plc_multi_dred.obj指定输出文件名/nologo不显示编译器版本横幅/MD使用多线程 DLL 运行时库必须匹配 libopus.lib 的编译方式/O2速度优化Release 级别优化/DENABLE_DEEP_PLC定义宏启用 Deep PLC 代码块/DENABLE_DRED定义宏启用 DRED 代码块/DENABLE_OSCE定义宏启用 OSCE 功能/I .头文件搜索路径当前目录/I include/opus头文件搜索路径include/opus子目录^批处理续行符将多行拼接成一条命令执行结果.\test_opus_plc_multi_dred.c → test_opus_plc_multi_dred.obj第 19-21 行链接生成可执行文件link /OUT:test_opus_plc_multi_dred.exe ^ test_opus_plc_multi_dred.obj .\libopus.lib if errorlevel 1 goto error参数含义linkMSVC 链接器/OUT:test_opus_plc_multi_dred.exe指定输出可执行文件名test_opus_plc_multi_dred.obj上一步编译生成的目标文件.\libopus.libOpus 静态库文件包含 opus_encode、opus_decode 等实现链接过程将.obj中的代码与libopus.lib中的 Opus API 实现合并解析所有函数调用生成最终的.exe文件第 23-28 行成功处理echo. echo echo 编译完成! echo 测试 : test_opus_plc_multi_dred.exe echo goto end打印成功信息goto end跳过错误处理代码直接到脚本末尾结束第 30-33 行错误处理标签:error echo. echo [ERROR] 编译失败! pause:error是一个标签Label编译或链接失败时跳转到这里pause暂停等待用户按任意键方便查看错误信息第 35 行脚本结束标签:end空标签作为goto end的跳转目标脚本执行到这里自然结束执行流程图开始 │ ▼ 初始化 VS2017 环境 (vcvars32.bat) │ ├── 失败 ──→ 显示错误 ──→ pause ──→ 退出 │ ▼ 编译 test_opus_plc_multi_dred.c │ ├── 失败 ──→ :error 标签 ──→ 显示编译失败 ──→ pause │ ▼ 链接 .obj libopus.lib │ ├── 失败 ──→ :error 标签 ──→ 显示编译失败 ──→ pause │ ▼ 显示编译完成! │ ▼ 结束⚠️关键注意事项问题说明必须先设置 VS2017 环境变量您截图中的配置是正确的脚本依赖它必须在 VS 开发者命令提示符中运行不需要因为脚本自己会调用vcvars32.bat初始化环境/MD必须匹配libopus.lib必须用/MD编译否则链接会报错源文件路径脚本假设test_opus_plc_multi_dred.c和libopus.lib与.bat同目录如果要手动执行直接在普通 CMD 或 PowerShell 中运行cd c:\Users\lijian\Desktop\opus\windows_x86 build_windows_x86.bat不需要先打开Developer Command Prompt因为脚本内部已经做了环境初始化。