eclipse中创建java项目应选“java project”模板，确保生成src文件夹、启用java支持并配置正确jre；避免误选maven或general项目，禁用中文路径与空格，配置后执行project→clean生效。
在 Eclipse 中创建 Java 项目本身没有技术门槛，但新手常卡在「新建项目后没生成 src 文件夹」「运行时报错 Class not found」「项目图标不显示 Java 小图标」——这些问题几乎都源于项目类型选错或配置未触发 Java 支持。
选对项目模板：不是所有“Java”字样的模板都可用
Eclipse 的新建向导里有多个带 Java 名称的选项，但只有 Java Project 是标准、轻量、可直接编译运行的起点。其他如 Java Working Set、Dynamic Web Project 或 Maven Project 都自带额外约束（比如要求 Web 容器、pom.xml 结构），不适合练手或快速验证代码逻辑。
-
Java Project：默认使用 JRE、自动生成src源码文件夹、支持右键Run As → Java Application - 误选
Maven Project：即使只写一个Main.java，也会因缺少pom.xml或依赖配置导致构建失败，且项目结构默认是src/main/java，和初学者预期不符 - 误选
General Project：纯空壳，无 Java 构建路径、无编译器绑定，必须手动配置才能识别.java文件
检查项目是否真正启用 Java 支持
即使选了 Java Project，Eclipse 也可能因工作区元数据损坏或 JRE 未正确关联而降级为普通文件夹——最直接判断方式是看项目根目录下是否有 .project 文件，且其中包含 org.eclipse.jdt.core.javabuilder 和 org.eclipse.jdt.core.javanature。
- 若项目图标是普通文件夹（无咖啡杯标识）：右键项目 →
Properties→ 左侧选Project Facets→ 勾选Java；或选Builders→ 确保Java Builder已启用 - 若报错
The project does not have a build path：右键项目 →Build Path → Configure Build Path…→ 在Libraries标签页点击Add Library… → JRE System Library → Next - 若
src文件夹未自动创建：右键项目 →New → Source Folder，输入名称src，点 Finish（不要用Folder，否则不会被识别为源路径）
避免中文路径和空格引发的编译异常
Eclipse 自身能处理中文路径，但 JDK 的 javac 在某些旧版本（尤其是 Windows 下 JDK 8u202 之前）对含空格或中文的项目路径解析不稳定，会导致 error: invalid flag: xxx.java 或 cannot find symbol 等看似无关的错误。
立即学习“Java免费学习笔记（深入）”；
- 新建项目时，
Project name可用中文，但Location（即磁盘路径）务必使用纯英文、无空格、无特殊符号（如括号、顿号）的路径，例如：D:\workspace\hello_java - 若已建在中文路径下，不要强行剪切移动整个文件夹——应先在 Eclipse 中右键项目 →
Delete（勾选Also delete contents on disk），再重新创建 - 检查当前 JRE 是否匹配项目：右键项目 →
Properties → Java Build Path → Libraries→ 展开JRE System Library，确认版本与你期望的一致（如JavaSE-17），否则可能因语法特性（如var、record）不被识别
package hello;
public class Main {
public static void main(String[] args) {
System.out.println("Hello, Eclipse Java Project!");
}
}
真正容易被忽略的是：Eclipse 不会自动刷新项目视图或重建索引，哪怕你手动改了 .project 文件。遇到配置改完仍无效，先试 Project → Clean… → Clean all projects，再确认控制台输出中是否有 Build completed 提示。
