一、前言
记录时间 [2024-04-21]
系列文章简摘：
Java 笔记 01：Java 概述，MarkDown 常用语法整理
Java 笔记 02：Java 开发环境的搭建，IDEA / Notepad++ / JDK 安装及环境配置，编写第一个 Java 程序
本文讲述了一些 Java 基础知识，包括注释、标识符、关键字等。也讲述了如何使用 IDEA 创建 Java 项目，如何搭建运行环境，以及在 IDEA 中如何编写 Java程序。还有 IDEA 中设置注释的字体颜色，IDEA 在创建 Java 类时自动生成 JavaDoc 的方式。
二、准备工作
1. 创建空的项目
在 IDEA 中创建一个 Java 项目用于 Java 基础的学习。
创建一个空项目：File ==> New ==> Project ==> Empty Project ==> Next ==> Finish
项目保存位置自行决定。
2. 创建 Java 模块
新建 Java 模块 Module：File ==> New ==> Module ==> Java ==> Next ==> Finish
笔者给模块取名为：BaseUse
3. 设置 SDK 和 Language
设置 SDK 和 Language：File ==> Project Structure ==> Project ==> SDK 1.8 ==> Language 8 ==> Apply
4. 测试环境
在 BaseUse 模块的 src 目录下新建 Java 文件，运行一个 HelloWorld，检测环境是否搭建完毕。
src 目录下：New ==> Java Class ==> HelloWorld
编写测试代码：
java">public class HelloWorld {public static void main(String[] args) {System.out.println("Hello, World!");}}
右键运行，选择 run "HelloWorld.main()"，可以看到，IDEA 下方控制台输出了 Hello, World!
项目环境正常。
三、注释
随着项目结构变得复杂，代码量开始增多，我们需要使用注释，不然的话，写的东西过几天就忘记了，而且也不利于团队协作。
注释不会被 Java 程序执行，是给写代码的人看的，从现在开始就养成书写注释的好习惯吧！
写注释非常重要，平时写代码要注意规范。
1. 注释的三种分类
- 单行注释
- 多行注释
- 文档注释
单行注释
单行注释用两个斜杠表示，后面可以写一行文字。
例如：
java">// 单行注释：注释一行文字
// 输出一个 Hello, World!
多行注释
多行注释可以注释一段文字，写好几行的那种，首尾用 /* */ 表示。
例如：
java">/* 多行注释：注释一段文字 */
/*我是多行注释我是多行注释我是多行注释
*/
文档注释 JavaDoc
文档注释是 /** 开头，*/ 结尾，注意区别多行注释。文档注释一般使用得比较少。
文档注释可以添加参数，且参数会被识别。
例如：@Description 添加描述；@Author 添加作者。
java">/*** @Description Hello, World!* @Author yuanyuan*/
2. 有趣的代码注释
笔者从网上搜集了一些有趣的 Java 代码注释，挑了几个喜欢的整理在下方了，感兴趣的朋友可以了解了解。
注意下方代码注释是从网上搜集的啊。
java">/*** _ooOoo_* o8888888o* 88" . "88* (| -_- |)* O\ = /O* ____/`---'\____* . ' \\| |// `.* / \\||| : |||// \* / _||||| -:- |||||- \* | | \\\ - /// | |* | \_| ''\---/'' | |* \ .-\__ `-` ___/-. /* ___`. .' /--.--\ `. . __* ."" '< `.___\_<|>_/___.' >'"".* | | : `- \`.;`\ _ /`;.`/ - ` : | |* \ \ `-. \_ __\ /__ _/ .-` / /* ======`-.____`-.___\_____/___.-`____.-'======* `=---='** .............................................* 佛祖保佑 永无BUG*//*** _ooOoo_* o8888888o* 88" . "88* (| -_- |)* O\ = /O* ___/`---'\____* . ' \\| |// `.* / \\||| : |||// \* / _||||| -:- |||||- \* | | \\\ - /// | |* | \_| ''\---/'' | |* \ .-\__ `-` ___/-. /* ___`. .' /--.--\ `. . __* ."" '< `.___\_<|>_/___.' >'"".* | | : `- \`.;`\ _ /`;.`/ - ` : | |* \ \ `-. \_ __\ /__ _/ .-` / /* ======`-.____`-.___\_____/___.-`____.-'======* `=---='* .............................................* 佛曰：bug泛滥，我已瘫痪！*//*** http://www.flvcd.com/* .--, .--,* ( ( \.---./ ) )* '.__/o o\__.'* {= ^ =}* > - <* / \* // \\* //| . |\\* "'\ /'"_.-~^`'-.* \ _ /--' `* ___)( )(___* (((__) (__))) 高山仰止,景行行止.虽不能至,心向往之。*//*** ░░░░░░░░░░░░░░░░░░░░░░░░▄░░* ░░░░░░░░░▐█░░░░░░░░░░░▄▀▒▌░* ░░░░░░░░▐▀▒█░░░░░░░░▄▀▒▒▒▐* ░░░░░░░▐▄▀▒▒▀▀▀▀▄▄▄▀▒▒▒▒▒▐* ░░░░░▄▄▀▒░▒▒▒▒▒▒▒▒▒█▒▒▄█▒▐* ░░░▄▀▒▒▒░░░▒▒▒░░░▒▒▒▀██▀▒▌* ░░▐▒▒▒▄▄▒▒▒▒░░░▒▒▒▒▒▒▒▀▄▒▒* ░░▌░░▌█▀▒▒▒▒▒▄▀█▄▒▒▒▒▒▒▒█▒▐* ░▐░░░▒▒▒▒▒▒▒▒▌██▀▒▒░░░▒▒▒▀▄* ░▌░▒▄██▄▒▒▒▒▒▒▒▒▒░░░░░░▒▒▒▒* ▀▒▀▐▄█▄█▌▄░▀▒▒░░░░░░░░░░▒▒▒* 单身狗就这样默默地看着你，一句话也不说。*//*** ┌─┐ ┌─┐* ┌──┘ ┴───────┘ ┴──┐* │ │* │ ─── │* │ ─┬┘ └┬─ │* │ │* │ ─┴─ │* │ │* └───┐ ┌───┘* │ │* │ │* │ │* │ └──────────────┐* │ │* │ ├─┐* │ ┌─┘* │ │* └─┐ ┐ ┌───────┬──┐ ┌──┘* │ ─┤ ─┤ │ ─┤ ─┤* └──┴──┘ └──┴──┘* 神兽保佑* 代码无BUG!*//*** ┌─┐ ┌─┐* ┌──┘ ┴───────┘ ┴──┐* │ │* │ ─── │* │ > < │* │ │* │ ... ⌒ ... │* │ │* └───┐ ┌───┘* │ │* │ │* │ │* │ └──────────────┐* │ │* │ ├─┐* │ ┌─┘* │ │* └─┐ ┐ ┌───────┬──┐ ┌──┘* │ ─┤ ─┤ │ ─┤ ─┤* └──┴──┘ └──┴──┘* 神兽保佑* 代码无BUG!*//*** ┌─┐ ┌─┐ + +* ┌──┘ ┴───────┘ ┴──┐++* │ │* │ ─── │++ + + +* ███████───███████ │+* │ │+* │ ─┴─ │* │ │* └───┐ ┌───┘* │ │* │ │ + +* │ │* │ └──────────────┐* │ │* │ ├─┐* │ ┌─┘* │ │* └─┐ ┐ ┌───────┬──┐ ┌──┘ + + + +* │ ─┤ ─┤ │ ─┤ ─┤* └──┴──┘ └──┴──┘ + + + +* 神兽保佑* 代码无BUG!*/
3. IDEA 设置注释颜色
IDEA 修改注释字体颜色方法：File ==> Settings ==> Editor ==> Color Scheme ==> Java ==> Comments
如图所示：给三种注释分别修改字体颜色。
4. IDEA 自动生成 JavaDoc
如果想要 IDEA 在创建 Java 类时，自动生成作者、时间等信息，那就进行如下设置。
File ==> Settings ==> Editor ==> File and Code Templates ==> Includes ==> File Header
示意图如下：
JavaDoc 参考模板如下：
java">// 模板/*** @author ${USER}* @data ${DATE} ${TIME}* @version 1.0*/
四、标识符和关键字
1. 关键字
回看我们之前写的 HelloWorld 程序：
- HelloWorld：类名，文件名
- public / class / static：关键字
java">public class HelloWorld {public static void main(String[] args) {String variable_name = "变量名";System.out.println("Hello, World!");}}
在 Java 程序中，不能使用关键字命名！比如，不能使用 class 作为文件名。
Java 中的关键字主要有如下这些：
| abstract | assert | boolean | break | byte |
|---|---|---|---|---|
| case | catch | char | class | const |
| continue | default | do | double | else |
| enum | extends | final | finally | float |
| for | goto | if | implements | import |
| instanceof | int | interface | long | native |
| new | package | private | protected | public |
| return | strictfp | short | static | super |
| switch | synchronized | this | throw | throws |
| transient | try | void | volatile | while |
2. 标识符
Java 所有的组成部分都需要名字。类名、变量名以及方法名都被称为标识符。
（对照 HelloWorld 程序）
- 类名：HelloWorld
- 变量名：variable_name
- 方法名：main
3. 注意事项
- 所有的标识符的首字符都是字母（A - Z 或者 a - z），美元符（ $ ）、或者下划线 （ _ ）；
- 首字符之后可以使用字母、美元符、下划线或数字，这四种字符的任意组合；
- 不能使用关键字作为变量名或方法名；
- Java 是强类型语言，标识符是大小写敏感的
- 可以使用中文命名，但是一般不建议，也不建议使用拼音
合法标识符举例：
java">// 合法标识符 字母开头
age
String Ahello = "user";
String hello = "user";// 合法标识符 美元符开头
$salary_value
String $hello = "user";// 合法标识符 下划线开头
__1_value
String _hello = "user";
非法标识符举例：
java">// 非法标识符 数字开头
123abc// 非法标识符 段横杠开头
-salary// 非法标识符 # 号开头
#abc
五、总结
本文讲述了一些 Java 基础知识，包括注释、标识符、关键字等。也讲述了如何使用 IDEA 创建 Java 项目，如何搭建运行环境，以及在 IDEA 中如何编写 Java程序。还有 IDEA 中设置注释的字体颜色，IDEA 在创建 Java 类时自动生成 JavaDoc 的方式。
一些参考资料
狂神说 Java 零基础：https://www.bilibili.com/video/BV12J41137hu/
TIOBE 编程语言走势： https://www.tiobe.com/tiobe-index/
Typora 官网：https://www.typoraio.cn/
Oracle 官网：https://www.oracle.com/
Notepad++ 下载地址：https://notepad-plus.en.softonic.com/
IDEA 官网：https://www.jetbrains.com.cn/idea/
