Java教程下载后怎么学？用小项目巩固核心知识

下载了一套 Java 教程，不等于已经开始学习。视频、电子书和示例代码只能提供材料，真正让知识变成能力的，是反复编写、运行、修改和解释代码。很多初学者容易陷入两种情况：一是连续看课却不动手，遇到空白编辑器就不知道怎么写；二是把示例复制到自己的环境里，代码一报错便怀疑工具或版本，却没有学会定位问题。

更稳妥的做法，是先选定一个学习目标，再用规模小、边界清楚的项目串起教程中的概念。本文会从下载教程后的整理方式讲起，逐步完成一个命令行待办事项程序。项目不依赖第三方库，适合练习变量、类、方法、集合、循环、条件判断、异常处理和输入校验。它不是生产级任务管理系统，也不会假装解决用户认证、并发或安全存储等问题；这些边界同样是学习的一部分。

一、先把下载的教程变成学习路线

下载的课程通常包含视频、讲义、练习代码和项目源码。先不要从第一个文件开始一路播放到底。花十几分钟检查目录结构，确认教程面向的 Java 版本、使用的 IDE、是否需要数据库或其他工具，并把“基础语法”“面向对象”“集合”“异常”“文件和网络”等内容标记出来。

学习材料的版本尤其值得核对。Java 8、Java 11、Java 17、Java 21 都可能出现在教程中，语言特性、标准库和工具链存在差异。初学时建议选择一个长期支持版本作为自己的练习环境，例如 Java 17 或 Java 21，并确认教程示例能否在该版本运行。本文的代码使用 Java 8 已提供的语言和标准库，较新的 JDK 也可以运行。

可以把每个知识点整理成三个问题：

• 它解决什么问题？例如，集合用来管理一组数据；方法用来组织可重复的操作。
• 最小示例怎么写？不要只记概念，至少亲手写一个能运行的例子。
• 它不负责什么？例如，集合能保存程序运行期间的数据，但进程结束后数据通常不会自动保留。

教程的示例代码可以用来对照，但建议自己重新输入关键部分。打字不是目的，重要的是写之前先猜程序会做什么，运行后再解释实际结果。遇到报错时，把完整错误信息和触发步骤记下来，而不是只截取最后一行。

二、先确认 Java 环境，再开始写项目

Java 开发至少要区分两个概念：JDK 是开发工具包，包含编译器和运行时相关工具；IDE 是集成开发环境，负责编辑、导航、调试等便利功能。安装 IDE 不代表 JDK 一定配置正确，反过来，安装 JDK 后也可以用命令行编译运行。

在终端执行下面两条命令：

java -version
javac -version

两条命令都应该能显示版本信息。若系统提示找不到命令，通常需要安装 JDK，并按操作系统说明配置环境变量；配置方式因操作系统和安装方式不同，不应盲目复制其他系统的路径。若两条命令显示的主版本不一致，先检查 PATH 中是否存在多个 JDK。

本文采用单文件示例，不需要 Maven、Gradle 或数据库。新建目录 java-small-project，在其中创建文件 TaskApp.java。文件名必须与公共类 TaskApp 一致，这是 Java 对公共顶层类文件名的要求之一。

三、项目目标：做一个命令行待办事项程序

程序支持四种操作：新增任务、查看任务、完成任务、退出。我们会先把需求限定在内存中：程序运行时任务保存在集合里，退出后数据消失。这个限制是有意的，先把对象、集合和输入流程写清楚，再讨论文件持久化，避免初学时同时被语法、文件格式和异常处理绊住。

程序还需要处理几类输入边界：用户输入空标题、输入不是数字的菜单选项、选择不存在的任务编号，以及直接关闭输入流。示例会尽量妥善处理这些情况，但它仍是本地练习程序，不具备多用户、权限控制、审计日志或远程访问能力。

四、可运行代码：TaskApp.java

将下面代码完整保存为 TaskApp.java。注意代码块中的 HTML 特殊字符已转义；复制时应复制代码显示内容本身，而不是把实体写入 Java 源文件。例如，代码里的小于号显示为 <，实际 Java 代码应是 < 所代表的字符。

import java.util.ArrayList;
import java.util.List;
import java.util.Scanner;

