文章目录一、方法详解1.方法的定义2.方法的定义格式3. 方法的调用方式4.方法的多种形式1无参数无返回值2有参数有返回值3其他组合形式二、代码注释1. 注释的三种形式1单行注释2多行注释3文档注释2. 注释的使用规范3. 利用 AI 工具生成注释摘要本文系统梳理了 Java 中方法与代码注释两大基础知识点。方法部分从定义出发讲解方法的封装与复用价值拆解访问修饰符、静态修饰符、返回值类型、方法名、参数列表与方法体六要素并结合求和、打印等示例演示方法的调用方式最后归纳无参数无返回值、有参数有返回值等四种组合形式。注释部分介绍单行注释、多行注释与文档注释三种写法总结注释使用规范并演示如何借助通义灵码等 AI 工具自动生成注释。全文示例均可直接运行适合 Java 初学者快速建立方法与注释的完整认知。一、方法详解1.方法的定义方法是一段封装了特定功能的可重用代码块它能够接收输入数据、进行处理并返回结果也可以无返回结果。方法的核心作用是实现代码的模块化和复用。例实现求和功能publicstaticintsum(inta,intb){returnab;}上述代码通过sum()方法封装了两个整数相加的功能例打印功能publicstaticvoidprintHelloWorld(){System.out.println(hello world);System.out.println(hello world);System.out.println(hello world);}上述代码通过printHelloWorld()方法封装了重复打印 “hello world” 的功能2.方法的定义格式一个完整的方法定义包含以下几个部分访问修饰符如public、private、protected、defaultpublic公共同包、不同包、子类全能用。protected受保护同包内及不同包的子类可访问。default不写修饰符包私有仅同包内可访问。private私有只能本类内部访问。静态修饰符如static可选静态方法属于类本身调用时不用new对象通过类名.方法名()调用。非静态方法实例方法属于对象必须通过new创建对象后调用。返回值类型方法返回结果的数据类型无返回值时用void基本数据类型如int、double、boolean或引用类型如String、List、自定义类。void表示不返回任何值。方法名遵循驼峰命名法首字母小写应见名知意如getSum、calculateAverage、printUserInfo。参数列表方法接收的数据可空格式(数据类型 参数1, 数据类型 参数2, ...)。可为空()。方法体实现功能的代码块用{}包裹包含具体的执行语句。若有返回值必须使用return语句返回对应类型的数据。void方法可省略return或使用return;提前结束。示例拆解一个完整方法定义// 访问修饰符 静态修饰符 返回值类型 方法名(参数列表)publicstaticintcalculateSum(intnum1,intnum2){// 方法体开始intsumnum1num2;returnsum;// 返回结果// 方法体结束}例:求和方法3. 方法的调用方式方法定义后不会自动执行必须在其他方法通常是main方法中调用才能执行,调用格式方法名称参数列表。完整演示方法的执行求和方法publicclassDemo{//main方法publicstaticvoidmain(String[]args){//目标掌握方法的定义与调用intsumgetSum(1,2);System.out.println(和为sum);System.out.println(------------);//同一个方法的不同使用intsum2getSum(3,4);System.out.println(和为sum2);}//求两个任意整数的和getSum方法publicstaticintgetSum(inta,intb){returnab;}}main方法是是程序入口它天生就是 static。Java 规定static 方法里只能直接调用其他 static 方法 / 变量。所以求和方法也必须是 static4.方法的多种形式根据是否需要接收参数和返回结果方法可以分为以下几种形式1无参数无返回值当方法既不需要接收数据也不需要返回结果时使用void作为返回值类型参数列表为空。例打印三行Hello WorldpublicclassDemo{publicstaticvoidmain(String[]args){printHelloWorld();}//无参数、无返回值publicstaticvoidprintHelloWorld(){System.out.println(Hello World!);System.out.println(Hello World!);System.out.println(Hello World!);}}2有参数有返回值当方法需要接收数据进行处理并返回处理结果时需要指定参数列表和返回值类型。例2生成指定位数的数字验证码’(只需掌握方法的定义格式)publicclassDemo{publicstaticvoidmain(String[]args){System.out.println(getCode(4));//获取4位验证码System.out.println(getCode(5));//获取5位验证码}//有参数、有返回值的方法publicstaticStringgetCode(intn){Stringcode;for(inti0;in;i){intnumber(int)(Math.random()*10);codenumber;}returncode;}}3其他组合形式有参数无返回值接收数据处理但不需要返回结果无参数有返回值不需要接收数据但需要返回结果二、代码注释在 Java 开发中合理使用注释是良好的编程习惯它具有以下重要作用提高代码可读性帮助自己和其他开发者理解代码逻辑便于维护当需要修改代码时注释可以快速指引核心逻辑辅助开发现代 AI 开发工具如通义灵码可以根据注释自动生成代码1. 注释的三种形式1单行注释使用//开头注释从//到本行结束的内容。// 这是一个单行注释用于解释单行代码intage18;// 定义年龄变量并赋值2多行注释使用/* 开头*/结尾可注释多行内容/* * 这是一个多行注释 * 可以用来解释一段代码的功能 * 或者暂时注释掉不需要执行的代码块 */inta10;intb20;intcab;3文档注释使用/**开头*/结尾主要用于生成 API 文档通常放在类、方法或字段的前面。/** * 计算器工具类 * 提供基本的加减乘除运算 */publicclassCalculator{/** * 计算两个整数的和 * param a 第一个整数 * param b 第二个整数 * return 两个整数的和 */publicstaticintadd(inta,intb){returnab;}}2. 注释的使用规范文档注释通常用于注释类、接口、方法和重要字段多行注释常用于注释代码块或复杂逻辑单行注释常用于注释单行代码或简单说明注释内容应当简洁明了准确反映代码意图避免注释显而易见的代码如int i 0; // 定义i并赋值03. 利用 AI 工具生成注释现代开发工具如通义灵码、IntelliJ IDEA 的 AI 助手等可以帮助自动生成注释提高开发效率。注意注释不会影响程序的执行编译器会忽略所有注释内容。良好的注释习惯是优秀程序员的基本素养。
