本文详解如何修复因泛型类型参数误命名为`string`而遮蔽`java.lang.string`，进而导致`tostring()`方法无法正确重写的编译错误。核心在于避免类型参数与标准类名冲突，并修正链表遍历逻辑。
在Java中，为泛型类声明类型参数时，若将其命名为 String（如 class List
- toString() 重写失败：Object.toString() 返回 java.lang.String，但你的 public String toString() 实际返回的是泛型 String 类型（与 java.lang.String 不兼容），编译器报错 return type String is not compatible with java.lang.String；
- 局部变量类型歧义：如 String string = ""; 中的 String 被解析为泛型参数，无法赋值字面量 ""（它是 java.lang.String），引发 incompatible types 错误。
✅ 正确做法：使用语义清晰的泛型参数名
将 class List
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
public class List<T> { // ✅ 使用 T 代替 String
private class Node {
private T element; // ✅ 类型变为 T
private Node next;
private Node(T element, Node next) {
this.element = element;
this.next = next;
}
private Node(T element) {
this.element = element;
}
}
private Node head = null;
// 注意：此处的 current 是实例字段，但 toString 中不应修改它（见下文说明）
private Node current = head;
// ... prepend(), append(), get(), size() 方法保持逻辑，仅将参数/返回值类型 String → T
public T first() {
return get(0); // ✅ 修复原代码缺失 return
}
public T get(int index) {
Node current = head;
for (int i = 0; i < index && current != null; i++) {
current = current.next;
}
if (current == null) throw new IndexOutOfBoundsException();
return current.element;
}
// ✅ 修复 toString：避免修改实例状态，且正确遍历链表
@Override
public String toString() {
if (head == null) return "[]";
StringBuilder sb = new StringBuilder("[");
Node current = head;
while (current != null) {
sb.append(current.element);
if (current.next != null) {
sb.append(" -> ");
}
current = current.next;
}
sb.append("]");
return sb.toString();
}
}⚠️ 关键注意事项
- 不要使用 String 作为泛型参数名：这是严重的设计反模式。JDK规范及所有主流教程均使用 T（Type）、E（Element）、K/V（Key/Value）等无歧义标识符。
- toString() 中勿修改 this.current：原代码 while(current != null) { ... current = head.next; } 不仅逻辑错误（始终指向 head.next，陷入死循环或空指针），还意外改变了对象的 current 字段状态。应使用局部变量遍历。
- 优先使用 StringBuilder：字符串拼接避免 +=（尤其在循环中），提升性能与可读性。
- 添加空值/边界检查：如 get() 中校验索引，toString() 处理空链表，增强健壮性。
- 显式添加 @Override 注解：明确表达重写意图，让编译器校验签名合法性。
? 验证效果（ListPlayground）
public class ListPlayground {
public static void main(String[] args) {
List<String> list = new List<>(); // ✅ 此处的 String 是 java.lang.String
list.append("World");
list.append("!");
list.prepend("Hello");
System.out.println("The whole List is: " + list);
// 输出：The whole List is: [Hello -> World -> !]
}
}通过以上重构，不仅彻底解决编译错误，更使代码符合泛型最佳实践：类型安全、语义清晰、行为可靠。记住——泛型参数名是契约，不是占位符；选对名字，就避开了90%的类型混淆陷阱。
