Source Insight 作為一款優秀的程式碼瀏覽和編輯器應用十分廣泛，對於一些重複使用的功能，我們可以定義相關的巨集來提高開發效率。

1:巨集的編寫

Source Insight Help文件中Macro Language Guide一節詳細的介紹了巨集的編寫，結構和C語言相似，通過閱讀文件，相信就可以編寫出各種功能強大的巨集。這裡我編寫了一個簡單的新增函式註釋的巨集。

macro GetCommentsTime()
{
    var  year
    var  month
    var  day
    var  commTime
    var  sysTime

    sysTime 
 
= GetSysTime(1)
    year = sysTime.Year
    month = sysTime.month
    day = sysTime.day
    commTime = "@[email protected]@[email protected]@[email protected]"
    return commTime
}

macro GetCommentsPos()
{
     var funPos
     var fun
     fun = GetCurSymbol()
     funPos = GetSymbolLine(fun)
     
 
return funPos
}

macro GetFunDescribe()
{
    str = Ask ("請輸入函式描述!")
    return str
}

macro GetAuthor()
{
    author = GetEnv (author_name)
    if(nil == author)
    {
        str = Ask ("請輸入作者名!")
        PutEnv (author_name, str)
    }

    author = GetEnv (author_name)
    return author
}

macro insertComment()
{
    
 
var comments
    var hBuff
    var line
    var fun

    fun = GetCurSymbol()
    hBuff = GetCurrentBuf()

    line = GetCommentsPos()
    
    InsBufLine(hBuff, line, "/**********************************")
    
    comments = "函   數   名:"
    comments = cat(comments,fun)
    InsBufLine(hBuff, line+1, comments)
    
    comments = "描      述:"
    des = GetFunDescribe()
    comments = cat(comments,des)
    InsBufLine(hBuff, line+2, comments)
    
    comments = "作      者:"
    author = GetAuthor()
    comments = cat(comments,author)
    InsBufLine(hBuff, line+3, comments)
    
    comments = "創 建 日 期:"
    time = GetCommentsTime()
    comments = cat(comments,time)
    InsBufLine(hBuff, line+4, comments)
    
    InsBufLine(hBuff, line+5, "**********************************/")

    SaveBuf(hBuff)
}

2：巨集除錯

在編寫一個巨集函式的時候我們希望隨時可以除錯相關資訊，可以通過“Inline Macro”來實現，通過stop命令我們可以控制巨集執行的結束位置，為了實時檢視返回資訊，我們可以通過msg這個函式來檢視返回資訊。

macro GetCommentsPos()
{
     var funPos
     var fun
     fun = GetCurSymbol()
     funPos = GetSymbolLine(fun)
     msg(funPos)
     stop
     return funPos
}

然後我們呼叫下“Run Macro command”這個命令就可以執行該巨集了。

3：新增指令碼到工程

指令碼編寫完畢後，我們以.em字尾來儲存。我們可以把指令碼加入到我們的工程中，然後同步一下。也可以把指令碼放入Source Insight\Projects\Base目錄中（任何工程都可以使用）。然後我們就可以看到我們定義的巨集已經出現在命令列表中了。對於常用的巨集都可以對映為快捷鍵值。

4：巨集執行

在需要添加註釋的函式中執行一下巨集，我們就可以把函式註釋頭新增進去了，十分方便。

/**********************************
函     數    名:getDigits
描            述:*****
作            者:chencheng
創  建  日  期:2012-7-22
**********************************/
static int getDigits(const char *zDate, ...)