首頁 › 學習工具 › Jupyter 筆記本
了解每個儲存格,讓筆記本可重現。

AI Jupyter 筆記本助理
連結程式碼、輸出與說明

你的 Python 筆記本是否執行順序混亂、產生錯誤或缺少說明?提供簡報、相關儲存格、環境詳細資訊與追蹤錯誤資訊。使用 Verla 的學術程式碼支援審閱邏輯、改善 Markdown,並準備可在自己的筆記本環境中執行的檢查。

✦ 一起完成你的程式碼筆記本儲存格・狀態・可重現性
使用 Verla 審閱我的筆記本 ↗
開啟儀表板。在那裡重新輸入內容並上傳允許的資料;本頁不會傳輸資料、開啟筆記本或啟動 Kernel。
示範用筆記本儲存格

一個小而可檢查的計算

Markdown:說明目的與示範輸入。
values = [2, 4, 6]
total = sum(values)
assert total == 12
print(total)
預期標準輸出12
已用本機 Python 檢查;本頁和 Jupyter Kernel 都沒有執行。
靜態儲存格預覽,不是 Jupyter 筆記本檢視器、編輯器或線上執行環境。
三個實用步驟

如何使用 Verla 的 Jupyter 筆記本支援

讓問題可重現,審閱儲存格與說明,然後在指定的 Kernel 中驗證。

你的筆記本脈絡
📄 簡報+相關儲存格任務
▤ 環境+資料範例輸入
✎ 追蹤錯誤+預期輸出問題
01 / 提供

加入儲存格與環境詳細資訊

包含任務、相關程式碼與 Markdown、Python/Kernel/套件版本、完整追蹤錯誤資訊,以及獲准使用的小型資料範例。說明預期行為與執行儲存格的順序。

可審閱的儲存格順序
01 輸入與匯入定義
02 計算與檢查說明
03 輸出與敘述連結
02 / 改進

審閱原因,而不只是症狀

要求最小幅度的修正,並說明狀態或型別問題。釐清相依套件與假設,把建議的程式碼和已驗證的輸出分開。

乾淨的執行檢查
輸入 → 計算 → 檢查 → 解釋
新的 Kernel、已知的相依套件
在你的環境中執行・檢查
03 / 驗證

重新啟動、依序執行並檢查

在自己的環境中使用適當的重新啟動/全部執行流程,並將輸出與任務比較。記錄相依套件、檢查 Markdown,必要時檢查實際的匯出檔案。

先了解筆記本

什麼是 Jupyter 筆記本?應該如何使用?

Jupyter 筆記本 是 Jupyter 生態系中的筆記本撰寫應用程式。筆記本文檔結合程式碼儲存格、說明用 Markdown 與已儲存的輸出。程式碼透過 Kernel 執行;文件與執行中的狀態是不同的事物。因此,即使目前的儲存格順序無法重現,筆記本仍可能顯示舊的輸出。

從輸入與匯入到計算、檢查和解讀,整理整個工作流程,並從乾淨狀態開始測試。把程式碼執行與說明分開:Verla 關於 分析環境與學術修訂支援 的說明有助於釐清這條界線。筆記本支援應讓推理更容易檢查,而不能把尚未執行的建議說成已驗證的結果。

讓每個儲存格都能被說明

完成筆記本作業的六種方法

在所需的筆記本應用程式中檢查執行與環境行為,同時取得學術程式碼支援。

🧩

建立清楚的儲存格順序

按邏輯順序安排匯入、設定、輸入、計算與解讀。找出儲存格之間的相依關係,避免結果依賴被遺忘的互動步驟。

🔎

根據追蹤錯誤與狀態除錯

使用確切的失敗儲存格、例外與前置定義來隔離問題。說明最小幅度的變更,並檢查型別、路徑或相依套件,不要憑空創造遺失的變數。

📝

連結 Markdown 與程式碼

在相關計算旁說明目的、輸入、方法與限制。使用標題與表格支援論證,不要留下沒有解讀的程式碼。

✅

加入有意義的輸出檢查

測試適合任務的預期值、形狀、數量或邊界案例。斷言可以檢查條件,但不能證明方法或科學結論有效。

▣

謹慎說明資料與視覺化輸出

