【插件】史上最強編輯器通用ctags插件OpenCTags使用指南v1.2－－開發(fā)者必備

HonestQiao

【插件】史上最強編輯器通用ctags插件OpenCTags使用指南v1.2－－開發(fā)者必備

1. 
   
2. Changes Log:
   
3. 
   
4. 
   
5. v1.2.0 2011-12-4
   
6.     支持Java編寫的可以設置用戶配置的編輯工具
   
7.     增加當前文件類查找Tags功能
   
8.     增加設置當前目錄參數
   
9.     完善多種主流輕量級編輯器的配置
   
10. 
    
11. v1.1.0 2011-11-26
    
12.     完善提示窗口的顯示樣式
    
13.     編輯器配置使用Json格式配置文件，方便定制到自己喜歡的編輯器，主流編輯器一網打盡
    
14. 
    
15. v1.0.4 2011-11-21
    
16.     支持提示窗口拖動，按住鼠標右鍵，即可拖拖拖【上一版本為鼠標左鍵】
    
17.     增加回車鍵功能，按下可以會自動打開對應的文件并定位到對應的位置
    
18.     修復TAB鍵功能，按下可以實現AutoComplete/自動完成功能
    
19.     修復空格鍵功能，按下定位到當前選中文件的功能
    
20.     修復左鍵選擇功能和雙擊定位到當前選中文件的功能
    
21. 
    
22. v1.0.3 2011-11-19
    
23.     系統(tǒng)托盤圖標支持鼠標右鍵，可以顯示About和Exit正常退出
    
24.     支持提示窗口拖動，按住鼠標左鍵，即可拖拖拖
    
25.     支持窗口位置記憶，只要OpenCTags不退出，窗口位置將保持
    
26.     默認tags文件修改為.tags，并支持自定義tags文件名，具體操作請看readme
    
27.     幫助文檔完善，ctags索引js配置增加
    
28. 
    
29. v1.0.2 2011-11-17
    
30.     在v1.0.1基礎上，完善IPC調用模式支持超長路徑，首次調用后，將作為IPC服務運行，使得性能得到重大提升，且支持定位瀏覽歷史；
    
31. 　 中文文檔增加歷史定位前后跳轉查看功能。
    
32. 　 彈出的提示窗口中，可以輸入自己想要的關鍵字，進行快速查找。
    
33. 
    
34. v1.0.1 2011-11-16
    
35.     在OpenCTags.1.0.0基礎上，開發(fā)單次調用模式，使得超長路徑可以正常使用；
    
36. 
    
37. 
    
38. v1.0.0 2009
    
39.     Romeo JunCU開發(fā)了OpenCTags，讓我們擁有史上最強編輯器插件OpenCTags
    

復制代碼

首先：
    感謝Romeo JunCU曾經的卓絕工作，是他開發(fā)了OpenCTags最初版本，HonestQiao在此基礎上進一步開發(fā)完善，讓我們擁有史上最強插件，讓我們的編輯插上了翅膀。

然后：
　　這為啥是一個好東西呢？
　　編寫代碼或者閱讀他人代碼時，想要快速查看函數的原型，或者要定位到函數或者類定義的地方，你會怎么做？
　　主流的IDE（龐大）都會支持此類快速跳轉，使用vim的牛人（膜拜）也會加上插件來支持。
　　今天EditPlus/UltraEdit也能支持了，你也可以快速定位，在代碼中來回跳轉，效率倍增。
　　可以定位的類型，包括但不限于：（主流語言均支持，C、C++、PHP、JAVA、Python、Ruby.......）

1. 用define定義的宏或者常量
   
2. 枚舉型變量的值
   
3. 函數的定義、原型和聲明
   
4. 名字空間（namespace）
   
5. 類型定義（typedefs）
   
6. 變量（包括定義和聲明）
   
7. 類（class）、結構（struct）、枚舉類型（enum）和聯(lián)合（union）
   
8. 類、結構和聯(lián)合中成員變量或函數
   
9. 函數，類，結構體

復制代碼

　　有興趣可以繼續(xù)了解強大的ctags。





