《程序员修炼之道》读书笔记(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

相关文章

MySQL版本问题导致项目无法启动问题的解决方案

《MySQL版本问题导致项目无法启动问题的解决方案》本文记录了一次因MySQL版本不一致导致项目启动失败的经历,详细解析了连接错误的原因,并提供了两种解决方案:调整连接字符串禁用SSL或统一MySQL... 目录本地项目启动报错报错原因:解决方案第一个:第二种:容器启动mysql的坑两种修改时区的方法:本地

springboot项目中使用JOSN解析库的方法

《springboot项目中使用JOSN解析库的方法》JSON,全程是JavaScriptObjectNotation,是一种轻量级的数据交换格式,本文给大家介绍springboot项目中使用JOSN... 目录一、jsON解析简介二、Spring Boot项目中使用JSON解析1、pom.XML文件引入依

使用vscode搭建pywebview集成vue项目实践

《使用vscode搭建pywebview集成vue项目实践》:本文主要介绍使用vscode搭建pywebview集成vue项目实践,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录环境准备项目源码下载项目说明调试与生成可执行文件核心代码说明总结本节我们使用pythonpywebv

Maven项目中集成数据库文档生成工具的操作步骤

《Maven项目中集成数据库文档生成工具的操作步骤》在Maven项目中,可以通过集成数据库文档生成工具来自动生成数据库文档,本文为大家整理了使用screw-maven-plugin(推荐)的完... 目录1. 添加插件配置到 pom.XML2. 配置数据库信息3. 执行生成命令4. 高级配置选项5. 注意事

eclipse如何运行springboot项目

《eclipse如何运行springboot项目》:本文主要介绍eclipse如何运行springboot项目问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目js录当在eclipse启动spring boot项目时出现问题解决办法1.通过cmd命令行2.在ecl

SpringBoot项目Web拦截器使用的多种方式

《SpringBoot项目Web拦截器使用的多种方式》在SpringBoot应用中,Web拦截器(Interceptor)是一种用于在请求处理的不同阶段执行自定义逻辑的机制,下面给大家介绍Sprin... 目录一、实现 HandlerInterceptor 接口1、创建HandlerInterceptor实

Maven项目打包时添加本地Jar包的操作步骤

《Maven项目打包时添加本地Jar包的操作步骤》在Maven项目开发中,我们经常会遇到需要引入本地Jar包的场景,比如使用未发布到中央仓库的第三方库或者处理版本冲突的依赖项,本文将详细介绍如何通过M... 目录一、适用场景说明​二、核心操作命令​1. 命令格式解析​2. 实战案例演示​三、项目配置步骤​1

golang实现动态路由的项目实践

《golang实现动态路由的项目实践》本文主要介绍了golang实现动态路由项目实践,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习... 目录一、动态路由1.结构体(数据库的定义)2.预加载preload3.添加关联的方法一、动态路由1

Spring 缓存在项目中的使用详解

《Spring缓存在项目中的使用详解》Spring缓存机制,Cache接口为缓存的组件规范定义,包扩缓存的各种操作(添加缓存、删除缓存、修改缓存等),本文给大家介绍Spring缓存在项目中的使用... 目录1.Spring 缓存机制介绍2.Spring 缓存用到的概念Ⅰ.两个接口Ⅱ.三个注解(方法层次)Ⅲ.

一文教你Java如何快速构建项目骨架

《一文教你Java如何快速构建项目骨架》在Java项目开发过程中,构建项目骨架是一项繁琐但又基础重要的工作,Java领域有许多代码生成工具可以帮助我们快速完成这一任务,下面就跟随小编一起来了解下... 目录一、代码生成工具概述常用 Java 代码生成工具简介代码生成工具的优势二、使用 MyBATis Gen