《程序员修炼之道》读书笔记(8):注重实效的项目

2024-09-06 23:18

本文主要是介绍《程序员修炼之道》读书笔记(8):注重实效的项目,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

第8章:注重实效的项目

随着项目开动,我们需要从个体的哲学与编码问题,转向为项目级别的问题。

本章将讨论影响项目成败的几个关键区域。

41《注重实效的团队》

本书在先前讨论了帮助程序员个体更好的方法,这些方法对团队也有效。
下面将针对团队,来重述前面部分章节。

  • 不要留破窗户。团队不应该容忍那些小小的、无人修正的不完美。
  • 煮青蛙。团队更容易被煮熟,因为每个人都觉得别人会在监视环境的变化。
  • 交流。不仅团队内部需要交流,团队也需要和外部交流。
  • DRY。消除团队成员之间的重复。
  • 正交性。我们喜欢围绕功能、而不是工作职务进行组织。
  • 自动化。尽量自动化,这很重要。
  • 知道何时停止绘画。抵抗不继续画下去的诱惑。

42《无处不在的自动化》

让一切尽可能地自动化。尽量避免手动流程。

例如:

  • 项目编译
  • 生成代码
  • 回归测试
  • 构建

还可以让一些管理方面地事物自动化,例如:

  • 网站生成(在线文档、报告等)
  • 批准流程

我们有很多工具可以帮助我们自动化,比如 命令行make各种脚本 等等。或者也可以自己开发工具。

让计算机去做重复、庸常的事情——它们会做得比我们更好。我们有更重要、更困难的事情要做。

43《无情的测试》

  • 早测试
  • 常测试
  • 自动测试

测试什么?

  • 单元测试。对某个模块演练得代码
  • 集成测试。子系统之间能否协同。
  • 验证和校验。看是否能满足需求。
  • 资源耗尽、错误及恢复。资源包括:内存空间、磁盘空间、CPU带宽、挂钟时间、磁盘带宽、网络带宽、调色板、视频分辨率等。
  • 性能测试
  • 可用性测试。真正让用户测试。

怎样测试?

  • 回归测试。把当前得输出和之前得输出对比。
  • 测试数据。你可能会用到现实数据合成数据
  • 演练GUI系统
  • 对测试进行测试。确保测试确实起效。
  • 彻底测试。事实上你不可能确定所有BUG都被找到了,但是有些工具可以帮助你,比如覆盖分析

何时进行测试?

  • 尽快
  • 如果有限制,则确保它出现在计划中。

如果有BUG漏过测试网——增加新的测试,以便下一次抓住它。

44《全都是写》(文档)

你应把文档视为开发过程中的完整组成部分。如果可能的话,可以将文档放在代码中。

为项目制作的文档分为两部分:

  • 内部文档:源码注释、设计、测试等等。
  • 外部文档:用户手册等。

关于代码中的注释:

代码应该有注释,但是太多注释和太少注释一样糟糕

一般而言,注释讨论为何要做某件事、他的目的
至于如何去做,代码已经说明了。因此就不需要注释了,而且违反了 DRY

注释给了你机会,可以把那些难以描述、容易忘记、却又不能记载在别的地方的东西记录下来,例如:

  • 工程上的权衡
  • 为何要做出某些决策
  • 放弃了哪些方案
  • 任何不明了的事儿

JavaDoc所提倡的注释程度似乎是合适的:

/*** Find the peak (highest) value within a specified date* range of samples.* @parm aRange Range of dates to search for date.* @parm aThreshold Minimum value to consider.* @return the value, or null if no value found greater than or equal to the threshold.*/public Sample findPeak(DateRange aRange, double aThreshold);

不应该出现在文档中的:

  • 文件中的代码导出的函数——自动工具可以生成。
  • 修改历史——版本控制系统中有。
  • 该文件使用的其他文件的列表——自动工具可以生成
  • 文件名——应该自动更新
  • 任何其他可以自动生成的东西

如果注释符合格式,JavaDoc这样的工具就可以自动产出 API级的文档。


可执行文档:使用文档中的信息同步到实际数据。这样就遵守了 DRY

文档不应该由专人撰写。

文档最好发布到Web上而不是打印。

使用DocBook等现代的标记语言。

45《极大的期望》(与用户交流期望)

一个小孩打开了昂贵的圣诞礼物,但是却哭了
——尽管你的礼物很贵,但她只想要一个廉价的洋娃娃。

