Visual Studio Debugger AutoExp.dat & Visualization Framework

bing.com搜索: autoexp.dat

参考资料:

AutoExp.dat

http://www.virtualdub.org/blog/pivot/entry.php?id=120

http://www.cnblogs.com/cutepig/archive/2010/08/12/1798079.html

http://www.cppblog.com/flyinghare/archive/2010/09/27/127836.html

http://cppblog.com/Streamlet/archive/2011/02/27/140742.html

http://blogs.msdn.com/b/dsvc/archive/2012/02/10/why-autoexp-dat-data-visualizer-entries-are-ignored-at-times.aspx

http://blog.csdn.net/qiudaowen/article/details/8054718

https://msdn.microsoft.com/en-us/library/aa730838(v=vs.80).aspx

从版本VS2012起, 比AutoExp.dat更好的方式 - Visualization Framework:

http://blogs.msdn.com/b/vcblog/archive/2012/07/12/10329460.aspx

https://code.msdn.microsoft.com/Writing-type-visualizers-2eae77a2#content

https://msdn.microsoft.com/en-us/library/jj620914.aspx

　　@

备注: VS2013虽然支持了NATVIS, 但不支持把NATVIS文件包括到项目中去(以及生成到PDB文件中), VS2015支持这些功能.

为什么不像.NET或者JAVA那样调用toString?

　　http://blogs.msdn.com/b/vcblog/archive/2013/06/28/using-visual-studio-2013-to-write-maintainable-native-visualizations-natvis.aspx

http://www.cnblogs.com/TianFang/p/3963406.html

http://blogs.msdn.com/b/mgoldin/archive/2012/06/06/visual-studio-2012-and-debugger-natvis-files-what-can-i-do-with-them.aspx

Debug java代码的时候eclipse会调用一个object的toString来获得其内容显示到debugger的窗口上, 这样就使得开发者调试的时候非常方便查看其想要的信息.

Visual Studio却采用的不是这个方法. 你如果写了一个class Box, VS 并不知道你Debug的时候对于Box object最希望展示的是什么信息, 所以你就得跟打开文件树一样, 展开 Box 对象才能看到内部信息.

比如说你的 class Box 定义如下

 class Box
 {
     int a;
     char str[];
     ...
     ...
 };

你在Debug的时候可能想直接看到str的内容, 而不是把Box object给展开才能看到. 最开始我一直以为展开是唯一的办法了, 最近接触了 Qt 突然发现 QString 在Debug窗口内直接展示的就是其内部string的内容,  我才知道原来这个是可以实现的. 上bing.com搜了一下 "visual studio customize debug window"终于搜到上面的blog. 这才知道原来有个叫AutoExp.dat的东西是专门用来定制你debug的时候想看到的东西(虽然没有toString那种方便, 聊胜于无啊!)

Qt 就是通过修改 AutoExp.dat 来实现更user-friendly的Debug信息的.

现在先做一个Demo来演示怎么使用AutoExp.dat来定制Debug显示的信息.

Box.h

 #pragma once
 class Box
 {
     static unsigned int s_nInstance;
     const char* m_name;
     const unsigned int m_ID;
 public:
     Box();
     ~Box();
 };

Box.cpp

 #include "Box.h"
 
 unsigned int Box::s_nInstance = ;
 
 Box::Box() :m_name("box"), m_ID(++s_nInstance)
 {
 }
 
 Box::~Box()
 {
 }

main.cpp

 #include "Box.h"
 
 int main()
 {
     Box b1, b2;
     return ;
 }

调试:

修改AutoExp.dat, 在 [Visualizer] 区域内添加代码:

 MyBox{
     preview
     (
         #(
             "[Name = ", $c.m_name, "ID = ", $c.m_ID, "]"
         )
     )
 }

然后确保这个选项没有被勾选:

注意, VS2013不再使用AutoExp.dat了, 所以无论你怎么修改AutoExp.dat都不会起作用的, VS2013默认用natvis文件.(XML). Qt 也用的是 natvis文件 (比如Qt5用的就是qt5.natvis)

natvis文件的目录是:%VS_INSTALL_DIR%\Common7\Packages\Debugger\Visualizers

见:

http://blogs.msdn.com/b/vcblog/archive/2012/07/12/10329460.aspx

你需要做的就是写一个自己的 .natvis 文件并放到以下目录即可:

%VS_INSTALL_DIR%\Common7\Packages\Debugger\Visualizers

比如写一个 MyVisualizers.natvis , 内容如下 (模板是抄的该目录下现成的 .natvis 文件)

 <?xml version="1.0" encoding="utf-8"?>
 <AutoVisualizer xmlns="http://schemas.microsoft.com/vstudio/debugger/natvis/2010">
 
     <Type Name="MyBox">
         <DisplayString>MyBox[{m_ID}]</DisplayString>
         <Expand>
             <Item Name="[m_name]">m_name</Item>
             <Item Name="[m_ID]">m_ID</Item>
         </Expand>
     </Type>
 
 </AutoVisualizer>

然后把 MyVisualizers.natvis 放到该目录. 调试的时候如果遇到类型名为 MyBox 的就会按照 MyVisualizers.natvis 中定义的规则来显示调试信息

效果如图

至于这个XML文件的语法含义是什么可以借鉴该目录下的其他 .natvis 文件的内容作为例子 (不过我感觉因为缺少注释和文档还是有些细节不知道什么含义)

去看官方文档:

https://msdn.microsoft.com/en-us/library/jj620914.aspx