中国式的极限编程

测试固然可以用来反映契约，但是不够直观。所以还是需要API参考文档，供快速查阅。用JavaDoc一类的工具自动产生的API文档是最好的选择。这时就需要注释（当然是根据一定的格式）说明代码不能直观说明的东西。特别是对于类库，框架一类。

：代码不能直观说明的东西。特别是对于类库，框架一类。

：这是因为没有使用中文，并且大多数中国程序员不能很好的理解英文写的代码

代码和注释两者的结合更好让人易懂.
注释能让人一下就能明白整个的意思,代码是最终机器执行的东东,那么结合注释更能体现出代码的实际所说明的(动作)事.

用中文写JAVA
[code:1]
public class 采购订单 {
private String 订单号;

public String get订单号() {
return 订单号;
}

public void set订单号(String 订单号) {
this.订单号 = 订单号;
}

public 采购订单() {
super();
// TODO 自动生成构造函数存根
}

/**
* @param args
*/
public static void main(String[] args) {
// TODO 自动生成方法存根
采购订单 采购订单实例=new 采购订单();
采购订单实例.set订单号("111");
System.out.println(采购订单实例.get订单号());
}
}
[/code:1]
写完了自己看着都晕，呵呵

这个应该不晕了吧：

[code:1]
等值命题( "\u7684", "的" );

字符串包装 的 = new 字符串包装("的");

byte[] B5_C4 = new byte[]{(byte)0xB5, (byte)0xC4};
byte[] AA_BA = new byte[]{(byte)0xAA, (byte)0xBA};
byte[] E7_9A_84 = new byte[]{(byte)0xE7, (byte)0x9A, (byte)0x84};

等值命题( new byte[]{'?'}, 的.取字节("ISO-8859-1") );
等值命题( new byte[]{'?'}, 的.取字节("US-ASCII") );
等值命题( B5_C4, 的.取字节("GB2312") );
等值命题( AA_BA, 的.取字节("BIG5") );
等值命题( E7_9A_84, 的.取字节("UTF-8") );
等值命题( new byte[]{-1, -2, (byte)0x84, 0x76}, 的.取字节("UNICODE") ); // 这个不一定对

[/code:1]

更多

[code:1]
类 对象类 = 类.取类(Object.class);
类 类的类 = 类.取类(类.class);
真命题( 对象类 == 类的类.父类() );
真命题( 类的类.有实例(对象类) );
真命题( 对象类.有实例(类的类) );
真命题( 对象类.可来自(类的类) );
假命题( 类的类.可来自(对象类) );

类 字符串类 = 类.取类(String.class);
真命题( 字符串类.是一种(对象类) );
真命题( 对象类.可来自(字符串类) );
真命题( 字符串类.有实例("") );
假命题( 字符串类.有实例(null) );
真命题( 对象类 == 字符串类.父类() );
[/code:1]

推荐使用EBWIN 加 汉英字典，就不用发愁变量命名了

加强阅读代码的能力，大量阅读开源项目的源代码，熟悉命名方式，是克服英文水平差的一条捷径。