本頁說明可用的功能，協助你操作 Databricks 筆記本與檔案編輯器，包括鍵盤捷徑、程式碼建議與自動補全、變數檢查，以及程式碼摺疊。 當你使用筆記本或檔案編輯器時，Genie Code 可以協助你產生、解釋和除錯程式碼。 詳情請參見 Genie Code 的編程協助。
你可以從多種編輯器主題中選擇。 選取 檢視 > 編輯器主題，然後從功能表中選擇一個選項。
編輯模式與指令模式
Databricks 筆記本有兩種互動模式：
- 編輯模式在游標位於儲存格內時才會啟動。 在此模式下，你可以在儲存格內輸入並編輯程式碼或文字。 儲存格中會出現閃爍的游標，表示編輯模式。 雙擊儲存格或按鍵
Enter即可從指令模式切換到編輯模式。 按Esc鍵退出編輯模式。 - 當沒有儲存格被編輯時，指令模式會啟用。 在此模式下，你以單元格為單位進行操作。 你可以選擇、剪切、複製、貼上、刪除、移動和重新排列儲存格。 按鍵
Esc可從編輯模式切換到指令模式。 按下Enter退出指令模式。
命令面板
您可以使用命令選擇區快速在筆記本中執行動作。 要開啟筆記本動作窗格，請點擊工作區右下角的
單元執行小地圖
若要取得筆記型電腦執行狀態的視覺化概覽，請使用儲存格執行微型地圖。 小地圖會出現在右邊距並顯示每個可執行程式碼區域的狀態列。
狀態列會指出下列執行狀態：
- 淺灰色：儲存格是靜態的。
- 深灰色：儲存格將被跳過或加入執行佇列。
- 淺灰色，帶有移動條：程序單元當前正在運行。
- 綠色：程式碼單元成功運行，沒有錯誤。
- 紅色：儲存格失敗並發生錯誤。
要與小地圖互動，請遵循以下步驟：
- 將滑鼠懸停在小地圖上，即可查看可執行儲存格的清單、其標題及其執行狀態。
- 按一下項目，可直接跳至筆記本中的該儲存格。
- 按一下 [移至上次執行儲存格 ] 或 [ 移至第一個失敗的儲存格 ] 以導覽至最近執行或第一個失敗的儲存格。
小地圖可幫助您一目了然地跟踪執行進度，並在調試或開發時快速導航。
尋找和取代文字
要在筆記本中尋找並替換文字，請使用鍵盤快捷鍵 Cmd + F（Mac）或 Ctrl + F（Windows），或點擊 Edit > Find... 以開啟 Find 對話框。 輸入您想要尋找的文字。 目前的相符項目會以橙色標示，所有其他相符項目都會以黃色標示。 要進入內建的瀏覽器搜尋功能，請按 Cmd + F（Mac）或再次按 Ctrl + F（Windows）。
按兩下 
[取代] 選項。 輸入您想要改用的文字。 若要取代目前的相符項目，請點擊 [取代]。 若要取代筆記本中的所有相符專案，請按 [全部取代] 。
若要在相符項目之間移動，請按下 
（上一個相符項目）或 
（下一個相符項目）。 您也可以按 Shift + Enter 和 Enter 來逐一移動到上一個和下一個相符項目。
若要關閉尋找並取代工具，請按兩下 ![[關閉] 圖示，](../_static/images/product-icons/closeicon.svg){kind=icon}
或按 esc 鍵。
變量檢測
要顯示 SQL 或 Python 筆記本中定義的變數資訊，將游標移至變數名稱上。 Python 變數檢查需要 Databricks Runtime 12.2 LTS 或以上的版本。
請參閱 變數瀏覽器。
移至定義
當 Python 筆記本連接到運算資源時，你可以快速進入變數、函式、系統模組的定義，或是 %run 陳述句背後的程式碼。
操作方法是在 macOS 按住 Cmd 鍵，或在 Windows 按 Ctrl 鍵，並將滑鼠移到變數、函式名稱或系統模組上。 如果找到定義，該名稱就會變成超連結。 點擊連結可跳到定義，可能會在新分頁開啟。你也可以右鍵點擊，然後點擊 「前往定義 」或「 查看定義」。
「前往定義」功能可在 Databricks Runtime 12.2 LTS 及以上版本及無伺服器環境 1 及以上版本中使用。
代碼折疊
程式碼摺疊功能可讓您暫時隱藏程式碼區段。 這在處理長程式碼區塊時很有用，因為它可讓您專注於正在處理的特定程式碼區段。
若要隱藏程式碼，請將游標放在儲存格最左邊。 向下指向箭號會出現在邏輯點，您可以在其中隱藏程式代碼區段。 按下箭號以隱藏程式碼區段。 再次按下箭號 (現在指向右側) 以顯示程式碼。
如需更多詳細資料，包括鍵盤快速鍵，請參閱 VS Code 文件。
多游標支援
您可建立多個游標，讓同時編輯變得更容易，如影片所示：
若要在儲存格中建立多個游標：
- 在 macOS 上，按住
Option鍵，然後點擊每個位置以新增游標。 - 在Windows時，長按
Alt鍵，點擊每個位置即可新增游標。 - 您也可以選擇變更捷徑。 請參閱 變更多重游標和欄選取的快捷方式。
在 macOS 上，您可以使用鍵盤快速鍵 Option+Command+ 向上箭頭鍵或向下箭頭鍵來建立多個垂直對齊的游標。
欄位（框）選擇
若要選取欄中的多個項目，請用滑鼠點擊您想要擷取的區域左上角。 Then:
- 在macOS上，按
Shift+Option並拖曳到右下角以擷取一或多個數據行。 - 在Windows時，按
Shift+Alt，並向右下角拖曳以捕捉一欄或多欄。 - 您也可以選擇變更捷徑。 請參閱 變更多重游標和欄選取的快捷方式。
更改多重游標和欄位選取的快捷方式
替代的快捷方式可用於多重游標與欄位選取。 使用替代選取項目時，捷徑會變更，如下所示：
- 若要在儲存格中建立多個游標：
- 在 macOS 上，按住
Cmd鍵，然後點擊每個位置以新增游標。 - 在Windows時，長按
Ctrl鍵，點擊每個位置即可新增游標。
- 在 macOS 上，按住
- 若要選取欄中的多個項目，請用滑鼠點擊您想要擷取的區域左上角。 Then:
- 在macOS上，按
Option並拖曳到右下角以擷取一或多個數據行。 - 在Windows時，按
Alt並向右下角拖曳以捕捉一欄或多欄。
- 在macOS上，按
要開啟替代捷徑，請執行以下步驟：
- 在工作區右上角點選你的使用者名稱，然後在下拉選單中點選 設定 。
- 在 [設定] 側邊欄中，選取 [開發人員]。
- 在 Code editor 區段中，將 多重游標點擊鍵修飾符 設定更改為 macOS 的 Cmd，或 Windows 的 Ctrl。
當你開啟替代快捷鍵時，建立多個垂直對齊游標的鍵盤快捷鍵不會改變。
瀏覽資料
使用架構瀏覽器來探索該筆記本中可用的 Unity Catalog 物件。 按兩下筆記本左側的 [ ![資料] 圖示](../_static/images/product-icons/dataicon.svg){kind=icon}
，以開啟架構瀏覽器。
For you 按鈕只會顯示您在目前會話中使用的物件或先前標示為 [我的最愛] 的物件。
當您在 [篩選] 方塊中輸入文字時，顯示會變更，只顯示包含您輸入之文字的物件。 只有目前開啟或已在目前會話中開啟的物件才會出現。 篩選器框不會完整搜尋筆記本可用的目錄、結構、表格和卷冊。
若要開啟 
，請將游標暫留在物件的名稱上方，如下所示：
架構瀏覽器中的 
如果對象是資料表，您可以執行下列動作：
- 自動建立並執行數據格，以顯示資料表中的數據預覽。 從表格的「kebab」功能表中，選擇 [在新單元格 中預覽
]。 - 在目錄總管中檢視目錄、架構或數據表。 從 kebab 功能表選取 [在目錄總管中開啟。 隨即開啟新的索引標籤，其中顯示選取的物件。
- 取得目錄、架構或數據表的路徑。 選取 [複製...從物件的 kebab 選單 路徑。
- 將數據表新增至我的最愛。 從表格的kebab選單中選取 新增至我的最愛。
如果對象是目錄、架構或磁碟區，您可以複製對象的路徑，或在目錄總管中開啟它。
若要將資料表或資料列名稱直接插入儲存格中：
- 將游標放在您要輸入名稱的儲存格位置。
- 將滑鼠游標移至架構瀏覽器中的資料表名稱或資料行名稱。
- 請點擊出現在物件名稱右側的
。
使用Web終端機和 Databricks CLI
若要在筆記本中開啟 Web 終端機，請按下終端機圖示 
在右側提要字段的底部。
在 Databricks Runtime 15.0 和更新版本中，您可以從筆記本中的 Web 終端機使用 Databricks CLI。 請參閱 在 Azure Databricks 網頁終端機執行 Shell 指令 以了解需求和使用資訊。
你不能從筆記本的儲存格執行 CLI 指令。 在筆記本中，像這類 %sh databricks ... 指令無法在 Databricks Runtime 15.0 或更高版本使用。
個人化自動完成
在您鍵入程式碼片段時，[自動完成] 會自動完成程式碼片段。 可完成的物件包括類型、類別和對象，以及 SQL 資料庫、資料表名稱、結構、對映、陣列和 查詢程式碼片段。 參照使用 SELECT * 的通用表達式（CTE）時，自動完成會根據基礎表格結構提供欄位建議。 Databricks 會使用您的 Unity 目錄元數據和使用方式來個人化建議。
- 對於 Python 儲存格，筆記本必須附加於計算資源才能使自動補全功能啟動；您必須執行所有用來定義可完成物件的儲存格。
- 對於 SQL 儲存格，自動補全會建議關鍵字和基本語法，即使筆記本沒有連接到任何運算資源。
- 如果工作區已啟用 Unity Catalog，自動完成也會建議 Unity Catalog 中資料表的目錄、結構、資料表和欄位名稱。
- 如果工作區未啟用 Unity Catalog，筆記本必須連接到多功能運算資源或 SQL 倉庫 來建議資料表或欄位名稱。
當您在儲存格中輸入時，自動完成建議會自動顯示。 使用向上鍵和向下鍵或滑鼠選取建議，然後按 Tab 或 Enter，將選取範圍插入單元格中。
Note
在 R 筆記本中，執行命令時伺服器自動完成功能會被封鎖。
自動完成功能預設為啟用，但可以在 使用者設定中停用：
- 若要關閉自動完成建議，請切換選項 [在輸入時自動完成]。 當自動完成關閉時，可以按 Ctrl + 空格 鍵來顯示自動完成建議。
- 若要防止 [Enter] 插入自動完成建議，請切換 [Enter 鍵接受自動完成建議]。
括號匹配
當您按下括弧、方括弧或大括弧附近時，編輯器會醒目提示該字元及其相符的括號。
Python 錯誤突顯
已啟用 合作夥伴支援的 AI 功能 的工作區也可以選取 [使用 Assistant 修正 ] 以取得 AI 輔助建議。
Databricks 筆記本支援下列錯誤醒目提示：
-
Python語法錯誤突出顯示：Python程式碼格中的任何語法錯誤都會以紅色標示。 如果可能的話，Genie Code 會建議你快速解決。 若使用 Databricks Runtime 12.1 及以上版本或無伺服器的計算裝置時，便能得到支援。 您可以使用
pyproject.toml檔案來設定語法錯誤醒目提示。 請參閱 配置 Python 語法高亮。 - Python格式錯誤突出顯示：Python程式碼格式錯誤與警告會依嚴重程度以黃色或紅色底線標示。 這有助於識別格式問題，例如非預期的縮排、長行長度等等。 將滑鼠停留在語法警告上方，查看詳細資訊。 若使用 Databricks Runtime 12.1 及以上版本或無伺服器的計算裝置時，便能得到支援。
- Python型別錯誤突出顯示：型別檢查能提升 Python 與 PySpark 專案中的程式碼品質、可讀性與維護性。 類型檢查程式可以在程式代碼執行之前，在函數調用中標記與不存在屬性、遺漏自變數和不相符自變數相關的錯誤。 將滑鼠停留在反白顯示的警告上方，以查看詳細資訊。 支援執行 Databricks Runtime 16.0 和更新版本或無伺服器環境 2 的計算。
啟用 Python 錯誤標示
要開啟或關閉錯誤標示，請執行以下步驟：
- 在工作區右上角點選你的使用者名稱，然後在下拉選單中點選 設定 。
- 在 [設定] 側邊欄中，選取 [開發人員]。
- 切換設定為 Python 語法錯誤高亮（Code editor）、Python 格式錯誤高亮（實驗特徵），及/或 Python 類型錯誤高亮（實驗特徵）。
配置 Python語法高亮
當筆記本 連接到執行 Databricks Runtime 16.4 或更新版本，或無伺服器環境第 3 版或更新版本的計算時，您可以建立 pyproject.toml 檔案來自訂語法醒目提示的方式。 對於特定筆記本，會使用其在 Workspace 檔案系統中直接祖先路徑中最近的 pyproject.toml 檔案。 如果在祖先路徑找不到，則會使用當前使用者主資料夾中的檔案 pyproject.toml 。
舉例來說，如果你有一台筆記型電腦，路徑是a/b/c/d/notebook.py，並且在pyproject.toml和a/b/pyproject.toml有a/b/c/pyproject.toml檔案，那麼第二個位置的檔案會被使用，因為它比較近。 位於pyproject.toml的/a/b/c/e/pyproject.toml檔案不會被考慮，因為它不在直接祖先路徑中。
Azure Databricks 對 pyproject.toml 檔案使用標準語法。 例如，您可以參考 Ruff 檔 ，瞭解如何使用 pyproject.toml 檔案設定 Ruff linter。
目前，Azure Databricks 僅支援設定 ruff、pylint、pyright 以及 flake8，以透過 pyproject.toml 進行 linting。
要啟用 linter， pyproject.toml 檔案必須有一個 [tool.<name-of-linter>] 區塊。
若要明確停用linter，請新增下列區塊：
[tool.<name-of-linter>]
disabled=true
你也可以用以下區塊停用 Azure Databricks 撰寫的語法高亮規則：
[tool.databricks]
disabled_rules = ['DB01', 'DB03']
由於 Flake8 預期設定的格式不同，因此您必須以字串形式傳入 Flake8 的組態：
[tool.flake8]
config = """ \
[flake8] \
extend_ignore = E303 \
"""
自訂 SQL 格式設定
你可以在新的 SQL 編輯器和筆記本編輯器中自訂 SQL 格式設定。 按兩下 [檢視 > 開發人員設定]。 向下捲動至 [SQL 格式 ]，並指定您的設定。
使用鍵盤快捷方式
若要顯示鍵盤快捷方式，請選擇 [說明] [說明] > 鍵盤快捷方式。 可用的鍵盤快捷方式取決於游標是否位於程式代碼數據格（編輯模式）或否（命令模式）。
下表顯示可用的鍵盤快速鍵。
編輯模式快速鍵
| 功能 | MacOS 捷徑 | Windows 捷徑 |
|---|---|---|
| 切換至指令模式 | Esc |
Esc |
| 運行命令並在下面插入新單元格 | Option + Enter |
Alt + Enter |
| 在上方插入儲存格 | Ctrl + Option + P |
Ctrl + Alt + P |
| 在下方插入儲存格 | Ctrl + Option + N |
Ctrl + Alt + N |
| 移至上一個/下一個儲存格 | Option + Up/Down |
Alt + Up/Down |
| 在游標處分割儲存格 | Ctrl + Option + - |
Ctrl + Alt + - |
| 刪除目前行 | ⌘ + Shift + K |
Ctrl + Shift + K |
| 刪除目前儲存格 | Ctrl + Option + D |
Ctrl + Alt + D |
| 向上移動或移動到上一個儲存格 | Up |
Up |
| 向下移動或移至下一個儲存格 | Down |
Down |
| 自動完成 | Ctrl + Space |
Ctrl + Space |
| 自動助理完成輸入 | Ctrl + Shift + Space |
Ctrl + Shift + Space |
| 內嵌助手 | ⌘ + I |
Ctrl + I |
| 參數提示 | ⌘ + Shift + Space |
Ctrl + Shift + Space |
| 文檔字串 |
⌘ + （K， I） |
Ctrl + （K， I） |
| 多個游標 | Option + Click |
Alt + Click |
| 欄（框）選擇 | Option + Shift + Drag |
Alt + Shift + Drag |
| 縮排/取消縮排選取範圍 | ⌘ + ]/[ |
Ctrl + ]/[ |
| 復原打字 | ⌘ + Z |
Ctrl + Z |
| 重做輸入 | ⌘ + Shift + Z |
Ctrl + Shift + Z |
| 切換行註解 | ⌘ + / |
Ctrl + / |
| 新增行註解 |
⌘ + （K， C） |
Ctrl + （K， C） |
| 移除行註解 |
⌘ + （K， U） |
Ctrl + （K， U） |
| 多游標編輯 | ⌘ + Option + Up/Down |
Ctrl + Option + Up/Down |
| 增加字型大小 | Option + + |
Alt + + |
| 縮小字型大小 | Option + - |
Alt + - |
命令模式快速鍵
| 功能 | Mac OS 捷徑 | Windows 捷徑 |
|---|---|---|
| 切換至編輯模式 | Enter |
Enter |
| 取消所選儲存格的執行 |
I、I |
I、I |
| 取消執行（略過提示） |
Shift + （I， I） |
Shift + （I， I） |
| 刪除目前儲存格 |
D、D |
D、D |
| 刪除目前儲存格 （略過提示） |
Shift + （D， D） |
Shift + （D， D） |
| 移至第一個儲存格 |
G、G |
G、G |
| 移至最後一個儲存格 | Shift + G |
Shift + G |
| 復原剪裁/刪除儲存格 | ⌘ + Z/Z |
Ctrl + Z/Z |
| 複製目前儲存格 | ⌘ + C |
Ctrl + C |
| 剪下目前儲存格 | ⌘ + X |
Ctrl + X |
| 貼上儲存格 | ⌘ + V |
Ctrl + V |
| 在上方插入儲存格 | A |
A |
| 在下方插入儲存格 | B |
B |
| 切換儲存格輸出 | O |
O |
| 切換儲存格標題 | T |
T |
| 向下捲動 | Space |
Space |
| 向上捲動 | Shift + Space |
Shift + Space |
| 切換鍵盤快捷鍵功能表 | H |
H |
| 與下面的儲存格合併 | Shift + M |
Shift + M |
| 移至上一個儲存格 | Up/P/K |
Up/P/K |
| 移至下一個儲存格 | Down/N/J |
Down/N/J |
| 將相鄰儲存格新增至選取範圍 | Shift + Up/Down |
Shift + Up/Down |
| 選取所有儲存格 | ⌘ + A |
Ctrl + A |
| 選取多個儲存格 | ⌘ + Click |
Ctrl + Click |
| 切換行號 | L |
L |
| 展開/收合儲存格標題 | Right/Left |
Right/Left |
共用捷徑
| 功能 | MacOS 捷徑 | Windows 捷徑 |
|---|---|---|
| 切換命令選擇器 | ⌘ + Shift + P |
Ctrl + Shift + P |
| 尋找 | ⌘ + F |
Ctrl + F |
| Replace | Ctrl + Option + F |
Ctrl + Alt + F |
| 格式化程式碼 | ⌘ + Shift + F |
Ctrl + Shift + F |
| 執行命令並移至下一個儲存格 | Shift + Enter |
Shift + Enter |
| 執行選取的命令 | ⌘ + Enter |
Ctrl + Enter |
| 除錯儲存格 | Option + Shift + D |
Alt + Shift + D |
| 偵錯工具：繼續 | F7 |
F7 |
| 偵錯工具：下一行 | F8 |
F8 |
| 偵錯工具：進入單步執行 | F9 |
F9 |
| 偵錯工具：步出 | Shift + F9 |
Shift + F9 |
| 執行所有命令 | Option + Shift + Enter |
Alt + Shift + Enter |
| 執行上述所有命令（獨佔） | Option + Shift + Up |
Alt + Shift + Up |
| 執行下列所有命令 （含） | Option + Shift + Down |
Alt + Shift + Down |
| 清除系統狀態和結果輸出 |
0、0 |
0、0 |
| 執行選取的文字或作用中陳述式 | Ctrl + Shift + Enter |
Ctrl + Shift + Enter |
| 執行作用中 SQL 陳述式 | ⌘ + Shift + Enter |
Ctrl + Shift + Enter |
| 向上移動儲存格 | Ctrl + Option + Up |
Ctrl + Alt + Up |
| 向下移動儲存格 | Ctrl + Option + Down |
Ctrl + Alt + Down |
| 切換評論面板/添加評論 | Ctrl + Option + M |
Ctrl + Alt + M |
| 切換工作區面板 | Ctrl + Option + E |
Ctrl + Alt + E |
| 切換目錄面板 | Ctrl + Option + C |
Ctrl + Alt + C |
| 切換助理面板 | Ctrl + Option + A |
Ctrl + Alt + A |
| 切換焦點模式 | Ctrl + Option + O |
Ctrl + Alt + O |
| 關閉目前索引標籤 | Ctrl + Option + W |
Ctrl + Alt + W |
| 建立新分頁 | Ctrl + Option + T |
Ctrl + Alt + T |
| 切換到左側分頁 | Ctrl + Option + Left |
Ctrl + Alt + Left |
| 切換至右標籤頁 | Ctrl + Option + Right |
Ctrl + Alt + Right |
| 關閉所有索引標籤 | Ctrl + Option + Shift + A |
Ctrl + Alt + Shift + A |