代碼導(dǎo)航與搜索

在學(xué)習(xí)工作中，隨著項目規(guī)模的擴大，我們可能隨時需要閱讀源代碼或者定位代碼的位置， 這時就需要進行代碼導(dǎo)航與搜索。PyCharm 在這方面提供了豐富的功能，大多數(shù)功能都集中在菜單 Navigate 下， 本節(jié)將學(xué)習(xí)其中一些主要功能。

1. 查看文件結(jié)構(gòu)

1.1 工具欄 Structure

菜單：View -> Tool Windows -> Structure

在編輯器打開文件，默認(rèn)情況下，PyCharm 顯示當(dāng)前文件的所有類、方法和其他元素。

除此以下，工具欄還有另外兩個按鈕 Navigate with Single Click 與 Always Select Opened Element。

Navigate with Single Click：單擊此按鈕，編輯器切換到對應(yīng)于所選節(jié)點的源代碼行，但焦點還是停留在"sturcture"工具窗口。

Always Select Opened Element：單擊此按鈕可讓 PyCharm 自動將"structure"工具窗口中的焦點移動到當(dāng)前編輯器中的代碼對應(yīng)的節(jié)點。

1.2 File Structure 彈出窗

打開一個文件， 菜單： Navigate -> File Structure

當(dāng)選項 Narrow down on typing 是被選中的，在打開的窗口直接輸入字符，顯示效果如下，僅顯示與輸入字母匹配的成員。

1.3 查看類成員在 Project 工具欄

菜單：View -> Tool Windows -> Project

2. 查找方式

2.1 根據(jù)名字查找

按? ? N ( Shift+ Ctrl + N), 在打開的彈出窗輸入字符。切換Tab可以能夠按其名稱查找任何文件、類、符號(變量名或者函數(shù)名）及動作（比如菜單項）等，并直接跳轉(zhuǎn)到它。也可以指定搜索范圍，這是 PyCharm 最強大的導(dǎo)航和搜索功能之一。

點擊上圖的 漏斗 按鈕，還可設(shè)置篩選條件。

Tips ：對應(yīng)搜索文件、類及符號等， PyCharm 也分別提供了菜單：

2.2 Recent files (最近的文件）

在實際工作中，我們通常都會在少數(shù)幾個文件中切換。比如正在編輯一個函數(shù)，同時要為此函數(shù)編寫測試 - 這意味著要來回切換。PyCharm 為適應(yīng)這種場景提供了Recent Files 窗口，列出最近打開的文件列表。

菜單 View -> Recent files, 或者按 ? E (Ctrl + E), 彈出下面窗口。最新的文件首先列出并默認(rèn)選中, 可以通過上下箭頭選擇文件。

2.3 Searching everywhere (到處搜索）

Searching everywhere 可以在任何地方查找任何內(nèi)容。菜單 Navigate -> Searching everywhere 或者 double ? (雙擊 SHIFT) 會顯示下面窗口，選擇項目可直接跳轉(zhuǎn)到搜索結(jié)果。

2.4 跳到指定行

打開一個文件, 菜單 Navigate -> Line/Column... 或者 按 ? G（Ctrl + G)。指定行列位置，就會自動跳轉(zhuǎn)。

3. 導(dǎo)航到聲明、引用與測試

查看對象聲明及其引用也是編程工作經(jīng)常用到的操作。PyCharm 也提供了相應(yīng)的快捷操作，可以快速導(dǎo)航到指定位置。

1. 導(dǎo)航到聲明：將光標(biāo)停留在聲明處， Navigate -> Declaration or Usages 或者 按 ? B (Ctrl + B), 將跳轉(zhuǎn)到方法聲明的地方。

2. 導(dǎo)航到引用： 將光標(biāo)停留在聲明處，Navigate -> Implementation(s) 或者 按 ?? B（Ctrl + Alt + B), 會看到所有類實現(xiàn)。

3. 導(dǎo)航到測試：將光標(biāo)停留在聲明處，Navigate -> Test 或者 按 ? ? T（Ctrl + Shift + T), 會看到現(xiàn)有測試和創(chuàng)建新測試的建議。
   

4. 查找用途：

我們經(jīng)常也需要在整個項目中查找某個類或方法的所有用法。 PyCharm 提供了豐富的功能（Edit -> Find Usages） 其中在項目中查找與在當(dāng)前文件中查找用途是最常用操作。

將光標(biāo)停留在聲明處，然后按 ?F7（Alt + F7)。用途的相關(guān)信息出現(xiàn)在"Find"工具窗口中：

除此以外，可以在當(dāng)前文件里查看用途。 按? ? F7( Ctrl+Shift+F7 ) , 將高亮顯示所有用途。

5. 導(dǎo)航欄

有時候，如果覺得 Project 工具欄占用屏幕空間，可以用 Navigation bar 替代 Project 工具欄查看文件。

1. 確保 Navigation bar 是可見的 View -> Appearance -> Navigation Bar。

2. 這時會看到導(dǎo)航欄顯示，顯示當(dāng)前打開文件的路徑。

3. 然后按 ?↖ (Alt + Home) , 會有彈出窗口顯示?？梢酝ㄟ^回車鍵顯示嵌套目錄和文件，通過箭頭鍵在列表中導(dǎo)航。

4. 右鍵點擊導(dǎo)航欄上某一節(jié)點，上下文菜單將顯示， 可以直接創(chuàng)建新的文件。
   
5. 除此以外， 如果文件夾列表太長， 單擊所需的文件夾并直接鍵入字符過濾搜索。
   

6. 小結(jié)

導(dǎo)航與搜索是 PyCharm 強大功能之一，本節(jié)只是介紹了其中常用的一部分功能。當(dāng)大家在面對新技術(shù)與新項目的過程中， 搜索與導(dǎo)航功能可以幫助我們提高閱讀源碼效率，加快理解項目架構(gòu)，所以，掌握本節(jié)的內(nèi)容是非常必要的。