notepad++ 无法直接编译运行 java,需依赖系统已安装并正确配置 path 的 jdk,配合 nppexec 插件调用 javac 和 java 命令;关键要设编码为 utf-8 without bom、加 -encoding utf-8 参数、显式指定 -cp 当前目录。

Notepad++ 本身不能编译运行 Java
Notepad++ 是纯文本编辑器,没有内置 JDK 集成或构建能力。所谓“在 Notepad++ 中编译运行 Java”,本质是用它调用系统已安装的 javac 和 java 命令——前提是你的环境已配好 JDK,且 PATH 正确。
常见错误现象:Error: Unable to access jarfile、'javac' is not recognized、运行时提示 NoClassDefFoundError(但源码无错),基本都卡在这一步。
- 确认 JDK 已安装:命令行运行
javac -version和java -version必须有输出 - 检查
PATH是否包含%JAVA_HOME%\bin(Windows)或$JAVA_HOME/bin(Linux/macOS,但 Notepad++ 通常只用于 Windows) - Notepad++ 的编码必须设为
UTF-8 without BOM,否则含中文的System.out.println("你好")可能编译报错illegal character: \uFFFD
用 NppExec 插件调用 javac/java 最简流程
NppExec 是 Notepad++ 最常用、最轻量的命令执行插件,无需重启、不依赖外部 IDE。它不自动识别主类名,所以得手动写命令,也正因如此才够轻——适合单文件脚本开发。
使用场景:写一个 Hello.java,想保存后一键编译+运行,不生成多余配置文件。
立即学习“Java免费学习笔记(深入)”;
- 安装插件:菜单栏 → Plugins → Plugins Admin → 搜索 NppExec → 勾选安装
- 新建脚本:菜单栏 → Plugins → NppExec → Execute…,粘贴以下内容(注意替换
$(NAME_PART)):
cd $(CURRENT_DIRECTORY) javac -encoding UTF-8 "$(FULL_CURRENT_PATH)" java -cp "$(CURRENT_DIRECTORY)" $(NAME_PART)
- 保存为脚本名如
java_run,勾选 Save all files before execution - 绑定快捷键(可选):菜单栏 → Plugins → NppExec → Advanced Options → Add/Modify… → 把刚存的脚本拖到右栏 → 勾选 "Place on Menu bar"
为什么不用 “Compile and Run” 类似插件
有些插件(如 JN (Java Runner))封装了更多逻辑,但容易掩盖路径和类路径问题。比如它默认用 java $(NAME_PART),但如果你的 public class 名和文件名不一致,或用了 package,就会直接失败,而你根本看不到命令在哪崩的。
参数差异关键点:
-
javac -encoding UTF-8必加:Notepad++ 默认保存为 ANSI 或 UTF-8 with BOM,不指定编码会导致中文字符串编译失败 -
-cp "$(CURRENT_DIRECTORY)"必加:否则java找不到当前目录下的.class文件(JDK 9+ 默认不把当前目录加入 classpath) - 不要用
java $(FULL_CURRENT_PATH:.java=):它会把路径也拼进去,变成java C:\foo\Hello,而java只认类名,不认路径
遇到 NoClassDefFoundError 怎么快速定位
这个错不是编译失败,而是运行时找不到类定义,90% 是 classpath 或类名不匹配导致,和 Notepad++ 关系不大,但容易误以为是编辑器问题。
典型触发条件:
- 源码写了
package demo;,但没建对应子目录demo\Hello.java,仍放在根目录下编译 - 执行命令用了
java demo.Hello,但 classpath 没包含上层目录(即java -cp . demo.Hello才对) - Notepad++ 中文件名是
hello.java,但类声明是public class Hello(大小写不一致,Windows 下可能侥幸通过,但严格不符合 Java 规范)
建议每次出这个错,先在命令行手动跑一遍:javac Hello.java && java Hello,确认基础流程通了,再回 Notepad++ 对齐命令。
真正麻烦的是 package + 子目录结构 + 多文件依赖——这时候就不是 Notepad++ 能轻松搞定的了,该换 javac -d out src/*.java && java -cp out Main 或上构建工具了。










