「哇，又來一個人類女性。但這次是黑頭髮。真開心！」
「嗨，我叫金。」
「嗨，我叫阿米哥。」
「我知道。你的名字是我想到的。迪亞哥想不出這種好名字。」
阿米哥的思緒以電子奔騰的速度馳騁著。「嗯…她人好好喔…不知道她喜不喜歡機器人。」
「讓我們回到課堂吧。我會用簡單的方式把內容解釋給你聽。」
「OK。」
「我想幫教授和利施說過的內容加上說明。」
「在 Java 裡，你可以寫命令，你也可以直接在代碼裡那些命令旁邊加上註解 (comment)。編譯器會完全忽略那些註解。程式運行的時候，所有的註解都會被忽略。」
「可以請你給我一個範例嗎？」
「噢，當然：」
public class Home
{
public static void main(String[] args)
{
/*
現在我們要把『阿米哥是最棒的』這句話顯示在螢幕上
*/
System.out.print("阿米哥");
System.out.print("是");
System.out.print("最");
System.out.print("棒的");
}
} 「我們加了『現在我們要把…』這個註解。註解的開頭用一個符號對 (/*) 標示，結尾則是用 (*/) 標示。程式被編譯時，編譯器會忽略在符號 /* 和 */ 中間的所有東西。」
「也就是說我可以愛寫什麼就寫什麼？」
「是的。一般來說，代碼裡的註解是有關代碼中比較難懂的部分。有些註解是由好幾個字串構成的，通常寫在方法之前，以描述方法運作的原理細節。」
「要在代碼裡加上註解還有一種方法。你可以使用兩個前斜線 (//)。」
public class Home
{
public static void main(String[] args)
{
System.out.print("阿米哥");
System.out.print("是最"); // 這也是一個註解
System.out.print("棒的");
}
}「在這裡，從 // 開始一直到有 // 符號的同一行結束前的代碼，都被視為註解。也就是說，沒有第二個符號對來『完成註解』。」
「順帶一提，有些註解真的很有趣。」
// 這個代碼我是不負責的。他們強逼我寫的，我根本不願意。// 親愛的未來的我。我要祈求你的原諒。
// 我甚至不知道該從何開始表達我有多抱歉。// 如果再讓我看到這種東西，只要一次，我就要在辦公室精神崩潰了。// 如果這個條件居然成立了，
// 請通知我，有賞。電話： xxx-xxx-xxx。// 親愛的代碼維護者：
// 一旦你放棄嘗試『最佳化』這段程式，
// 並了解到這個嘗試是個糟糕的錯誤時，
// 請把下面這個計數變量加一，
// 好警告下個想嘗試的傢伙：
// total_hours_wasted_here = 42// 我之前寫這段碼的時候，只有老天爺和我知道我在幹嘛
// 而現在，天知道我在幹嘛// 我有時候相信編譯器會忽視所有我寫的註解。// 我要把所有的代碼和勞動獻給我的太太—達琳，
// 在這些代碼發佈給大眾使用以後，她就必須
// 要努力工作養我、我們的三個小孩和狗了。
// 已喝醉，以後再修// 神奇魔法。別碰它「真的耶，有些註解超好笑。」
「今天就到這裡吧。」
「真是一堂簡短但有趣的課。謝謝妳，金。」
GO TO FULL VERSION