檢查單位、遺漏值、標籤,以及圖形所支援的主張。產生的繪圖程式碼在執行並檢查前只是提案;已儲存的影像不能證明目前的執行成功。

🔁

準備可重現性與匯出審閱

記錄 Kernel、相依套件與資料假設。驗證乾淨的執行並檢查必要的輸出格式;筆記本專用命令或元件可能無法在指令碼或 PDF 轉換中保留。

用於練習的 Jupyter 筆記本範例

筆記本工作入門的六個範本

這些是教學用的合成範例,不是即時筆記本介面。Python 程式片段已獨立檢查;這裡沒有執行 Jupyter Kernel、除錯器或 nbconvert 流程。

乾淨的儲存格順序
values = [2, 4, 6]
total = sum(values)
assert total == 12
print(total)
檢查/限制
預期標準輸出:12。程式片段中已定義所有變數;請從乾淨狀態檢查完整筆記本。
程式碼/順序

乾淨的儲存格順序

分開處理定義、計算與檢查。

開啟儀表板 ↗
Markdown 表格與說明
## Toy calculation

| Check | Expected |
| --- | ---: |
| Number of values | 3 |
| Total | 12 |
檢查/限制
將這段文字放入 Markdown 儲存格,並在筆記本應用程式中轉譯。HTML 卡片不是 Markdown 轉譯測試。
JUPYTER NOTEBOOK MARKDOWN

Markdown 表格與說明

用來記錄小型範例的 Jupyter 筆記本 Markdown 表格。

開啟儀表板 ↗
小型資料品質檢查
from statistics import mean
values = [10, 12, None, 14]
observed = [v for v in values if v is not None]
assert len(observed) == 3
print(mean(observed))
檢查/限制
預期標準輸出:12。4 個觀測值中有 3 個;遺漏不等於零。
資料/遺漏值

小型資料品質檢查

在進行描述性摘要前,明確處理遺漏值。

開啟儀表板 ↗
說明型別不相容
raw = ["2", "4", "6"]
values = [int(x) for x in raw]
assert sum(values) == 12
print(sum(values))
檢查/限制
修正後的標準輸出:12。對於真實資料,請在轉換前檢查無效字串與遺漏值規則。
除錯/型別

說明型別不相容

使用 sum(raw) 加總原始字串會引發 TypeError;在這個簡單任務中請有意地進行轉換。

開啟儀表板 ↗
規劃帶標籤的圖形
values = [2, 4, 6]
labels = ["A", "B", "C"]
assert len(values) == len(labels)
# Plot in your chosen library.
# Label the axis and synthetic units.
檢查/限制
合成高度為 A=2、B=4、C=6。繪圖與圖表轉譯尚未執行;請選擇函式庫並檢查實際圖形。
視覺化/規格

規劃帶標籤的圖形

讓標籤與數值對應,並說明視覺化應該呈現什麼。

開啟儀表板 ↗
審閱指令碼與 PDF 匯出
jupyter nbconvert --to script example.ipynb
jupyter nbconvert --to pdf example.ipynb
檢查/限制
只在具備 nbconvert 與必要相依套件的環境中執行。PDF 使用 LaTeX 路徑;指令碼輸出仍可能包含筆記本專用結構。
匯出/外部工具

審閱指令碼與 PDF 匯出

官方 nbconvert 命令模式,不是由本頁執行的轉換。

開啟儀表板 ↗

交接內容包含一份已清除輸出的 sample-notebook.ipynb,以及其中程式碼對應的 sample-notebook-code.py。程式碼只用本機 Python 檢查;Jupyter Kernel 執行、正式 nbformat 驗證、Markdown 轉譯、除錯介面與匯出仍未測試。

不同的筆記本難題

在工作流程中斷的地方使用筆記本支援

提供可重現的問題,不要只提供缺少環境或前置儲存格的螢幕擷取畫面。

🔁

只有以錯誤順序執行儲存格才會運作

結果依賴留在記憶體中的值。找出遺失的定義,並從新的 Kernel 檢查筆記本,不要依賴過時的輸出。

🛠️

儲存格出現型別或名稱錯誤

追蹤錯誤資訊指出了失敗,但原因並不清楚。在替換大段程式碼之前,檢查相關定義與輸入型別。

📝

筆記本有程式碼卻沒有說明