public class TaskApp {
    private final List<Task> tasks = new ArrayList<>();
    private int nextId = 1;

    public static void main(String[] args) {
        new TaskApp().run();
    }

    private void run() {
        try (Scanner scanner = new Scanner(System.in)) {
            boolean running = true;

            while (running) {
                printMenu();
                String choice = scanner.nextLine().trim();

                switch (choice) {
                    case "1":
                        addTask(scanner);
                        break;
                    case "2":
                        listTasks();
                        break;
                    case "3":
                        completeTask(scanner);
                        break;
                    case "0":
                        running = false;
                        System.out.println("已退出。");
                        break;
                    default:
                        System.out.println("无效选项，请输入 1、2、3 或 0。");
                }
            }
        }
    }

    private void printMenu() {
        System.out.println();
        System.out.println("=== 待办事项 ===");
        System.out.println("1. 新增任务");
        System.out.println("2. 查看任务");
        System.out.println("3. 完成任务");
        System.out.println("0. 退出");
        System.out.print("请选择：");
    }

    private void addTask(Scanner scanner) {
        System.out.print("请输入任务标题：");
        String title = scanner.nextLine().trim();

        if (title.isEmpty()) {
            System.out.println("标题不能为空，未添加任务。");
            return;
        }

        Task task = new Task(nextId++, title);
        tasks.add(task);
        System.out.println("已添加任务，编号为 " + task.getId() + "。");
    }

    private void listTasks() {
        if (tasks.isEmpty()) {
            System.out.println("当前没有任务。");
            return;
        }

        System.out.println("任务列表：");
        for (Task task : tasks) {
            String status = task.isDone() ? "已完成" : "未完成";
            System.out.println(task.getId() + ". [" + status + "] "
                    + task.getTitle());
        }
    }

    private void completeTask(Scanner scanner) {
        if (tasks.isEmpty()) {
            System.out.println("当前没有任务可完成。");
            return;
        }

        System.out.print("请输入要完成的任务编号：");
        String input = scanner.nextLine().trim();

        final int id;
        try {
            id = Integer.parseInt(input);
        } catch (NumberFormatException e) {
            System.out.println("编号必须是整数。");
            return;
        }

        for (Task task : tasks) {
            if (task.getId() == id) {
                if (task.isDone()) {
                    System.out.println("该任务已经完成。");
                } else {
                    task.setDone(true);
                    System.out.println("任务已完成。");
                }
                return;
            }
        }

        System.out.println("找不到编号为 " + id + " 的任务。");
    }

    private static class Task {
        private final int id;
        private final String title;
        private boolean done;

        private Task(int id, String title) {
            this.id = id;
            this.title = title;
            this.done = false;
        }

        private int getId() {
            return id;
        }

        private String getTitle() {
            return title;
        }

        private boolean isDone() {
            return done;
        }

        private void setDone(boolean done) {
            this.done = done;
        }
    }
}

在项目目录打开终端，执行：

javac TaskApp.java
java TaskApp

第一条命令用 Java 编译器生成 TaskApp.class 等字节码文件；第二条命令启动程序。注意运行时写类名 TaskApp，不要写成 java TaskApp.class。如果编译或运行失败，先确认当前目录中确实有 TaskApp.java，再查看报错指出的行号和符号。

五、逐段理解：代码里练到了哪些核心知识

1. 类、对象和封装

TaskApp 是程序入口所在的类。main 是 JVM 启动应用时调用的方法，它创建一个 TaskApp 对象并调用 run。Task 则表示一条任务数据，它有编号、标题和完成状态。

字段使用 private 修饰，说明外部代码不能直接访问这些字段；调用者通过方法读取或修改状态。这是封装的基本做法。id 和 title 是 final，表示对象创建后不能重新指向其他值；done 则可以随任务状态变化。这里的 final 不会让整个对象自动变成不可变对象，因为 done 仍能改变。

2. 集合与泛型

List<Task> 表示一个按顺序保存 Task 对象的列表。ArrayList 是它的一种实现。尖括号中的 Task 是泛型参数，能帮助编译器检查放入和取出的类型，减少把不相关对象混进任务列表的错误。

