本文详解为何在泛型类中将类型参数命名为 `string` 会导致 `tostring()` 方法重写失败，并提供两种修复方案，重点推荐使用语义清晰的类型参数（如 `t`）来消除命名遮蔽问题。
问题根源在于：你在泛型类声明中使用了 public class List<String> —— 这里的 <String> 并非引用 java.lang.String，而是一个被声明的类型变量（type parameter），它恰好与内置类同名，从而“遮蔽”（shadowing）了 java.lang.String。编译器此时会将所有未限定的 String 解析为该泛型参数，而非 java.lang.String。因此：
- public String toString() 实际被解析为 public <String extends Object> String toString()，返回类型变成泛型类型变量，与 Object.toString() 的固定返回类型 java.lang.String 不兼容；
- 同样，String string = ""; 中的 String 也被当作类型变量，导致 ""（java.lang.String）无法赋值给它。
✅ 正确解决方案：使用无歧义的类型参数名
将泛型参数从 String 改为通用占位符（如 T、E 或 Item），这是 Java 社区约定俗成的最佳实践：
public class List<T> { // ✅ 使用 T 替代 String
private class Node {
private T element; // 类型安全，支持任意元素类型
private Node next;
Node(T element, Node next) {
this.element = element;
this.next = next;
}
Node(T element) {
this(element, null);
}
}
private Node head = null;
// 注意：移除冗余的 private Node current = head; —— 它不是实例状态，不应作为字段！
public void prepend(T element) {
head = new Node(element, head);
}
public void append(T element) {
if (head == null) {
head = new Node(element);
return;
}
Node current = head;
while (current.next != null) {
current = current.next;
}
current.next = new Node(element);
}
public T first() {
return get(0); // 修复原代码中缺少 return 的问题
}
public T get(int index) {
if (head == null || index < 0) throw new IndexOutOfBoundsException();
Node current = head;
for (int i = 0; i < index && current != null; i++) {
current = current.next;
}
if (current == null) throw new IndexOutOfBoundsException();
return current.element;
}
public int size() {
int size = 0;
Node current = head;
while (current != null) {
size++;
current = current.next;
}
return size;
}
@Override
public String toString() { // ✅ 明确重写，返回 java.lang.String
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();
}
}? 关键修正说明：@Override 注解显式声明重写，增强可读性与编译期校验；使用 StringBuilder 替代字符串拼接，避免 += 在循环中产生大量临时对象；修复 first() 方法缺失 return、get() 缺少边界检查等逻辑缺陷；移除无意义的 current 字段（原代码中 private Node current = head; 初始化即为 null，且未更新，纯属干扰项）。
⚠️ 备选方案（不推荐）
理论上可通过完全限定名绕过遮蔽，例如：
public java.lang.String toString() {
java.lang.String result = "";
Node current = head; // 注意：必须重新声明局部变量！原字段 current 是 null
while (current != null) {
result += current.element + " -> ";
current = current.next;
}
return result;
}但此方式治标不治本：类型参数 String 仍存在，继续污染整个类的作用域（如 Node.element 类型仍是泛型 String，非 java.lang.String），极易引发后续维护陷阱。强烈建议始终避免用标准类名（如 String, Integer, List）作为泛型参数名。
立即学习“Java免费学习笔记（深入）”；
✅ 最终验证（ListPlayground.java）
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("Length: " + list.size()); // Length: 3
System.out.println("First: " + list.first()); // First: Hello
System.out.println("Index 2: " + list.get(2)); // Index 2: !
System.out.println("Last: " + list.get(list.size() - 1)); // Last: !
System.out.println("List: " + list.toString()); // List: [Hello -> World -> !]
}
}✅ 编译通过，运行输出符合预期。
总结：泛型类型参数命名应遵循 T（Type）、E（Element）、K/V（Key/Value）等通用约定，杜绝与 JDK 标准类同名。这不仅是语法要求，更是保障代码可读性、可维护性与类型安全的基石。
