欢迎光临缘震官方网站
案例库 | 彦蓁科技 | 新官网

网站建设|网站设计|网站制作|上海网站建设|上海网站设计|上海网站制作- 缘震网络

网站建设|网站设计|网站制作|上海网站建设|上海网站设计|上海网站制作- 缘震网络
精彩案例
精彩案例

地址: 上海市静安区共和新路4718弄10号楼2楼

热线:400-166-3538

电话:13122077371

邮箱:sales@shyuanzhen.cn

养成好习惯 关于代码注释的7个技巧

2015-11-13 00:00:00

0

 1. 对不同级别的代码进行注释

对于不同级别的代码块,要使用统一的方法来进行注释。例如:

对于每一个类,需要包含一段简明扼要的描述,作者和上一次修改的时间

对于每一个方法,需要包含这个方法的用途,功能,参数以及返回结果

当你在一个团队里面的时候,采用一套注释的标准是非常重要的。当然,使用一种大家都认可的注释约定和工具(例如C#的XML注释和Java的Javadoc)在一定程度上能推动这项任务。

2. 使用段落注释

首先把代码块分解成多个“段落”,每一个段落都执行单一的任务;然后在每一个“段落”开始之前添加注释,告诉阅读代码的人接下来的这段代码是干什么用的

 

3. 对齐注释行

对于那些在行末写有注释的代码,应该对齐注释行来使得方便阅读

有些开发人员使用tab来对齐注释,而另外一些人会用空格来对齐。由于tab在不同的编辑器和集成开发环境中会有所不同,所以最佳的方法是使用空格来对齐注释行。

 

4. 不要侮辱阅读者的智慧

要避免没用的注释,例如

 

这不单把时间浪费在写没用的注释上面,同时也在分散读者的注意力。

5. 要有礼貌

应当避免没有礼貌的注释,例如“要注意一些愚蠢的用户会输入一个负数”,或者“修正由菜鸟工程师写的愚蠢得可怜的代码而导致的副作用”。这样的注释对于代码的写注释的人来说并没有任何好处,同时你永远都不会知道将来这些注释会被谁来阅读,你的老板,一个客户或者是刚才被你数落的愚蠢得可怜的工程师。

6. 直截了当

不要在注释里面写过多的废话。避免在注释里面卖弄ASCII艺术,写笑话,作诗和过于冗长。简而言之就是保持注释的简单和直接。

7. 使用统一的风格

有些人觉得注释应该让非程序员也能看懂。另外一些人觉得注释需要面对的读者只是程序员。无论如何,正如Successful Strategies for Commenting Code中所说的,最重要的是注释的风格需要统一,并且总是面向相同的读者。就自己而论,我怀疑非程序员是否会去读代码,所以我觉得注释应该面向程序员来写。


那些与众不同的建网站思路

通常建网站的思路会包含:策划、设计、推广运营等,一般的企业建网站是想通过网站达到开展网络宣传的目的,实现电商的目的。通过了解项目用户的宣传策略,使企业以最小的网站投入,超越同行竞争对手,获得更有效的市场回报,网站作为互联网宣传的起点,思路的严谨性、实用性将直接影响到网站的效果。以用户需求为网站导向,结合自身的想法与要求,在满足公司不同阶段的战略目标的基础上,制定阶段性的网站规划思路,那么都有哪些与众不同的建网站思路呢。2-1Z104231Z2596.png


那些与众不同的建网站思路

  建网站的宣传思路:主要工作包含项目可行性分析、同行竞争对手分析、网络产品思路、网络获利思路、设计网站思路、卖点思路、网络推广思路,最后综合为一套专业的网站宣传思路。

  网站在技术方面的可行性分析,就是根据现有的技术条件,分析企业的目标、要求能否达到,以及所采用的技术方案是不是具有一定的先进性。建网站在技术上的可行性可以从硬件的性能要求、程序的性能要求等几个方面去思考。

  在浏览量方面的思路,不论网站内容怎样丰富,网页设计怎样精致,但不能有较高浏览量这个网站还是失败的。怎样能让更多的人知道并访问您的公司网站呢,也就是怎样在网络上宣传自己的企业呢?首先应该理出一套网站的推广方案,并将一些推广方法计划性地规划重组。一方面是客户自己宣传网站,如通过名片,印刷品等打上网址。另外一个方面,通过网络上的电子宣传,如搜索引擎、友情链接、邮件宣传等。

  公司在自己建网站中一定要尽量多明白些信息,多做些比较,审查他们所提交的网站方案。做网站实际上并不是一个省事的工作,怎样站在企业的角度去规划、营造一个实用的网站,投入与网站功能相配套的效果,需要用户与设计企业或专业人员仔细研究,要知道自己想做什么网站,目标又是什么,不要说要做个网站,就随随意便做了个网站,那样是没用的,等于没做,我们要思考以后的问题,举一个简单的例子,现在随意做个网站,到时候想做SEO优化的话能行吗,关键词能上去吗,那还不是得重做,因此要做深远的考虑!

  最后要淡会细心倾听,倾听是为了收集信息,把握现有情况,收集网站用户的想法。一些网站用户的个人想法,例如对产品的认识规划及对产品的希望、背景、对于现有思路的意见等,这些都是存在在网站用户的脑海中,设计师应该努力将这些信息都可视化,这些因素对建网站将会有很大的启迪和灵感激发。以此思路来建设出与众不同的网站。


缘震网络-互联网运营专家,专业建站十余年

联系我们


• xtb_dh.png 免费热线:400-166-3538

• xtb_dh.png 咨询电话:19301461038

• share_icon03.png 咨询QQ :63778992 

• share_icon02.png 微信咨询 : chunhua19820

• zx.png 直接咨询 

公司名称:上海缘震网络科技有限公司

开户银行:中国工商银行上海市彭浦支行

银行账号:1001 2508 0930 0206 455



总部:上海市奉贤区金海公路6055号29号3楼

分部:上海市静安区共和新路4718弄10号楼2楼

商务官网:www.shyuanzhen.cn

新官网:www.shyuanzhen.com

案例库:www.shyuanzhen.cc

彦蓁科技:www.shyanzhen.cn

缘震网络成立于 2014 年,公司主要经营全案策划,高端品质网站建设、多媒体视频宣传片制作、微信公众号开发、微信小程序开发、商城定制、SEO优化、电商托管、空间托管、网站维护、应用软件开发、手机端APP开发、等为客户提供一条龙网络运营解决方案的的技术型企业。我们在人力资源、业务范围、设计、技术、服务、信誉度、规范管理及企业文化等诸多方面完善自己,公司目前已与千余家各类客户进行长期战略合作,提供专业的网站建设与运营服务。我们的口号:广结良缘、震古烁今!

网站关键词:网站建设  网站设计  网站制作  上海网站建设  上海网站设计  上海网站制作  上海网络公司  网站建设上海  上海做网站  上海建设网站  上海做网站公司  上海建网站公司  上海高端网站建设  上海手机网站建设  怎么建设网站  如何建设网站  营销网站建设  品牌网站建设  网站建设方案  响应式网站建设  外贸网站建设  公司网站建设  建设网站  网站建设服务  高端网站建设  网站优化服务  上海网站公司  企业网站设计  官网制作  官网建设  官网设计  网站建设公司  网站设计公司  网站制作公司

版权所有:上海缘震网络科技有限公司   备案号:沪ICP备15001555号       公安备案号:31010602002651   

免费热线:400-166-3538

在线客服