当前示例按顺序遍历列表查找编号，时间复杂度随任务数量线性增长。对几十条练习数据完全够用；如果数据量大、查找频繁，可以考虑以编号为键的 Map。选择数据结构要看访问方式，不是所有场景都应该一开始就上复杂结构。

3. 方法、返回和职责划分

addTask 负责新增，listTasks 负责展示，completeTask 负责完成任务。方法拆分能让每段逻辑更容易阅读和测试。碰到空标题时，return 直接结束当前方法，避免继续创建无效对象。

初学者常把所有代码都塞进 main，短期看起来少写了几个方法，随着分支增多却很难定位问题。也不要为了“面向对象”把每一行都抽成一个类；合理的拆分依据是数据和职责，而不是类的数量。

4. 循环、分支与输入处理

while 让菜单重复显示，直到用户输入 0。switch 根据菜单选项执行不同操作，for-each 用来遍历任务列表。每种结构各有用途：需要知道索引时通常用带索引的循环；只读遍历集合时，增强型 for 通常更直接。

程序统一使用 nextLine() 读取一整行，再对编号调用 Integer.parseInt。这样避免了新手常见的 Scanner.nextInt() 与 nextLine() 混用问题：前者通常只读取数字，不会消费行末换行符，随后一次 nextLine() 可能立刻读到空行。

5. 异常是可预期边界，不是万能兜底

编号转换可能遇到字母或空字符串，因此代码捕获 NumberFormatException，给出明确提示并结束当前操作。捕获范围只包围可能失败的转换，而不是用一个大范围的 catch (Exception e) 把整个程序包起来后什么都不处理。

如果所有异常都被忽略，表面上程序似乎“不会报错”，实际故障原因却被隐藏。异常处理应当回答两个问题：哪些失败是可预期的？失败后应当恢复、提示用户，还是让程序终止？本例的非法编号属于可恢复的用户输入错误。

6. 资源管理与输入结束

try (Scanner scanner = new Scanner(System.in)) 使用了 try-with-resources。离开代码块时资源会自动关闭。命令行交互通常以输入流结束作为程序结束条件；在常见终端中，用户可以通过 EOF 结束输入。若要把输入流注入到多个组件，或由其他代码管理生命周期，资源归属需要重新设计，不应随意关闭由调用者拥有的流。

六、按测试清单验证边界

完成代码后，不要只测试“新增一个任务”这种顺利路径。用下面的场景逐项运行，观察结果是否符合需求：

1. 启动后直接输入 2：应提示当前没有任务。
2. 输入不存在的菜单选项：应提示无效选项，程序继续运行。
3. 新增时只输入空格：去掉首尾空白后为空，应拒绝添加。
4. 新增一个标题，再查看列表：编号、标题和“未完成”状态应正确显示。
5. 完成该编号：再次查看时状态应变成“已完成”。
6. 完成一个不存在的编号：应提示找不到任务，而不是崩溃。
7. 编号输入字母或空字符串：应提示编号必须是整数。

这些测试不是形式工作。输入边界通常比主流程更容易暴露假设，例如“用户一定输入数字”“列表一定非空”“字符串不会只有空格”。把边界写成明确的测试步骤，之后改代码时也更容易确认没有破坏已有行为。

七、常见错误及排查方法

错误一：文件名和公共类名不一致

若公共类叫 TaskApp，源文件应命名为 TaskApp.java。文件名大小写也要一致；在区分大小写的文件系统中，taskapp.java 与 TaskApp.java 不是同一个文件名。

错误二：直接运行源文件名或字节码文件后缀

传统编译流程是先运行 javac TaskApp.java，再运行 java TaskApp。java 后面是类名，不带 .class 后缀。部分较新版本的 Java 支持直接运行单文件源代码，但学习编译过程时，按两步执行更容易理解各工具的职责。

错误三：只看第一条错误信息

语法错误可能引发后续多条错误提示。先处理最早出现、指向源代码的错误，再重新编译。检查括号是否配对、字符串引号是否闭合、分号是否遗漏，以及粘贴时是否混入了网页格式字符。

错误四：把输入错误当成程序故障

用户输入的值需要验证。菜单输入不属于合法选项时，应该反馈并继续；任务编号不是整数时，应捕获对应转换异常。相反，不应捕获所有异常并静默忽略。两者区别在于：前者明确识别并处理预期输入，后者会掩盖真正的编程错误。

