代码注释

我们先来碰一碰上一篇教程里面留下的编程小练习,算是为第二天的学习任务开场。

要想在屏幕上打印“Hello Java!”这句话,比较能够想到的做法是直接在示例代码基础上修改,将双引号里面的字符内容由“Hello World!”变成“Hello Java!”,然后保存一下代码并运行代码。

public class HelloWorld {

    public static void main(String[] args) {
        System.out.println("Hello Java!");
    }
}

这可能是大部分人的做法,有的可能想自己来创建新的Java工程,然后在里面来更改代码,最后也实现了目的。

public class HelloJava {

    public static void main(String[] args) {
        System.out.println("Hello Java!");
    }
}

第二种做法就比较有挑战性,但是这种主动挑战、主动练习的思路,极大地帮助自己加深了对创建Java工程、添加Java源代码文件以及编写代码这三个核心步骤的理解。

第三种做法就跟这篇教程的主题相关。这里先贴上完整代码,

public class HelloWorld {

    public static void main(String[] args) {
        // System.out.println("Hello World!");
        System.out.println("Hello Java!");
    }
}

这段代码的主要做法是先复制了第四行,接着在前面添加两个斜杠符号//,然后另起一行粘贴一下复制的代码,并将双引号里面的字符更改成“Hello Java!”。

如果你在自己的电脑上运行一下这段代码,会发现其输出结果就是我们想要的。自然你们可能会疑惑,好像前面添加了两个斜杠符号的代码并没有运行出结果。

在Java中,第四行代码

// System.out.println("Hello World!");

叫做代码注释,很多时候直接简称注释,英文单词是Comment。注释是存在于源代码里面的一些文本行,目的是方便我们人类理解代码,电脑在遇见这些注释的时候会跳过它们而不去执行。往往专业的Java程序员也会写出一手好注释,不单单是方便其他程序员快速理解自己的代码,也方便日后自己回顾代码。

以“//”开头的注释只能标记从”//”开始到本行结束的文字,常常叫做单行注释。

public class HelloJava {

    public static void main(String[] args) {
        // 整个程序最核心的一行代码
        System.out.println("Hello Java!");  // 在屏幕上打印"Hello Java!"
    }
}

单行注释常常用来说明某部分代码的功能,或者在开发程序时暂时不让其执行。

与很多编程语言一样,Java也支持多行注释,也叫跨行注释,由“/*…*/”和位于中间的所有字符构成。

public class HelloJava {

    /* main方法是整个程序的入口
    public指明其有公开权限
    static指明其是一个静态方法
    void是其返回类型
    */
    public static void main(String[] args) {
        // 整个程序最核心的一行代码
        System.out.println("Hello Java!");  // 在屏幕上打印"Hello Java!"
    }
}

上面这段代码里面第三行到第七行就是多行注释,电脑在遇见其时也会忽略不执行。如果需要从多方面简述某个类或者方法,可能使用跨行注释更好。

在后面教程的示例代码中,大家可能会经常看见注释的出现,这是为了说明代码的目的,更好地帮助大家理解。此外,在合适的地方添加注释也是一种好的编程习惯。

Comments

No comments yet. Why don’t you start the discussion?

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注