-
package声明必须在文件最顶行，否则javac直接报错Java编译器对package的位置极其严格：它必须是源文件中第一个非注释、非空行。一旦前面有import、类定义、甚至一行带空格的注释，javac就会抛出class,interface,orenumexpected或更隐晦的packagenotfound错误。常见踩坑点：IDE自动生成的licenseheader注释没删，导致package不是首行用IDE快捷键移动类时，把packa
-
在屏幕坐标系中，gridi对应坐标(x=j,y=i)；初始化需防行列顺序颠倒、负/零尺寸异常及稀疏数据滥用密集数组。
-
UnsupportedOperationException源于不可变集合或未实现操作，如Arrays.asList后修改列表；应优先通过包装为ArrayList等可变集合预防，无法预知时用try-catch降级处理，结合API设计明确标识不支持的操作，保障程序整体可用性。
-
equalsIgnoreCase更安全，因它基于Unicode标准大小写折叠、不依赖locale，避免非ASCII字符（如ß、İ）转换异常；仅用于用户名/邮箱等标识符，需判空且不可用于密码；应配合Unicode正规化和输入清洗。
-
关键在于按任务性质选线程池类型并精细配置：CPU密集型用固定大小+ForkJoinPool，IO混合型配动态线程+有界队列，强事务场景交由小线程池串行；拆解变量路径为Supplier并发执行；监控队列堆积、禁用阻塞调用；虚拟线程用于轻量接入，重计算仍走隔离平台线程池。
-
新建项目时选错JDK版本会导致编译失败，需正确配置JDK17/21、统一UTF-8编码、开启自动构建并手动触发编译，三者缺一不可。
-
beforeExecute是合适的注入点，因为它在任务被工作线程执行前触发，既能获取目标线程又能安全绑定TraceId；需结合任务封装或InheritableThreadLocal传递上下文，并在afterExecute中清理MDC。
-
Java11+HttpClient默认尝试协商HTTP/2，但仅当满足三条件时才真正启用：服务端支持ALPN（h2）、客户端运行Java11+（推荐17+/21）、请求使用https://；否则自动降级至HTTP/1.1。
-
调试时发现方法返回正确值，但接收变量仍为初始值（如空字符串），根本原因常是调试器在多线程切换中丢失执行上下文——变量确已赋值，但后续异步线程读取的是旧快照或未同步的副本。
-
VarHandle在内存访问层面比AtomicFieldUpdater更高效，因其绕开反射、精准生成内存屏障、避免运行时校验、直接映射硬件指令且缓存行友好性更高。
-
MirroredTypeException是注解处理器因引用类未加载或不可见而抛出的编译期异常；需通过TypeMirror和Types/Elements工具安全操作类型，避免强转Class，并容错处理不可见类型。
-
javac是Java唯一官方命令行编译器，IDEA和构建工具默认调用它，Eclipse使用自研ECJ；新手推荐IDEA社区版，Eclipse适合教学与老项目，VSCode需配合Maven/Gradle；javac命令仅在查细节、控字节码兼容、CI调试时必要。
-
泛型擦除无法恢复，关键是在字段/方法等能保留签名的位置用反射或TypeLiteral主动捕获；嵌套泛型需逐层解析ParameterizedType，TypeLiteral通过匿名子类固化签名用于反序列化和依赖注入。
-
Phaser不适用于HTML安全审计，它专为2D游戏开发设计，不具备HTML解析、XSS检测、DOM净化或语义分析能力，无法替代DOMPurify等专业安全库。
-
手动定义serialVersionUID可确保序列化兼容性，避免因类结构变化导致反序列化失败。Java默认生成的ID依赖类名、字段等信息，编译环境或代码微小改动均使其改变，易引发InvalidClassException。显式声明后，可在兼容性变更时主动控制ID更新，保留原ID则允许旧版本读取新对象，提升系统稳定性。同时减少运行时反射计算开销，增强代码可读性与维护性。IDE通常提示添加，建议所有可序列化类均显式定义该字段，成本低且能有效防止分布式或持久化场景下的数据兼容问题。
