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[10];
    ...
    ...
};

 

你在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 = 0;

Box::Box() :m_name("box"), m_ID(++s_nInstance)
{
}


Box::~Box()
{
}

main.cpp

#include "Box.h"

int main()
{
    Box b1, b2;
    return 0;      
}

调试:

修改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