什么是属性表&属性表的好处
在 Visual Studio C++ 工程开发中,使用 .props 文件(即 Property Sheet,属性表 )来管理第三方库(如 OnnxRuntime、OpenCV)的配置,是从"学生作业"迈向"工业级项目"的重要标志。
这不仅仅是为了省事,更是为了工程化管理 。以下是使用 OnnxRuntimeDebug.props 这种配置文件的核心好处:
1. 一处修改,全局生效(极大的复用性)
-
痛点 :假设你的解决方案(Solution)里有 3 个项目:一个主程序、一个测试程序、一个工具程序。如果你手动配置,你需要右键 3 次项目属性,分别设置
Include Directories、Library Directories和Linker Input。 -
优势 :使用
.props文件,你只需要把配置写在这一张表里。3 个项目分别"引用"这张表。 -
场景 :当你把 OnnxRuntime 从 1.14 升级到 1.17 时,你只需要修改
.props文件里的路径,3 个项目瞬间全部更新,无需逐个点击。
2. 彻底解耦"项目"与"环境"
-
痛点 :很多初学者的
.vcxproj项目文件中写死了绝对路径,例如D:\User\ZhangSan\Desktop\OnnxRuntime\...。当你把代码发给同事(李四),他的电脑上可能根本没有这个盘符或路径,项目直接爆红,编译失败。 -
优势 :在
.props文件中,我们通常配合$(SolutionDir)等宏定义使用相对路径。-
你可以把 OnnxRuntime 的库文件放在项目根目录下的
3rdparty文件夹。 -
.props写成$(SolutionDir)3rdparty\onnxruntime\include。 -
结果 :你把整个工程文件夹打包发给任何人,他们解压后不用配置任何环境,直接就能编译运行。
-
3. 清晰区分 Debug 与 Release (防止崩溃)
-
痛点 :C++ 中混用 Debug 和 Release 库是崩溃之源(例如 STL 容器结构不同导致的
_iterator_debug_level错误)。 -
优势:
-
你可以创建两个文件:
OnnxRuntime_Debug.props和OnnxRuntime_Release.props。 -
在 VS 的 Property Manager (属性管理器) 中,分别把它们挂载到对应的配置下。
-
结果 :切换 Debug 模式时,自动链接
onnxruntime.lib(带调试信息的);切换 Release 时,自动链接优化后的库。永远不会搞混。
-
4. 保持项目文件 (.vcxproj) 干净
-
痛点 :
.vcxproj是 XML 格式的,如果所有路径都塞进去,文件会变得非常乱,Git 合并代码时容易产生冲突。 -
优势 :
.vcxproj只负责记录代码文件,环境配置全部甩锅给.props。这使得版本控制更加清晰。
💡 一个形象的比喻
-
手动配置项目属性:就像在写 Word 文档,你选中每一段标题,手动把字体改成"黑体、20号"。如果要改格式,得一段一段改。
-
使用 .props 属性表 :就像使用 CSS (样式表) 。你定义了一个样式叫
.onnx-config,所有项目只要引用这个样式,立刻生效。
VS中添加属性表
Onnx属性表





Opencv属性表