抽象意义上,假如正确实行规范,那么就是成功的。
但在现实中,项目的成功是由它在多大程度上满足了用户的期望来衡量的。

你应该在开发过程中持续和用户交流,达成对未来期望的共同理解。

46《傲慢与偏见》(为自己的工作签名)

让每个人为自己的工作签名。

这样既能防止逃避责任。

也让每个人有了自豪感。

这篇关于《程序员修炼之道》读书笔记(8):注重实效的项目的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1143392

相关文章

Python 中 requests 与 aiohttp 在实际项目中的选择策略详解

《Python中requests与aiohttp在实际项目中的选择策略详解》本文主要介绍了Python爬虫开发中常用的两个库requests和aiohttp的使用方法及其区别,通过实际项目案... 目录一、requests 库二、aiohttp 库三、requests 和 aiohttp 的比较四、requ

SpringBoot项目启动后自动加载系统配置的多种实现方式

《SpringBoot项目启动后自动加载系统配置的多种实现方式》:本文主要介绍SpringBoot项目启动后自动加载系统配置的多种实现方式,并通过代码示例讲解的非常详细,对大家的学习或工作有一定的... 目录1. 使用 CommandLineRunner实现方式:2. 使用 ApplicationRunne

使用IntelliJ IDEA创建简单的Java Web项目完整步骤

《使用IntelliJIDEA创建简单的JavaWeb项目完整步骤》:本文主要介绍如何使用IntelliJIDEA创建一个简单的JavaWeb项目,实现登录、注册和查看用户列表功能,使用Se... 目录前置准备项目功能实现步骤1. 创建项目2. 配置 Tomcat3. 项目文件结构4. 创建数据库和表5.

Python项目打包部署到服务器的实现

《Python项目打包部署到服务器的实现》本文主要介绍了PyCharm和Ubuntu服务器部署Python项目,包括打包、上传、安装和设置自启动服务的步骤,具有一定的参考价值,感兴趣的可以了解一下... 目录一、准备工作二、项目打包三、部署到服务器四、设置服务自启动一、准备工作开发环境:本文以PyChar

多模块的springboot项目发布指定模块的脚本方式

《多模块的springboot项目发布指定模块的脚本方式》该文章主要介绍了如何在多模块的SpringBoot项目中发布指定模块的脚本,作者原先的脚本会清理并编译所有模块,导致发布时间过长,通过简化脚本... 目录多模块的springboot项目发布指定模块的脚本1、不计成本地全部发布2、指定模块发布总结多模

SpringBoot项目删除Bean或者不加载Bean的问题解决

《SpringBoot项目删除Bean或者不加载Bean的问题解决》文章介绍了在SpringBoot项目中如何使用@ComponentScan注解和自定义过滤器实现不加载某些Bean的方法,本文通过实... 使用@ComponentScan注解中的@ComponentScan.Filter标记不加载。@C

javafx 如何将项目打包为 Windows 的可执行文件exe

《javafx如何将项目打包为Windows的可执行文件exe》文章介绍了三种将JavaFX项目打包为.exe文件的方法:方法1使用jpackage(适用于JDK14及以上版本),方法2使用La... 目录方法 1:使用 jpackage(适用于 JDK 14 及更高版本)方法 2:使用 Launch4j(

Docker集成CI/CD的项目实践

《Docker集成CI/CD的项目实践》本文主要介绍了Docker集成CI/CD的项目实践,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学... 目录一、引言1.1 什么是 CI/CD?1.2 docker 在 CI/CD 中的作用二、Docke

SpringBoot项目引入token设置方式

《SpringBoot项目引入token设置方式》本文详细介绍了JWT(JSONWebToken)的基本概念、结构、应用场景以及工作原理,通过动手实践,展示了如何在SpringBoot项目中实现JWT... 目录一. 先了解熟悉JWT(jsON Web Token)1. JSON Web Token是什么鬼

手把手教你idea中创建一个javaweb(webapp)项目详细图文教程

《手把手教你idea中创建一个javaweb(webapp)项目详细图文教程》:本文主要介绍如何使用IntelliJIDEA创建一个Maven项目,并配置Tomcat服务器进行运行,过程包括创建... 1.启动idea2.创建项目模板点击项目-新建项目-选择maven,显示如下页面输入项目名称,选择