在 SSH 里写下第一个 Java 程序

先确认自己在哪里、工具是不是 17。source 这一行让当前 shell 临时使用课程提供的 JDK；它只影响这个终端窗口，不会改系统默认设置。

$ source ~/java-practice/env.sh
$ java -version
$ javac -version
$ pwd

java -version 和 javac -version 都应出现 17.x（例如 17.0.20.1）。java -version 把版本写到标准错误（stderr），这是正常现象，不是报错。pwd 显示当前工作目录，刚登录时通常是 /root 或 /home/你的用户名。

如果 source 提示找不到文件，说明课程环境还没准备好；回 setup.html 按顺序做，不要用 apt install 之类的方法自己补 JDK。服务器上还有别的服务，装错版本会影响别人。

每个小节用独立目录，避免上一节的 Hello.class 和这一节混在一起。下面的 mkdir -p 表示“目录不存在就建，已经存在也不报错”；cd 进入目录；pwd 再确认一次。

$ mkdir -p ~/java-practice/lesson01
$ cd ~/java-practice/lesson01
$ pwd
$ ls -la
$ if [ -e Hello.java ]; then mv Hello.java "Hello.java.bak.$(date +%s)"; fi

最后一行是保护动作，拆开看：

• [ -e Hello.java ]：测试 Hello.java 是否存在；
• mv Hello.java "Hello.java.bak.$(date +%s)"：存在就改名，$(date +%s) 会插入当前时间的秒数，所以备份名不会重复；
• 双引号把文件名包住，避免空格或特殊字符出问题；
• 文件不存在时，if 什么也不做。

这里出现的是 **shell 的 if**，不是 Java 的 if；本单元不教 Java 分支，看到它不用紧张。ls -la 现在应该只看到 .、..，或者你以前留下的备份；如果看到 Hello.java 已经被改名成 Hello.java.bak.数字，说明保护生效了，旧内容还在。

nano 是 Linux 上最简单的文本编辑器。它必须单独占一个命令块：如果把 nano 和后面的 javac 放在同一块里复制，编辑器会“吞掉”后面的命令，看起来像卡住。

$ nano Hello.java

打开后，把下面这一整份内容粘贴进去。粘贴完按 Ctrl+O，屏幕底部会问文件名，直接按 Enter 确认；再按 Ctrl+X 退出。记不住就念一遍：Ctrl+O、Enter、Ctrl+X。如果服务器没有 nano，可以用 vi Hello.java：按 i 进入插入模式，粘贴后按 Esc，输入 :wq 再回车。

public class Hello {
    public static void main(String[] args) {
        System.out.println("你好，Java！");
    }
}

逐行认识这份源码：

• public class Hello：声明一个叫 Hello 的类。class 是 Java 的“类”关键字，现在把它当成程序的外壳；public 表示这个类可以被外部启动。
• 两个花括号 { 和 }：包住类的内容。花括号必须成对，少一个就会编译失败。
• public static void main(String[] args)：程序的入口方法。main 这个名字和参数写法是 Java 规定的，先照写。
• System.out.println("你好，Java！")：把双引号里的文字打印到屏幕，并换一行。System 是 Java 自带的系统类，out 是输出通道，println 是“打印一行”。
• 行末的分号 ;：Java 语句的结束标记，不能省。
• 缩进只是为了人看，Java 不靠缩进判断层次；但保持缩进能让错误更容易发现。

源码里的标点必须是英文半角：();{}" 这些字符。中文引号 “”、中文分号 ； 会让编译器看不懂。字符串里面的中文是内容，可以正常写。

先看文件在不在、编码是不是 UTF-8，再编译。javac 是 Java 编译器，它读 .java 源文件，生成 .class 字节码文件；字节码是给 Java 虚拟机（JVM）执行的中间格式，不是给人直接读的。

$ ls -l Hello.java
$ file Hello.java
$ javac -encoding UTF-8 Hello.java
$ ls -l Hello.class

file Hello.java 一般会显示 UTF-8 text 或 Unicode text 之类；如果显示别的编码，先回编辑器确认保存格式。javac 成功时不会打印“成功”两个字，这是命令行工具的常见习惯：没有输出通常就是成功。ls -l Hello.class 能看到文件，才说明编译真的产出了结果。

-encoding UTF-8 明确告诉编译器按 UTF-8 读源码。UTF-8 是一种把字符存成字节的编码；源文件里有中文时建议每次都写，换一台机器或换一个 locale，少了它就可能出现乱码或“不可映射字符”。

编译成功后，用 java 启动类。注意这里写的是类名 Hello，不是文件名 Hello.java，也不是 Hello.class。

$ java Hello

屏幕上应该出现：

你好，Java！

java Hello 会在当前目录（默认 classpath）找 Hello.class，然后从 main 方法开始执行。classpath 是 JVM 查找 .class 的路径列表，默认包含当前目录。System.out.println 写出的内容就是标准输出（stdout），也就是上面 output 块里的那一行。网页把 output 标成只读，是因为它是程序结果，不是你要输入的命令。

如果 java Hello 报“找不到或无法加载主类”，先别改代码，按顺序检查：pwd 是不是 ~/java-practice/lesson01、ls -l Hello.class 在不在、javac 那一步有没有报错。运行和编译是两层，不要把两类错误混在一起。

现在做一个安全的实验：复制一份 Hello.java 叫 WrongName.java，但里面的 public class 仍然是 Hello。这会让编译器发现“public 类名和文件名不一致”。

$ if [ -e WrongName.java ]; then mv WrongName.java "WrongName.java.bak.$(date +%s)"; fi
$ cp Hello.java WrongName.java
$ javac -encoding UTF-8 WrongName.java
$ rm -f WrongName.java

cp 只复制，不改 Hello.java；rm -f WrongName.java 只删掉这次实验用的副本，不会碰你的 Hello.java 和 Hello.class。最后一行在 javac 报错后仍会执行，因为 shell 默认会继续跑后面的命令；如果你是一行一行手敲，看到错误后再敲 rm 也一样。

这个实验证明：类名和文件名一致不是“建议”，而是 public 类的硬性要求。实验完 ls -l 应仍能看到 Hello.java 和 Hello.class；如果 WrongName.java 还在，说明 rm 那行没执行，手动删掉这个临时副本即可。

最后改一次文件：把 Hello.java 的内容整份替换成下面这份，而不是只在末尾追加。整份替换可以避免花括号或分号漏掉。

$ nano Hello.java

打开后先删掉旧内容，再粘贴下面整份源码；保存方式仍是 Ctrl+O、Enter、Ctrl+X。

public class Hello {
    public static void main(String[] args) {
        System.out.println("你好，Java！");
        System.out.println("我的第一个类叫 Hello。");
    }
}

然后用单独的命令块重新编译、运行：

$ javac -encoding UTF-8 Hello.java
$ java Hello

输出应该是两行：

你好，Java！
我的第一个类叫 Hello。

每改一次源码都要重新 javac，再 java；只运行旧的 .class 不会看到新文字。反过来，如果只改文字不改类名，Hello.class 会被新编译结果覆盖，这是正常的构建产物更新。