使用：【以下為EditPlus配置，UltraEdit配置，請查看壓縮包內說明文件】
    1. 將OpenCTags解壓后的所有文件，拷貝到 編輯器安裝目錄\User Tools\OpenCTags\下；也可以拷貝到其他目錄，但是要對應修改以下的配置；

    2. 在編輯器的 工具（Tools）菜單=>配置用戶工具（Config User Tools）中，添加工具（Add Tool）并進行如下設置：
        a.【假設快捷鍵為Ctrl+1】
            菜單名稱：CTags Build
            命令：......\編輯器安裝目錄\User Tools\OpenCTags\ctags.exe   (請根據實際路徑設置)
            參數： -f "openctags.tags" -R *
            初始目錄：$(FileDir)
            動作：捕捉輸出
            輸出模板：默認
            保存：無

        b.【假設快捷鍵為Ctrl+2】
            菜單名稱：OpenCTags定位
            命令：......\編輯器安裝目錄\User Tools\OpenCTags\OpenCTags.exe   (請根據實際路徑設置)
            參數： -t "openctags.tags" -word "$(CurWord)" -editor editplus -sel "$(CurSel)" -file "$(FilePath)" -line $(CurLine)
            初始目錄：$(FileDir)
            動作：退出時關閉窗口
            輸出模板：默認
            保存：無

        c.【假設快捷鍵為Ctrl+3】
            菜單名稱：OpenCTags向前查找
            命令：......\編輯器安裝目錄\User Tools\OpenCTags\OpenCTags.exe   (請根據實際路徑設置)
            參數：-t "openctags.tags" -word "$(CurWord)" -editor editplus -sel "$(CurSel)" -file "$(FilePath)" -line $(CurLine) -action p
            初始目錄：$(FileDir)
            動作：退出時關閉窗口
            輸出模板：默認
            保存：無

        d.【假設快捷鍵為Ctrl+4】
            菜單名稱：OpenCTags向后查找
            命令：......\編輯器安裝目錄\User Tools\OpenCTags\OpenCTags.exe   (請根據實際路徑設置)
            參數：-t "openctags.tags" -word "$(CurWord)" -editor editplus -sel "$(CurSel)" -file "$(FilePath)" -line $(CurLine) -action n
            初始目錄：$(FileDir)
            動作：退出時關閉窗口
            輸出模板：默認
            保存：無

    3. 使用方法：
        a. 到項目的根目錄，打開一個文件，然后按快捷鍵Ctrl+1（或者點擊菜單執(zhí)行“CTags Build”），等待建立ctags完成，在根目錄會生成tags文件，注意在svn/git/hg/cvs等中設置忽略該文件
        b. 打開項目內任意文件，選中需要查看的關鍵字（類名或者函數方法名或者任意玩意），，然后按快捷鍵Ctrl+2（或者點擊菜單執(zhí)行“OpenCTags”），將會打開OpenCTags提示窗口，提示對應的tags信息
        c. 提示窗口中，會給出匹配的名稱，原型縮寫，以及所在的文件相對路徑，鼠標移動上去，會顯示完整的原型提示，雙擊，會自動打開對應的文件并定位到對應的位置
        d. 提示窗口中，左則的圖標代表不同的類型，包括但不限于：類、方法/函數、常量定義、變量等等
        e. 進過多次跳轉后，可以按快捷鍵Ctrl+3、Ctrl+4，來回快速跳轉，方便異常
        f. 按下鼠標右鍵，提示窗口可以隨意拖動，只要OpenCTags服務不退出，窗口位置可以自動保持
        g. 提示窗口輸入欄，可以任意改變，輸入你喜歡的關鍵字（類名或者函數方法名或者任意玩意）可以實時搜索
        h. 按TAB，會將當前選中的tag自動輸入到編輯器（AutoComplete/自動完成），按空格鍵或者回車會自動打開對應的文件并定位到對應的位置




附加：
　 0. ctags是個什么東東？你out了，快點上網查吧。

    1. 該插件，來自于sf的OpenCTags，我只是經過簡單完善和給予中文說明后提供；再次感謝Romeo JunCU的卓絕工作。
   
    2. 如果是editplus2，請使用-editor editplus2
   
    3. 編輯器的快捷鍵列表可以看菜單＝》幫助＝》鍵盤映射，或者菜單＝》工具＝》參數設置＝》快捷鍵＝＞類型：工具＝》用戶工具1~20進行設置
   
    4. 歡迎推廣，歡迎傳播至少一人，好東西要一起分享嘛！

    5. 如有問題和建議，請致信honestqiao@gmail.com，謝謝

    6. 在線討論，請訪問：http://72891.cn/thread-3619603-1-1.html
   
    7. 歡迎訪問史上最強PHP中文手冊－－PHP手冊中文翻譯補完計劃 －－http://code.google.com/p/phpdoc-zh/

    8. 待補充




問題：

　　Q: Could not find install dir for editor ...？
　　A: 找不到 編輯器的安裝路徑，綠色版本的一般會出現該問題；
　　　編輯“tools\EditPlus安裝路徑.reg”，將其中的EditPlus路徑修改為你自己的，然后保存，然后雙擊導入注冊表即可。
　　　或者打開regedit，在HKEY_CURRENT_USER\Software\ES-Computing\EditPlus 3\Install，設置Path字符串屬性，值為 編輯器安裝路徑，不存在項或者目錄就建立新的。
　　　如果是EditPlus2，記得修改為EditPlus 2。

　　Q: 雙擊無法打開文件？
　　A: 請打開“tools\Microsoft Visual Studio Spy++.exe”，點搜索菜單，點查找窗口，然后點那個瞄準器，拖到 編輯器的編輯代碼的那個位置（需要預先打開一個文件），然后告訴我，Spy++的“窗口搜索”的類那個地方顯示的信息，例如我的是“AfxFrameOrView90su”，你的呢？


　　Q: 修改或者增加新的代碼后，匹配不到怎么辦？
　　A: 此時，因為代碼發(fā)生了變化，所以需要及時再來一次：CTags Build

　　Q: 索引JS文件出錯，CTags Build時提示：ctags: Warning: ignoring null tag in .............js
　　A: js文件內有特殊結構，不在CTags默認定義列表中；請將“tools\.ctags”拷貝到%HOMEDRIVE%%HOMEPATH%（Win+R，輸入回車即可打開）目錄下，然后重新Build
問題：

unicac

mark一下，喬姐辛苦了。

X0YO

大媽辛苦了

浪子雄心

我靠 ，此時發(fā)帖排在了第三樓

支持大媽 ， 推廣之

jialong520

UEstudio 可以用嗎

jialong520

UEstudio 可以用嗎

菜鳥爵爺

我來頂喬大姐

xinglu1983

支持！editplus入門時的代碼利器！

lreng

有什么用。