删除你程序中的僵尸代码

删除你程序中的僵尸代码 删除你程序中的僵尸代码 随着万圣节越来越流行，我们想跟大家讨论一下一个在软件开发中非常普遍的问:僵尸代码。几乎所有大家接触过的代码库里都四散着很多小段的，甚至大片大片的被注释掉的代码。这就是僵尸代码。 //目前禁用这项功能。Jimmy在写这段代码时肯定是喝醉了。 //你可能以为这里发生了恐怖的代码凶手案…不，不，我只是把它们注释掉了… 为什么称它们为僵尸代码,你知道，僵尸不并不是真的死的。就像恐怕电影里告诉我们的，尽管僵尸看起来是死人，但它们仍有能力四处出没袭击我们。相同 的道理，僵尸代码也是处于不生不死之间…它们在伺机搞砸我们的工作。注释掉的代码还活着，它们就存在我们的代码库中。程序员在维护和重构代码时会和它们遭 遇，通常是滚动屏幕时和它们擦肩而过，或是在进行关键词搜索时和它们撞个满怀。但这些代码也确实是死的，因为它们在软件产品中并不执行。因此，这些僵尸就 应该被烧掉，立刻。 僵尸代码不死之躯 我认为，有两个原因导致了僵尸代码的肆虐:懒和害怕风险。懒程序员对代码有收藏癖。他们缺乏确信的勇气和清楚的认识去删除无用的代码，于是他们就把 它们隐藏在注释里，期望有朝一日它们能复活来再次祸害人。代码需要经常的、有计划的删除，因为优秀的程序员都知道:代码就是债务。越少越好。当然，被注释掉的代码仍然是代码。 烂程序员也许会争辩说，他们注释掉这些代码是为了“万一”以后有人会需要它们。事实上，这好心反而是害了大家。这实际上说的是害怕风险，缺乏对版本 控制系统作用的信任。有版本控制系统在，删除的代码永远不会真正的死掉。它们被埋到棺材里但却活着。所以，注释代码的方法没有多大实际效用。 对于程序来说，注释掉的代码跟删掉的代码一样，不起任何作用。让代码半死不活，以僵尸的形态存在，造成技术债务，最终会让你的团队受害。要果断，删掉它们。 僵尸代码降低信噪比 当写程序时，我们一定要努力使代码里有效信息的比率越高越好。这有助于人们理解程序，更快的阅读代码，防止我们因为误解而写出有问题的代码。僵尸代 码直接的对抗代码的可理解性。它拖延我们阅读和维护代码的速度，因为它使我们在屏幕上看到更少的有效代码。它们就是视觉噪音，干扰人们的正常阅读。处于某 些原因，有些程序员会接受这种妥协的 做法，可是在现实中，谁会接受这种乱糟糟的画面。想象一下，如果纽约时报看起来像这个样子: 如何阅读这断断续续的文字,噪音的增加就是对可理解性的损害。对这些被注释掉的部分，尽管它们毫不相干，甚至会误导，但你却无法对它们视而不见。有 人会说，这不是最终发布的产品，这些代码存在于开发过程中，拿它们跟发布的产品做对比，这就像拿苹果比桔子。但是请记住，被写出的每行代码平均都要被阅读10次。没错，你的代码的阅读人数没有纽约时报多，但是，你拥有的是一个最重要的忠实的阅读群体。就是我们。 Knuth对此关切进行了精辟的总结: “编程是一种一个人告诉另一个人他想让计算机做什么的艺术。” Donald Knuth 而僵尸代码让你讲话讲不清楚。一个程序员需要去阅读被注释掉的代码吗, 僵尸代码造成歧义妨碍调试 注释掉的代码会带来歧义，人们会怀疑这些代码是否该注释掉。试想一下，你是一个来维护程序的程序员，突然看到了一片注释掉的代码，而程序就在这附近 出了问题。这个程序员的任务会变得更棘手。他需要阅读和理解这些注释掉的代码，了解注释它们带来的影响。是因为测试而注释这些代码但忘了恢复吗,也许注释 这些代码的人可以提供帮助，但他是谁,调查行动开始。多余的歧义会消耗你的时间，增加你的思考负担——本来可以是一次轻松的调试过程。 僵尸代码影响关键词搜索 在大型程序库中，grep/find命令将会是你锁定某些特定的代码片段的雷达。然而，如果程序库里到处散布着僵尸代码，很有可能你捕捉到的目标都是被注释掉的。这是干扰。浪费时间。 僵尸代码影响代码重构 反省(重构)能修复我们的灵魂。我们应该以小孩scout的做事原则为荣，永远把代码收拾得比你想象的要整洁。然而，当一个类或方法包含有大量的僵尸代码时，事情就不好处理了。如果重构这段程序，我是否还要参考注释掉的代码,它们近期将会被重新使用吗,它会影响我的新版的实现吗,这些问题对于维护的程序员来说本该不需要回答的。 此外，集成重构工具根本不会考虑这些注释掉的代码。因此，当方法，变量，类被重命名或修饰符改变时，这些注释掉的代码就不会同步做修改。当你再想把注释掉的代码复活时，它们很可能根本不能编译。 有例外吗, 没有。很明确。有人会说“我现在注释它们是因为我过会儿就要恢复它们。”OK，假设你是个家庭妇男，你走到起居室，看到: 想想你内心的对话。这是个漂亮的房子，但这个东西又丑且怪异。我想开灯，但怎么会有胶带,如果我撕掉胶带去开灯，会发生什么事情,你很可能最终决定 找贴胶带的人。“哦，我想打开吊扇，但它启动时来回摇摆，掉了下来，我想修理它….”当然，这是应该的。而在你没修好它之前，胶带一直贴在开关上。我们当 然不该让这些只修了一半的东西存在屋内。同样，我们也不接受这样的代码。 说的更明白些，任何被注释掉的代码都是僵尸代码，都应该被删掉。不管有多少。不管是在发布的产品中还是在开发环境中。僵尸代码有时会在生死之间摇 摆。如果代码被注释掉，这很有可能有东西没有完成。经常是配置需要来回切换或逻辑分支左右摇摆。注释代码可能会做实验性的来回切换，删除这些代码，建一个 记事贴，记录下需要做的事情。在记事贴中记下哪次提交版本时删除了这些代码。或者，新建一个版本分支专门做这事，合并时删除它们。这样，维护工作就不会受 到干扰。 心里的核对表 如果你打算要注释一段代码，请先问问自己: 如果有可能的话，什么时候会取消注释, 是否能删掉它，如果日后有需要，从版本控制系统里找回, 对这些未完成的、有可能会回滚的代码，能否用版本分支来处理, 这种需要来回切换注释的功能可否通过配置实现, 重构时也需要重构这些注释掉的代码吗, 本文由:根管治疗 文案 编辑词条 B 添加义项 ? 文案，原指放书的桌子，后来指在桌子上写字的人。现在指的是公司或企业中从事文字工作的职位，就是以文字来表现已经制定的创意策略。文案它不同于设计师用画面或其他手段的表现手法，它是一个与广告创意先后相继的表现的过程、发展的过程、深化的过程， 多存在于广告公司，企业宣传，新闻策划等。 基本信息 中文名称 文案 外文名称 Copy 目录 1发展历程 2主要工作 3分类构成 4基本要求 5工作范围 6文案写法 7实际应用 折叠编辑本段发展历程 汉字"文案"(wén àn)是指古代官衙中掌管档案、负责起草文书的幕友,亦指官署中的公文、书信等;在现代，文案的称呼主要用在商业领域，其意义与中国古代所说的文案是有区别的。 在中国古代，文案亦作" 文按 "。公文案卷。《北堂书钞》卷六八引《汉杂事》:"先是公府掾多不视事，但以文案为务。"《晋书?桓温传》:"机务不可停废，常行文按宜为限日。" 唐戴叔伦《答崔载华》诗:"文案日成堆，愁眉拽不开。"《资治通鉴?晋孝武帝太元十四年》:"诸曹皆得良吏以掌文按。"《花月痕》第五一回:" 荷生 觉得自己是替他掌文案。" 旧时衙门里草拟文牍、掌管档案的幕僚，其地位比一般属吏高。《老残游记》第四回:"像你老这样抚台央出文案老爷来请进去谈谈，这面子有多大!"夏衍《秋瑾传》序幕:"将这 阮财富 带回衙门去，要文案给他补一份状子。" 文案音译 文案英文:copywriter、copy、copywriting 文案拼音:wén àn 现代文案的概念: 文案来源于广告行业，是"广告文案"的简称，由copy writer翻译而来。多指以语辞进行广告信息内容表现的形式，有广义和狭义之分，广义的广告文案包括标题、正文、口号的撰写和对广告形象的选择搭配;狭义的广告文案包括标题、正文、口号的撰写。 在中国，由于各个行业发展都相对不够成熟，人员素质也参差不齐，这使得"文案"的概念常常被错误引用和理解。最典型的就是把文案等同于"策划"，其实这是两种差别很大，有着本质区别的工作。只是由于文案人员常常需要和策划人员、设计人员配合工作，且策划人员也需要撰写一些方案，这使得很多人误认为文案和策划就是一回事，甚至常常把策划与文案的工作会混淆在一起(这也和发源于中国的"策划学"发展不够成熟有关)。 广告文案 广告文案 很多企业中，都有了的专职的文案人员，只有当需要搞一些大型推广活动、做商业策划案、写可行性等需求量大的项目时，才需要对外寻求合作。以往一般企业都会找广告、文化传媒等公司合作。这些公司一般都有专业的文案、设计团队，经验也相对丰富，但因为业务量大，范围广泛，在针对性方面会较为薄 弱。随着社会经济不断发展，对专业文案的要求更加严格，逐渐衍生了一些专注于文字服务的文案策划公司。这类企业发展速度很快，大多数都是从工作室形式转型而来，也有从文化传播机构独立出来的。 随着中国广告业二十余年的迅猛发展，广告公司的经营范围，操作流程，工作方式都在变化，文案的角色由无闻转为配角，现正昂首阔步走向台面，成为主角，从前一则广告多是由设计出计划，再配图之后，文案轮为完稿，一则广告的计划多是由文案与美工共同完成，然后各自分工。说起文案的地位，日本是从1992年意识到文案的重要性，台湾是1998年。2002年，大陆的一些中大型广告公司的老总几乎都在垂叹，好的文案太少了。好的文案往往愿意扎堆，从全国形式来看，这股潜规则正逐渐由华南广告重镇广州向华东中心上海转移。 折叠编辑本段主要工作 撰写报纸广告、杂志广告、海报; 撰写企业样本、品牌样本、产品目录; 撰写日常宣传文案白领一族 文案白领一族 单页、各类宣传小册子; 撰写DM直邮广告，包括信封、邮件正文; 撰写电视广告脚本，包括分镜头、旁白、字幕; 撰写电视专题片脚本; 撰写电视广告的拍摄清单; 撰写广播广告; 将海外版广告文案作 汉化(翻译); 撰写广告歌词，或汉化(翻译)外文歌词; 撰写各种形式的网络广告; 为网站栏目命名; 撰写网站内部文案; 撰写手机短信广告; 撰写各类广告作品的创意阐述; 撰写广告口号; 撰写产品包装文案，包括:品牌名、使用说明、产品成分等; 为产品或品牌命名，并作创意阐述; 为路演或活动命名，并作创意阐述; 撰写活动请柬及活动现场宣传品上的文字; 为各种礼品命名，并作创意阐述; 为专卖店命名，并作创意阐述; 撰写商店的橱窗或店内POP物料文案; 撰写软文、新闻式、故事式、评论式; 撰写，或协助策划人员优化、润色方案文字; 协助客户企业内刊的编辑，提供主题方向，审核文字。 不同的环境对文案撰稿人有着不同的锤炼和要求。 折叠编辑本段分类构成 从现有的文案分类有很多种，按照4A，一般有四类:助理文案(ACW)， 文案(CW策划文案 策划文案 )，高级文案(ACW)，资深文案(SCW)，其中稍微要区别的是高级文案与资深文案，前者要求的是文案的撰写能力，而后者不仅仅是文案的撰写能力还包括做文案的年资。有些4A公司设有文案主任(CE)一职，大体上与文案职责类似，有时候负责专项。另外有些个别公司还配有首席文案的职位(CCW)，文案功力凤毛麟角，虽不具领导才能，但有的首席文案拿的工资却比创意总监还要高。大部分国内广告公司文案的种类繁杂，有房地产文案、创意文案、企划文案、品牌文案等。 文案是由标题、副标题、广告正文、广告口号组成的。它是广告内容的文字化表现。在广告设计中，文案与图案图形同等重要，图形具有前期的冲击力，广告文案具有较深的影响力。 广告标题:它是广告文案的主题，往往也是广告内容的诉求重点。它的作用在于吸引人们对广告的注目，留下印象，引起人们对广告的兴趣。只有当受众对标语产生兴趣时， 才会阅读正文。广告标语的设计形式有:情报式，问答式、祈使式、新闻式、口号式、暗示式、提醒式等。广告标语撰写时要语言简明扼要，易懂易记，传递清楚，新颖个性，句 子中的文字数量一般掌握在12个字以内为宜。 广告副标题:它是广告方案的补充部分，有一个点睛的作用。主要表现在对标题的补充及让人感觉，前面的不懂，在这里全部让人了解。 广告正文:广告正文是对产品及服务，以客观的事实、具体的说明，来增加消费者的了解与认识，以理服人。广告正文撰写使内容要实事求是，通俗易懂。不论采用何种 题材式样，都要抓住主要的信息来叙述，言简易明。 广告口号:口号是战略性的语言，目的是经过反复和相同的表现，以便名域其他企业精神的不同，使消费者掌握商品或服务的个性。这以成为推广商品不可或缺的要素。广告 口号常有的形式:联想式、比喻式、许诺式、推理式、赞扬式、命令式。广告口号的撰写要注意简洁明了、语言明确、独创有趣、便于记忆、易读上口。 所谓广告文案是以语辞进行广告信息内容表现的形式。广告文案有广义和狭义之分，广义的广告文案就是指通过广告语言、形象和其他因素，对既定的广告主题、广告创意所 进行的具体表现。狭义的广告文案则指表现广告信息的言语与文字构成。广义的广告文案包括标题、正文、口号的撰写和对广告形象的选择搭配;狭义的广告文案包括标题、正文 、口号的撰写。 折叠编辑本段基本要求 1)准确规范、点明主题 准确规范是文案中最基本的要求。要实现对广告主题和广告创意的有效表现和对广告信息的广告文案 广告文案 有效传播，首先要求广告文案中语言表达规范完整，避免语法错误或表达残缺。其次，广告文案中所使用的语言要准确无误，避免产生歧义或误解。第三，广告文案中的语言要符合语 言表达习惯，不可生搬硬套，自己创造众所不知的词汇。第四，广告文案中的语言要尽量通俗化、大众化，避免使用冷僻以及过于专业化的词语。 2)简明精炼、言简意赅 文案在文字语言的使用上，要简明扼要、精练概括。首先，要以尽可能少的语言和文字表达出广告产品的精髓，实现有效的广告信息传播。其次，简明精练的广告文案有助于吸引广告受众的注意力和迅速记忆下广告内容。第三， 要尽量使用简短的句子，以防止受众因繁长语句所带来的反感。 3)生动形象、表明创意 文案中的生动形象能够吸引受众的注意，激发他们的兴趣。国外研究资料表明:文字、图像能引起人们注意的百分比分别文字是35%, 图像是65%，文案创作时采用生动活泼、新颖独特的语言的同时，附助以一定的图像来配合。 4)优美流畅、上口易记 文案是广告的整体构思，对于由其中诉之于听觉的广告语言，要注意优美、流畅和动听，使其易识别、易记忆和易传播，从而突出广告定位，很好地表现广告主题和广告创意，产生良好的广告效果。同时，也要避免过分追求语言和音韵美，而忽视广告主题，生搬硬套，牵强附会，因文害意。 折叠编辑本段工作范围 策划文案和创意文案 一)策划文案:工作主要是将策划工作人员的策划思路形成文字。毋庸置疑，公司很多策划人员均有很强的策划水平和丰富的策划经验，但有时候手上同时进行几个案子，同时时间又比较紧的情况下，文案可以在充分理解策划意图的情况下帮助策划人员完成策划方案的写作。这其中有几个内容: 1.必须充分了解本案的运作背景，包括宏观市场信息和微观市场动态。 2.掌握整个策划的战略指导思想。 3.以通俗易懂、言简意赅的论述方式将策划思想反映在字里行间。 4.到比较专业的问题或障碍的时候，应及时与策划人员沟通，保证策划方向的一致性。 5.贯彻战略方针的同时，也可就战略思想的表达方式和文字提述上提出一些合理化建议，从而更好地展现策划的战略核心点。 二)创意文案:主要是将广告作品的表现及形式用完整的文字表达出来，其中，除了产生画面的构想之外，还包括广告语言的表现内容(如平面的标题、引文、正文、随文，广告语等，影视的音效、旁白、字幕、广告语等)。其中至关重要的就是新颖的创意和传神的文字表现。 而这些智慧的闪光绝对不是拍一下脑门子就能出来的。这其中包括了以下内容: 1.通过各个层面，特别是swot方面深入理解，从而找出项目的核心优势。 2.把握目标消费群的心态。 3.掌握宏观政策及大市场对项目本身的影响。 4.场策划人员和设计人员保持密切联系，随时沟通。 5.市场上类似房产项目的文案及创意，力求全面加以突破。 6.获悉开发商对文案创作的要求，调整文字内容和形式。 折叠编辑本段文案写法 商家要吸引、留住消费者必须注重细节的提高和改善，而其中，文案就是不可忽视的一大细节。下面是一些能吸引买家的写文案方法: 折叠九宫格思考法 拿一张白纸，用笔先分割成9宫格。中间那格填上你的商品名，接下来开始在其它8格填上可以帮助此商品销售的众多可能优点。这是强迫创意产生的简单练习法，我也常用这种方式构思出企划案或演讲的结构。 折叠要点衍伸法 把该商品型录上的商品特点照抄下来，然后每个要点后面加以延伸。如果你真的很懒，照抄型录商品卖点也可，但文字会比较没有人味，说服力道会稍差。 折叠三段式写作法 这是仿新闻学中"倒三角写作法"。第一段，请精要地浓缩全文的销售话术，因为多数人都没耐心看全文。第二段，请依照型录要点衍伸法，逐一说明该商品的众多特色。到底是点列还是一段长文章较好，要看你的文字功力。文字功力欠佳就点列式写出卖点即可。最后一段是「钩子」，主要任务是要叫人【Buy Now】，所以一般是强化商品USP(Unique Selling Point，独特销售卖点)、价格优势或赠品。 折叠编辑本段实际应用 市场研究 没有正确的市场导向，任何文案或创意都是天马行空的奇思怪想。的确，再优美的文字用在不适宜的场合中都可能导致整个策划执行的失败。一篇优秀的文案，一定是在对市场有深入 的了解后方能下笔的。 例如不同地区的经济发展水平、文化构成、风土人情、产业结构比重等等皆有很大差异，同一地区不同年龄、阶层人士的世界观、思维观、道德观和价值观也参差不齐，加上特定环境、特定历史背景或政策规文赋予某些项目的特殊意义，都会对文案产生深远的影响。 所以无市场，文案便如枯井之蛙，其作品不仅缺乏远见，生命力也极为低下。 沟通与互助 在创作一幅作品时，常常发生这种情况:设计人员与文案人员一开始没有很好的沟通;结果是设计人员设计出来的作品文案看来好像是曲解了原意，而将文案配上去时候，设计人员又认为文案的风格与画面差入甚大。矛盾自然就出现了。 其实文案和设计，乃至市场、企划、媒体等各部门工作人员都应随时保持高效的沟通。通篇来看，文案的工作是将市场的调查分析结果作为其创作的翔实论据、企划的核心思想作为其创作的指引方向，媒体投放的渠道作为其创作的特定模式，设计排版作为其创作的具体表现。因此，每一个环节都是动态维系着的。在做一个文稿之前，与各个部门广泛沟通，并做到互爱互助，才能在一个凝聚力超强的团队中展现出自己独特的个性和才华