跟着彦磊学Java系列为Java基础入门系列。通过此系列，我们将了解Java基础知识，包括变量、数据类型、运算符，选择结构、循环结构、数组等基本知识。此系列总结磊哥多年的经验，采用边讲边练的方式一起带领零基础的朋友走进Java世界。

本系列每章都会有大量的练习题，请大家在学习过程中，认真地进行练习，并和我提供的参考代码比较，反复感悟。要把一门语言学好，只学不悟是不可能学好的，用心自我感悟，多练，多想是学好一门语言的基础。

这是本系列的第二章

Java控制台输出语句

输出不换行

语法：System.out.print(“要输出的字符串”）;

作用：向控制台输出小括号中的字符串，输出后不换行。

注意：Java中的字符串必须用英文双引号包围。

例如：我们在记事本中写入下面代码

1. public class MyFirstProgram {2. public static void main(String[] args) {3. //代码中写了两行输出语句4. System.out.print("HelloJava");5. System.out.print("HelloWorld");6. }7. }

运行结果如下，我们看到print 方法输出是不换行的。

代码运行结果

输出并换行

语法：System.out.println(“要输出的字符串”）;

作用：向控制台输出小括号中的字符串，输出后换行，即在输出后多输出一个换行符。

注意： Java中的字符串必须用英文双引号包围。

例如：我们在记事本中写入下面代码

1. public class MyFirstProgram {2. public static void main(String[] args) {3. //代码中写了两行输出语句4. System.out.println("HelloJava");5. System.out.println("HelloWorld");6. }7. }

运行结果如下，我们看到println方法输出后加了换行符。

println方法输出结果

Java中的转义符

如果我们想输出英文的双引号等特殊字符如何做呢？在Java中我们可以通过转义符输出，转义符的引导符为””，如果我们想输出英文双引号就要按下面方法进行：

1. public class MyFirstProgram {2. public static void main(String[] args) {3.4. System.out.println(""");5.6. }7. }

输出结果为：

输出双引号的结果图

Java中常见的转义符

思考？

能不能用System.out.print()方法实现和System.out.println()方法一样的效果呢？

相信聪明的你一定想出了方法，下面是其中的一种

1. public class MyFirstProgram {2. public static void main(String[] args) {3. System.out.print("Hello JavarHello World");4. }5. }

练习一

请按下图的格式在控制台输出相应内容（因记事本编码问题，我们暂不输出中文，除非你知道如何调整记事本的编码）：

练习一输出结果

聪明如你，一定运行出了正确的结果。你也可以看一下文末的参考代码。

Java中的注释

注释在程序中是给我们程序员看的，Java编译时，不会对注释进行任何操作。写注释是写源码的一部分，一个良构的程序，注释应约占总代码量的1/3 左右。注释应实现以下作用：

  1. 写在类上（如我们上面写的代码中：class MyFirstProgram就是类)或方法（如我们上面写的代码中 main(String[] args)就是一个方法）的注释应注明类或方法的作用。

  2. 写在方法中的注释应是业务的思路（我们在今后的学习中会不断的学习）

  3. 写在变量中的注释应注明变量的作用(第四课开始我们将学习变量)

  Java语言中的注释共分三种

• · 单行注释
• · 多行注释
• · 文档注释

单行注释和多行注释

• 单行注释以//开头 后面写注释内容。
• 多行注释以 /*开头，以*/ 结束。

下面是添加了注释的代码：

1. public class MyFirstProgram {2. /*3. * main方法是程序的入口4. * main方法的四要素缺一不可5. * public 表示main方法是公有的6. * static 是静态方法，我们在后续将学习7. * void 表示方法不对外提供数据，我们后续将学习8. * 小括号中的String[] args 是参数，表示方法将从外部接收数据9. * 现在演示的的Java的多行注释，而不是文档注释，多行注释斜线后是一个＊号10. 　　 * 中间每行的*号是为了好看，不是必须。11. */12. public static void main(String[] args) {13. //向控制台中输出name和age，并输出一个空行14. System.out.println("nametttagen");15. System.out.println("LeiGettt18");16. System.out.println("My name is LeiGet18");17. }18. }

文档注释的作用很大，很强。下面描述中出现的新名词，大家可以先记忆，不用去理会，在后续的学习中，我们会逐渐的学习，在今后的学习中磊哥也会不断的强化注释。

· 在类、方法、属性上的文档注释的类或方法的描述，可以在开发工具中生成提示信息。

· 在类、方法、属性上的文档注释可以通过javadoc命令生成帮助手册（API) 。

· 文档注释以 /**开头（注意是两个*），以 */ 结束。

· 文档注释支持html语言。

文档注释写法很专业，今天我们只简单了解，在后续学习中，我们还会不断的了解文档注释，以生成更专业的API手册

  下面示例给类和方法添加了文档注释，注释中的<p></p>,<a …></a>等为html代码，主要是为了在帮助文档中用，不了解可忽略，注释一般分为三部分：

· 第一部分写类或方法的概要功能

· 第二部分写类或方法的详细功能

· 第三部分写类或方法的标注

  文档注释常见的标注：(除第一个和第二个外，其它大家仅需了解，在随后的学习过程中，我们会继续深化)

@author 程序的作者

@version 程序的版本

@param 程序的参数，有写，没有不写

@return 程序的返回值，有写，没有不写

1. /**2. * <p>写在类第一行的文档注释应是类的作用.</p>3. *4. * <P>空一行后这里写类的详细作用，支持html语法比如写上：</P>5. * <p>欢迎访问<a href="https://blog.csdn.net/weixin_42452652">彦磊的博客</a></P>6. * <p>其后可以写明作者等信息</p>7. *8. *<p>空一行后写文档标注，如作者、版本等</p>9. * @author 彦磊10. * @version 1.011. */12. public class MyFirstProgram {13. /**14. * <p>写在方法文档注释第一行的是方法的概要作用.</p>15. *16. * <p>空一行后写方法的详细作用</P>17. * <p>程序的入口.</p>18. *19. * <p>空一行后写文档的标注，如参数、返回值等.</p>20. * @param args 接收从控制台传入的参数.21. 　　*22. */23. public static void main(String[] args) {24. //向控制台中输出name和age，并输出一个空行25. System.out.println("nametttagen");26. System.out.println("LeiGettt18");27. System.out.println("My name is LeiGet18");28. }29. }

javadoc命令简介

  文档注释写完后，我们可以使用javadoc命令来生成API。

  java中的每个命令后加 -help参数都可获取到命令的使用帮助，下图演示了获取帮助的命令及部分帮助信息

执行成功后会在DOC目录下生成API文档

下面我们一一把注释和最终的效果对应一下，以更好理解文档注释。

点击”程序包”,出现下图，我们对应类的文档注释的第一行显示内容

点击上图绿框框住的文字，我们来对照方法的文档注释

练习一参考代码

1. public class MyFirstProgram {2. public static void main(String[] args) {3. //行末的n是为了多输出一个换行符4. //由于My name is LeiGe比较长，因此在name后加了三个t，用于对齐制表位。5. System.out.println("nametttagen");6. System.out.println("LeiGettt18");7. System.out.println("My name is LeiGet18");8. }9. }

练习二参考代码

1. /**2. * <p>写在类第一行的文档注释应是类的作用.</p>3. *4. * <P>空一行后这里写类的详细作用，支持html语法比如写上：</P>5. * <p>欢迎访问<a href="https://blog.csdn.net/weixin_42452652">彦磊的博客</a></P>6. * <p>其后可以写明作者等信息</p>7. *8. *<p>空一行后写文档标注，如作者、版本等</p>9. * @author 彦磊10. * @version 1.011. */12. public class MyFirstProgram {13. /**14. * <p>写在方法文档注释第一行的是方法的概要作用.</p>15. *16. * <p>空一行后写方法的详细作用</P>17. * <p>程序的入口.</p>18. *19. * <p>空一行后写文档的标注，如参数、返回值等.</p>20. * @param args 接收从控制台传入的参数.21. 　　　　　*22. */23. public static void main(String[] args) {24. /*25. * 向控制台中输出name和age，并输出一个空行26. * t 的作用是输出一个制表位27. * n的作用是输出一个换行符28. */29. System.out.println("nametttagen");30. //换行输出LeiGe及18，并用制表位和上一行对齐31. System.out.println("LeiGettt18");32. //换行输出My name is LeiGe及18，并用制表位和上一行对齐33. System.out.println("My name is LeiGet18");34.35.36. }37. }