根本原因是未正确配置java.home路径、Main类命名不规范或VS Code误判项目类型；需确保JDK路径正确、public类名与文件名严格一致、删除module-info.java、避免嵌套在构建工具项目中，并通过输出面板排查日志。
Java程序在VS Code里不报错但运行没输出
根本原因通常是没正确配置 java.home 或没识别到 Main 类入口。VS Code 的 Java 扩展（如 Extension Pack for Java）依赖 JDK 路径和类名约定，不是写了 System.out.println("Hello World"); 就能自动跑起来。
- 确认终端里执行
java -version和javac -version都有响应，且版本一致（建议 JDK 17+） - 在 VS Code 设置中搜
java.home，设为 JDK 安装根目录（例如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home或C:\Program Files\Java\jdk-17.0.1），不是 JRE 路径 -
public class名必须和文件名完全一致（包括大小写），且该类里必须有public static void main(String[] args)方法 - 别用右键“Run Code”插件（Code Runner）直接跑
.java文件——它默认调用java命令而非javac + java，会因未编译而静默失败
点击“运行”按钮后提示“Cannot resolve the module”的错误
这是 VS Code 把项目当成了模块化（Java 9+ module-path）工程，但没找到 module-info.java 或配置冲突。新手写单文件 HelloWorld.java 根本不需要模块系统，强行启用反而卡住。
- 删掉项目根目录下可能自动生成的
module-info.java文件 - 检查工作区设置（
.vscode/settings.json），移除或注释掉类似"java.configuration.updateBuildConfiguration": "interactive"这类触发自动模块探测的配置 - 确保文件保存在纯空文件夹里，不要放在 Maven/Gradle 项目结构中（比如别有
pom.xml或build.gradle） - 重启 VS Code 窗口（不是重载窗口），让 Java 扩展重新扫描项目类型
用 Terminal 手动编译却提示“error: class HelloWorld is public, should be declared in a file named HelloWorld.java”
这个错误不是环境问题，是命名硬规则：只要用了 public 修饰类，文件名就必须一字不差匹配类名 + .java 后缀。大小写敏感，多一个空格都不行。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 检查当前目录下文件名是否真的是
HelloWorld.java（不是helloworld.java、HelloWorld.TXT或带隐藏字符） - 在终端用
ls -la（macOS/Linux）或dir（Windows）确认真实文件名，别只信编辑器标签页显示 - 如果类没加
public，那文件名可以任意，但此时不能被java命令直接执行（会报Failed to load Main-Class manifest attribute）——所以新手务必加public并严格匹配文件名
Ctrl+F5 运行后终端一闪而过，看不到输出
VS Code 默认用非交互式终端启动 Java 程序，进程结束就关闭面板。尤其 Windows 用户容易以为“没运行”，其实是跑完了立刻退出。
立即学习“Java免费学习笔记（深入）”；
- 改用集成终端手动执行：
javac HelloWorld.java→java HelloWorld，这样输出会留在终端里 - 或者在代码末尾加一行
System.in.read();（需处理IOException），让程序等你按回车再退出 - 更稳妥的做法：打开 VS Code 的“输出”面板（
Ctrl+Shift+U），选择“Java”频道，能看到编译和启动的真实日志，比看终端更可靠
真正卡住人的往往不是语法，而是 JDK 路径拼错、文件名大小写不一致、或 VS Code 把简单文件当复杂项目处理了。这些点不报红也不报错，只让输出消失——盯住终端命令、文件名、java.home 这三处，比查语法快得多。
