中国式的极限编程

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

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

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

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

用中文写JAVA

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订单号(););;
	}
}

写完了自己看着都晕，呵呵

这个应该不晕了吧：

    等值命题( "\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"); );; // 这个不一定对

更多

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

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

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

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