上一篇
安装JDK环境,创建Java类文件编写代码,使用main方法作为入口,通过javac编译后运行class文件即可执行小程序。
Java小程序开发入门:一步步构建你的第一个程序
欢迎来到Java编程世界!无论你是编程新手还是想巩固基础,本文将通过一个实用案例带你快速上手Java开发,我们将创建一个文件管理工具,它能批量重命名文件夹中的文件并生成日志记录,这个程序既实用又能涵盖Java核心概念,让我们开始吧!
️ 一、环境准备(3分钟搞定)
-
安装JDK
- 下载最新 Oracle JDK 或 OpenJDK
- 配置环境变量(以Windows为例):
JAVA_HOME = C:Program FilesJavajdk-21 Path += %JAVA_HOME%bin
- 验证安装:终端输入
javac -version和java -version
-
选择开发工具
- 初学者推荐:IntelliJ IDEA Community版(免费)
- 备选方案:Eclipse 或 VS Code + Java扩展包
🧩 二、项目实战:文件批量处理器
我们将创建一个能实现以下功能的程序:

- 扫描指定文件夹的所有文件
- 按规则重命名文件(示例:添加前缀)
- 生成操作日志文件
完整代码(含详细注释)
import java.io.File;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardCopyOption;
import java.text.SimpleDateFormat;
import java.util.Date;
public class FileBatchProcessor {
public static void main(String[] args) {
// 1. 设置工作目录和前缀
String folderPath = "C:/MyDocuments/待处理文件"; // 修改为你的文件夹路径
String prefix = "2025_archive_"; // 自定义前缀
// 2. 创建日志文件
File logFile = new File(folderPath + "/rename_log.txt");
try {
// 3. 获取目录中的所有文件
File directory = new File(folderPath);
File[] files = directory.listFiles();
if (files == null) {
System.out.println(" 目录不存在或为空!");
return;
}
// 4. 处理每个文件
for (File file : files) {
if (file.isFile()) {
// 生成新文件名
String newName = prefix + file.getName();
Path source = file.toPath();
Path target = new File(file.getParent(), newName).toPath();
// 执行重命名
Files.move(source, target, StandardCopyOption.REPLACE_EXISTING);
// 记录日志
String logEntry = String.format("[%s] 重命名: %s -> %s%n",
getCurrentTime(),
file.getName(),
newName);
Files.write(logFile.toPath(), logEntry.getBytes(),
java.nio.file.StandardOpenOption.CREATE,
java.nio.file.StandardOpenOption.APPEND);
}
}
System.out.println(" 操作完成!查看日志: " + logFile.getAbsolutePath());
} catch (IOException e) {
System.out.println(" 发生错误: " + e.getMessage());
e.printStackTrace();
}
}
// 获取当前时间(用于日志)
private static String getCurrentTime() {
return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date());
}
}
️ 三、关键知识点解析
-
文件操作核心类
java.io.File:文件/目录的基础操作java.nio.file.Files:高级文件操作(推荐)Path:替代File类的现代API
-
异常处理机制
try { // 可能出错的代码 } catch (IOException e) { // 优雅处理错误 }Java强制处理受检异常(如IO操作),确保程序健壮性

-
时间格式化
SimpleDateFormat将日期转换为可读字符串,支持自定义格式如:yyyy年 |MM月 |dd日HH时 |mm分 |ss秒
🧪 四、运行与测试
-
编译程序
终端执行:javac FileBatchProcessor.java
-
运行程序
java FileBatchProcessor
-
验证结果

- 查看目标文件夹的文件名前缀是否更新
- 检查
rename_log.txt日志内容示例:[2025-05-20 14:30:15] 重命名: report.doc -> 2025_archive_report.doc [2025-05-20 14:30:15] 重命名: image.jpg -> 2025_archive_image.jpg
五、常见问题解决
| 问题现象 | 解决方案 |
|---|---|
java: 错误: 找不到符号 |
检查JDK安装,运行 java -version 确认版本 |
AccessDeniedException |
以管理员运行IDE或检查文件权限 |
| 日志文件未生成 | 检查目录写入权限,路径不要包含特殊字符 |
| 文件名乱码 | 启动时添加VM参数:-Dfile.encoding=UTF-8 |
六、学习资源推荐
- 官方文档
- Java SE 21文档
- 免费教程
- Oracle Java教程
- Mozilla Java指南
- 书籍
- 《Java核心技术 卷I》(Cay S. Horstmann)
- 《Effective Java》(Joshua Bloch)
提示:学习编程最有效的方式是动手修改代码!尝试扩展这个程序:
- 添加按扩展名过滤的功能
- 实现文件名序号自增
- 增加GUI界面(可研究JavaFX)
引用说明
- Java API文档:Oracle官方提供的标准库说明
- Java命名规范:遵循Google Java代码风格指南
- 文件处理最佳实践:基于《Java NIO》书籍(Ron Hitchens著)
通过这个案例,你已掌握Java基础语法、文件操作和异常处理的核心技能,编程如同搭积木——从简单模块开始,逐步构建复杂系统,现在打开你的IDE,开始创造吧!