错误五：以为集合会自动保存数据

ArrayList 只存在于当前进程的内存中。程序退出后，任务列表消失是本项目的预期行为，不是 Java 出错。要持久保存，需要额外选择文件、数据库或其他存储方案，并处理读写失败、数据格式变化和权限等问题。

八、从基础项目继续扩展，但一次只增加一个目标

初版能正确运行后，可以依次扩展。每次新增一项能力，都先写清楚输入、输出和失败行为，再修改代码并重新执行测试清单。

• 增加删除任务：选择编号后删除对应对象。要考虑编号不存在、列表为空，以及删除后编号是否复用。通常保持编号不复用更容易识别旧任务。
• 按状态筛选：增加“仅看未完成任务”。可以先练习遍历和条件判断；数据量变大后再考虑查询封装。
• 限制标题长度：例如规定标题不能超过 100 个字符。字符长度的定义需要明确；Java 的 String.length() 计算的是 UTF-16 代码单元数量，对某些 Unicode 字符未必等于用户所理解的字形数量。练习项目若采用简单限制，应在提示中说明口径。
• 写入本地文件：先定义数据格式，再写入和读取；对文件不存在、内容损坏、字符编码、路径权限和部分写入制定处理方式。不要把“保存成功”打印在实际写入之前。
• 补充自动化测试：将任务逻辑与终端输入输出分开后，可以对新增、完成和无效编号等行为写单元测试。测试工具本身也需要按项目构建方式添加依赖。

做持久化时不要简单地把用户标题拼接成带分隔符的文本，再假设标题永远不含分隔符。否则数据可能被错误拆分。可选择定义可靠的格式并处理转义，或使用成熟的序列化与存储方案。Base64 只能编码数据，不能加密，也不能验证数据来源。

九、这个练习程序的安全边界

示例只在本地终端接收输入、在屏幕上展示文本，没有打开网络端口，也没有访问数据库。它不处理密码、支付信息、个人身份信息或其他敏感数据，因此不应把它描述为具备认证或数据保护能力。

如果后续把它改造成 Web 服务，不能直接把本示例视为安全的服务器端实现。需要另外考虑身份认证、授权、请求校验、输出编码、日志中的敏感信息、并发访问、数据库参数化查询、传输加密和部署配置等问题。具体措施应结合实际框架与威胁模型选择，不能仅靠“加密一下”或添加一个输入框就宣称安全。

同样，输入校验的作用是保证程序按预期处理数据，不等于完整的安全防护。比如校验标题非空有助于维护业务规则，但无法替代授权检查，也不能阻止所有恶意输入。边界条件、业务正确性和安全控制是相关但不同的工作。

十、怎样判断自己真的学会了

如果只是复制代码后看到菜单出现，还不足以说明掌握了核心知识。可以合上示例，尝试回答并验证这些问题：

• 为什么任务列表声明为 List<Task>，实际创建对象却是 ArrayList<>？
• 为什么任务编号和标题是 final，完成状态不是？
• 输入字母时，哪一行可能抛出异常？为什么捕获的异常类型是 NumberFormatException？
• 程序关闭后，为什么任务不会保留？需要增加什么类型的能力？
• 如果任务数量很多，当前按编号查找的方式有什么局限？

接着，独立实现一个变化版本，例如“图书借阅清单”或“购物清单”，保留对象和集合的练习，把任务字段替换成书名、作者或商品名称。若只能照着原代码改字面量，说明还需要继续练习；若能说明每个方法负责什么、哪些输入会失败，并能通过测试验证改动，才算真正把概念连起来。

结语：教程是材料，项目才是练习场

Java 教程下载后，最有效的学习方式不是尽快看完，而是建立一条可检验的路径：确认版本和环境，阅读一小段内容，独立写出最小示例，再用小项目组合知识，最后主动测试边界并解释结果。本文的待办事项程序刻意保持简单，重点不在功能数量，而在把类、对象、集合、流程控制、输入校验和异常处理放进一个可运行的场景。

先让一个小程序正确、可解释地工作，再逐步添加文件保存、测试和更复杂的结构。每一步都明确它解决的问题与留下的限制，学习就不再停留在“看过语法”，而会逐渐变成能够独立分析和实现需求的能力。