昨晚一位技术很厉害的网友和我聊天，说我博客上的文章，有的写要重视技术、重视编码细节，而有的却说编码不是很重要，写文档做设计才重要。这样不是互相矛盾吗？到底哪个重要？
其实都重要，不同时期不同阶段，侧重点不同。而我写文章发表观点，也有个侧重点，有个上下文情境。比如我在写对公司代码评审的系列文章里，主要是分析代码质量，所以关注点就多放在编码方面。而我在《程序员，35岁以后你怎么办？ 》里，就有“语言语法就那么一点，代码写去写来也就那么个样，有什么好写的”，这时我强调设计的重要性，而且我文章有个前提，就是针对35岁以上的老技术人员来说的，几乎连续编码了15年的人；这样的开发人员代码写的够长了，如果他还有点可造之才，早在编码方面成为高手了，所以没必要一门心思放到编码方面。
而看我文章的可能大多是有学习欲望的大学生和工作经验不丰富的开发人员，你们当然和35岁以上的老开发人员情况不同。你们在编码经验上还不是很丰富，不可能放下编码而一门心思去做规划和做设计。在工作早期，开发人员主要精力应该放到具体技术的学习上，首先让自己在一个技术方向上成为编码熟手，比如在c/c++,或者java,或者.net，在一个方面做精，让这个方面成为自己吃饭的家伙；随着开发时间增加，在主攻方向技术精了，在某个或某几个业务领域里也熟悉了，这个时候你就可以在技术上走“广”的方向，多接触多学习一些其它技术，技术上达到精而博，那么这个时候你的技术视野就开阔起来，做技术选型就比较得心应手。
这里专门讲讲写文档，做设计必定要写一些文档出来。很多开发人员一听说要他写文档，就有抵触情绪，要么以开发时间紧为由推脱，要么搬出“原代码就是设计”的敏捷开发观点来。常常以为编码就是唯一大事，自己能写出代码就万事大吉了。我们开发一个项目，先和客户谈需求，就要写一个系统需求分析文档吧，然后和客户确认；需求确定了，接着召集技术人员，就需求文档来做技术评估、做总体设计，总要一个简略的系统总体设计文档吧；总体设计确定了，那时间紧或项目小或公司人手少，不写详细设计了，直接编码吧；写代码完毕，进行单元测试，功能测试，集成测试；写或不写测试文档，把系统交给客户运行吧，若操作不是很简单，总要写份操作手册吧。在这样一个小项目开发过程，编码不过是其中一个重要环节，而在整个过程中至少需要写几份文档程出来。
可能还有人说，我不写系统需求分析怎么了？万事不能说死，可能你碰到过客户不需要确认，那只能说你好运气。我近3周一直跟一个政府的项目，这个项目以前人半年也没搞下来，原因很简单，客户要个像样的需求分析文档看和业务流程文档看，以前的人弄去弄来就是做不出，客户很火，就是不签协议。我接手之后，首先内部自己开会总结以往需求，然后用word做一份详细的系统需求文档，在目录、标题、字体等等细节都作好，当然主要是需求详细列出来，言之有物。其次，用UML工具认真画了业务流程图出来，什么状态图、时序图等，怎么方便怎么做。最后打印简单装订，送到客户领导手里叫他们确认，客户领导马上就态度由阴转晴，对我们有了信心，愿意交给我们开发了。你一去就告诉客户，你自己编码水平如何如何厉害，能开发客户想要的所有功能，你当客户白痴阿，客户凭什么相信你啊，就跟你签合同。
有人说需求分析文档和操作说明手册是客户需要的，那我们没办法不得不给，总体设计文档就省了吧。从新项目开发人员角度来说没什么，反正都是自己亲自开发的，每一个子系统、每一个模块、甚至每一行代码，自己都是十分熟悉，以后维护起来自己也眼睛闭着都能找到想要修改的地方。但你永远不离开公司？不可能。你一离开，下一个接手的人就麻烦了，面对一堆代码，如果你的编码水平还很臭，那他就更头大了。他根本就无法有个全局的把握，找个修改的地方，需要去你那垃圾堆里刨好久，还不一定刨到呢。谁愿意通读别人的代码来了解系统总体啊，没这个闲心和精力。如果有总体设计文档就不一样了，至少先一细看分析，就知道你这个系统总体是怎么架构的，分那些大功能模块等等，能提纲挈领的把握一个系统，那以后分析某块代码就容易多了。
写总体设计文档需要占很长时间吗？现实中很多情况表明，一个开发人员花一个月做出一个模块，而这个模块的总体设计可能3天足够搞定，他说没有时间，3天占一个月时间很多么？！一个是懒，另一个重要的原因就是从来不写，对word软件不熟悉，对uml或viso等作图工具更不熟悉，要他做一个像样的文档等于杀了他。会设计会写文档的人，除开对业务领域熟悉和技术熟悉外，难道就天生会写文档么，天生熟练使用UML工具画出漂亮准确的流程图架构图么，没有天生，引用<<买油翁>>里：“无它，惟手熟尔”。
总之，我个人感觉，一个开发人员在不同时期不同阶段，学习工作应该有侧重点，不要在所有阶段都守着编码，而不愿意涉及其它领域。当然，如果你真要一辈子编码到退休，只要有公司要你，而你也接受公司的待遇，那别人还有什么话可说；不过，当你35岁后还让一个二十六七岁的人指挥去指挥来时，你那时郁闷了，没有人同情你，可能是不解和鄙视的眼光也说不定。