讀者看不出輸出的目的或意義。加入 Markdown,將輸入、方法、檢查與限制連結到作業問題。

📊

儲存的輸出與程式碼不一致

筆記本顯示來自上次執行的圖形或數值。在撰寫解讀之前,依正確順序重新執行並比較目前結果。

📁

筆記本在另一台電腦上失敗

路徑、套件或輸入假設不同。記錄相依套件並使用可重現的資料設定,不要假定 .ipynb 檔案包含所有必要資源。

📄

必要的匯出結果看起來不同

指令碼失去敘述版面,或 PDF 建立失敗。檢查匯出器、相依套件與筆記本專用功能,然後檢查實際產生的檔案。

常見問題

Jupyter 筆記本常見問題

關於 .ipynb 檔案、線上環境、Markdown、除錯與匯出的回答。

Jupyter 筆記本有什麼用途?

它用於結合程式碼、說明與輸出的互動式計算工作,包括學習、原型設計與資料探索。筆記本可以使用不同的 Kernel;Python 很常見,但不是唯一的語言。請使用 Jupyter 官方文件 來區分應用程式、文件格式與執行環境。

什麼是 .ipynb 檔案?

它是一種包含儲存格與中繼資料的 JSON 筆記本文檔,也可能包含已儲存的輸出與執行次數。它不只是一個 .py 指令碼,也不一定包含資料檔案或已安裝的相依套件。請參閱 筆記本格式說明。已儲存的輸出不能證明目前的程式碼可以成功執行。

如何開啟 ipynb 檔案內容並執行?

在 Jupyter Notebook 或 JupyterLab 等相容的筆記本應用程式中開啟檔案,並設定適當的 Kernel 與相依套件。執行前先檢查來源與出處。靜態 .ipynb 檢視器可以顯示已儲存的內容,但本身無法重現計算過程。本頁不會開啟上傳的筆記本,也不提供檢視器。

這裡提供線上的 Jupyter 筆記本或線上 Python 筆記本嗎?

這裡沒有實作託管 Kernel、線上 Jupyter Notebook 伺服器或瀏覽器程式碼執行。Verla 公開列出 Jupyter 筆記本作業,但經過驗證的執行環境與檔案檢視器支援尚未測試或建立。請使用核准的筆記本環境執行,並檢查其權限與資料政策;本頁提供規劃與審閱支援。

如何使用 Jupyter 筆記本 Markdown 與表格?

為標題、說明與支援的 Markdown 語法新增 Markdown 儲存格,然後在筆記本應用程式中轉譯。上方的表格範本展示簡單的管線表格寫法。讓敘述放在相關程式碼旁邊,並檢查轉譯結果,尤其是在匯出之後;實際顯示方式取決於轉譯器與輸出格式。

什麼有助於處理 Jupyter 筆記本除錯?

提供完整的追蹤錯誤資訊、失敗的儲存格、前置定義、輸入與環境版本。檢查隱藏狀態,並從乾淨的順序重新重現問題。互動式中斷點需要相容的介面與 Kernel;請參閱 JupyterLab 除錯器需求。本頁不會連接除錯器,也不會執行 AI 建議的修正。

如何將 Jupyter 筆記本匯出成 PDF?

使用應用程式支援的匯出流程,或在具備必要相依套件的環境中使用 nbconvert。--to pdf 路徑透過 LaTeX 建立;--to webpdf 會使用瀏覽器匯出器轉譯,並需要額外的需求。請查看 官方轉換指南 ,並檢查方程式、表格與圖形。這裡不會執行或保證 PDF 轉換。

如何將 Jupyter 筆記本轉換成 py?

對於 Python 筆記本,在設定適當的環境中執行 nbconvert --to script 可以產生 Python 指令碼。這是外部工具流程,不是內嵌在本頁的轉換器。筆記本魔法、元件、儲存格狀態或環境假設可能需要調整,指令碼才能正常執行。請審閱並測試實際指令碼;隨附的範例程式碼是直接撰寫的,不是由 nbconvert 產生。

讓儲存格可重現。
讓推理更清楚。

提供你的任務、儲存格與環境詳細資訊。透過一份可以檢查並驗證程式碼、檢查結果與說明的筆記本完成工作。

開始我的筆記本支援 ↗
AI Jupyter 筆記本助理 – 範例、除錯與 Markdown | Verla