Java代碼的基本格式
Java代碼的規范格式是編寫和維護Java程序的基礎，其中包括類定義、方法定義、代碼縮進、大括號位置等。
1．核心規則
- 每個Java文件必須包含一個公共類（public class），且Java源文件的文件名必須和這個公共類的類名一致。
- Java源文件的后綴名為“.java”。
- 方法中包含返回類型、方法名、參數列表和代碼塊。
- 主方法（main）是Java程序的入口，格式為：
public static void main(String[] args) { ... }
- 通常使用4個空格或1個Tab鍵進行縮進，保持代碼層次清晰。
- 左大括號{與語句同行，右大括號}獨占一行。
2．示例代碼
示例
// 文件名：HelloWorld.java
public class HelloWorld { ?// 類名與文件名一致public static void main(String[] args) { ?// 主方法System.out.println("Hello, Java!"); ?// 輸出語句}
}運行結果
Hello, Java!
代碼解析
- public class HelloWorld：定義公共類，類名是HelloWorld，文件名必須為HelloWorld.java。
- public static void main(String[] args)：Java程序的入口方法。
- System.out.println("Hello, Java!")：將字符串“Hello, Java!”輸出到控制臺。
示例：
// 文件名：StudentInfo.java
public class StudentInfo { ?// 類名與文件名一致// 定義一個方法，輸出學生信息public static void printStudentInfo() {String name = "李華"; ?// 學生姓名int age = 20; ????????// 學生年齡String major = "計算機科學"; // 專業System.out.println("姓名: " + name);System.out.println("年齡: " + age);System.out.println("專業: " + major);}public static void main(String[] args) { ?// 主方法printStudentInfo(); ?// 調用方法}
}運行結果
姓名: 李華
年齡: 20
專業: 計算機科學
代碼解析
- public class StudentInfo：定義公共類StudentInfo，文件名必須為StudentInfo.java。
- public static void printStudentInfo()：定義一個靜態方法，用于輸出學生信息。
- public static void main(String[] args)：程序入口。
- printStudentInfo();：在main()方法中調用printStudentInfo方法。
3．常見錯誤
錯誤：公共類的類名與文件名不一致，例如，公共類的類名為Test但文件名為Hello.java。
解決方法：確保公共類的類名與文件名完全一致，包括大小寫一致。
錯誤：缺少Java程序的入庫main方法導致程序無法運行。
解決方法：確保程序包含public static void main(String[] args)。
錯誤：大括號位置不規范。
錯誤示例
public class Test {
public static void main(String[] args) ?// 左大括號未換行
{System.out.println("Hello");
}
}解決方法：左大括號{與語句同行，右大括號}獨占一行。
public class Test {public static void main(String[] args) {System.out.println("Hello");}
}Java中的注釋
程序中的注釋是用于解釋代碼邏輯，對代碼進行說明，在程序運行時不會起作用。Java中的注釋分為單行注釋、多行注釋和文檔注釋。
1．注釋類型
- 單行注釋：//，從//開始注釋到行尾。
// 這是一個單行注釋- 多行注釋：/* */，從/*開始到*/結束，可跨多行進行注釋。
/** 這是一個多行注釋* 可以跨越多行*/- 文檔注釋：/** */，可以通過javadoc工具用于生成API文檔。
/*** 計算兩個數的和* @param a 第一個加數* @param b 第二個加數* @return 返回兩數之和*/
public static int add(int a, int b) {return a + b;
}2．示例代碼
/*** 這是一個簡單的計算器程序* 可以計算加法、減法、乘法和除法* @author Java學習者*/
public class SimpleCalculator {public static void main(String[] args) {int num1 = 15; ?// 第一個操作數int num2 = 5; ??// 第二個操作數/* 計算并輸出結果?*/System.out.println("加法結果: " + (num1 + num2));System.out.println("減法結果: " + (num1 - num2));System.out.println("乘法結果: " + (num1 * num2));System.out.println("除法結果: " + (num1 / num2));}
}運行結果
加法結果: 20
減法結果: 10
乘法結果: 75
除法結果: 3
代碼解析
- Java源文件保存為“SimpleCalculator.java”。
- /** */：文檔注釋，描述類功能。
- //：單行注釋，解釋變量定義。
- /* */：多行注釋，注釋計算邏輯。
3．常見錯誤
錯誤：多行注釋未正確閉合。
錯誤示例：
/* 這是一個未閉合的多行注釋
System.out.println("Hello"); ?// 這行代碼會被注釋掉解決方法：確保/*和*/成對出現。
修改后的代碼
/* 修改后的多行注釋?*/
System.out.println("Hello"); ?// 這行代碼會被注釋掉錯誤：文檔注釋未放在類或方法前。
錯誤示例：
public class Test {public static void main(String[] args) {System.out.println("Hello"); ?// 文檔注釋不能放在這里/** 錯誤的文檔注釋位置 */}
}解決方法：文檔注釋需緊跟在類或方法定義之前。
修改后的代碼
public class Test {/** 修改后的文檔注釋位置 */public static void main(String[] args) {System.out.println("Hello"); ?// 文檔注釋不能放在這里}
}知識總結
1．代碼格式
- 公用類的類名必須與文件名一致，公用類中需包含main()方法作為程序的入口。
- 規范使用縮進和大括號。
2．注釋規范
- 單行注釋解釋局部邏輯。
- 多行注釋解釋復雜邏輯。
- 文檔注釋用于生成API文檔。
理論練習
選擇題：Java程序的入口方法是（）。
A．start() ???B．main() ???C．run() ???D．init()
答案：B
判斷題：文檔注釋可以嵌套在方法內部。（）
答案：錯誤。文檔注釋需要放在類或方法的前面。
填空題：Java中，單行注釋的符號是________，多行注釋的符號是________。
答案：//，/* */
實操練習
練習：編寫一個Java程序，輸出個人信息（姓名、年齡、愛好）。
要求：
- 使用文檔注釋描述類功能。
- 使用單行注釋解釋變量定義。
參考答案
/*** 個人信息輸出程序*/
public class PersonalInfo {public static void main(String[] args) {String name = "張三"; ?// 姓名int age = 25; ????????// 年齡String hobby = "編程"; // 愛好System.out.println("姓名: " + name);System.out.println("年齡: " + age);System.out.println("愛好: " + hobby);}
}運行結果
姓名: 張三
年齡: 25
愛好: 編程
說明：Java源文件保存為“PersonalInfo.java”。
練習：編寫一個Java程序，輸出個人信息（姓名、年齡、職業、所在城市）。
要求：
- 使用文檔注釋描述類功能。
- 使用單行注釋解釋變量定義。
參考答案
/*** 個人信息輸出程序*/
public class PersonalInfo {public static void main(String[] args) {String name = "王小明"; ?// 姓名int age = 28; ??????????// 年齡String occupation = "軟件工程師"; // 職業String city = "北京"; ???// 所在城市System.out.println("姓名: " + name);System.out.println("年齡: " + age);System.out.println("職業: " + occupation);System.out.println("所在城市: " + city);}
}運行結果
姓名: 王小明
年齡: 28
職業: 軟件工程師
所在城市: 北京
說明：Java源文件保存為“PersonalInfo.java”。
練習：編寫一個計算矩形面積的程序。
要求：
- 使用多行注釋解釋計算邏輯。
- 輸出面積結果。
參考答案
public class RectangleArea {public static void main(String[] args) {int length = 5; ?// 長int width = 3; ??// 寬/** 計算矩形面積的公式：面積?= 長?× 寬*/int area = length * width;System.out.println("矩形面積: " + area);}
}運行結果
矩形面積: 15
說明：Java源文件保存為“RectangleArea.java”。
練習：編寫一個計算三角形面積的程序。
要求：
- 使用多行注釋解釋計算邏輯。
- 輸出面積結果。
參考答案
public class TriangleArea {public static void main(String[] args) {double base = 10.0; ???// 底邊長度double height = 5.0; ??// 高度/** 計算三角形面積的公式：面積?= (底邊?× 高度) / 2*/double area = (base * height) / 2;System.out.println("三角形面積: " + area);}
}運行結果
三角形面積: 25.0
說明：Java源文件保存為“TriangleArea.java”。
)
