learn-tech/专栏/左耳听风/072程序员练级攻略(2018):程序员修养.md
2024-10-16 06:37:41 +08:00

18 KiB
Raw Blame History

                        因收到Google相关通知网站将会择期关闭。相关通知内容
                        
                        
                        072  程序员练级攻略2018程序员修养
                        在完成上述的入门知识学习之后,我们要向专业的计算机软件开发进军了。但是在学习那些专业的知识前,我们先要抽一部分的篇幅来说一下程序员的修养。这是程序员的工程师文化,也就是程序员的价值观,因为如果你的技术修养不够的话,你学再多的知识也是没有用的。

要了解程序员的修养,你可以先从 Quora 上的这个贴子开始 “What are some of the most basic things every programmer should know?”,我摘录一些在这里供你参考。

Bad architecture causes more problems than bad code. You will spend more time thinking than coding. The best programmers are always building things. Theres always a better way. Code reviews by your peers will make all of you better. Fewer features for better code is always the right answer in the end. If its not tested, it doesnt work. Dont reinvent the wheel, library code is there to help. Code thats hard to understand is hard to maintain. Code thats hard to maintain is next to useless. Always know how your business makes money, that determines who gets paid what. If you want to feel important as a software developer, work at a tech company.

然后是 《97 Things Every Programmer Should Know》其中有 97 个非常不错的编程方面的建议。这篇文章是比较经典的,别被 “97” 吓住,你可以快速浏览一下,会让你有不同的感觉的。另外,在工作一段时间后再来读,你会更有感觉。

英文能力

必须指出,再往下走,有一个技能非常重要,那就是英文。如果对这个技能发怵的话,那么你可能无缘成为一个程序员高手了。因为我们所有的计算机技术全部来自于西方国家,所以如果你要想成为一个高手的话,那么必须到信息的源头去。英文的世界真是有价值的信息的集散地。你可以在那里,到官网上直接阅读手册,到 StackOverflow 上问问题,到 YouTube 上看很多演讲和教学,到 GitHub 上参与社区,用 Google 查询相关的知识,到国际名校上参加公开课……

如果你的英文能力有问题的话,那么基本上来说,你无法成为一个高手。因此,学好英文是非常有必要的,我说的不只是读写,还有听和说。相信你在学校里学过英文,有一定的基础。所以,我给你下面的这些建议。

坚持 Google 英文关键词,而不是在 Google 里搜中文。 在 GitHub 上只用英文。用英文写代码注释,写 Code Commit 信息,用英文写 Issue 和 Pull Request以及用英文写 Wiki。 坚持到 YouTube 上每天看 5 分钟的视频。YouTube 上有相关的机器字幕,实在不行就打开字幕。 坚持用英文词典而不是中文的。比如:剑桥英语词典 或是 Dictionary.com 。你可以安装一个 Chrome 插件 Google Dictionary。 坚持用英文的教材而不是中文的。比如BBC 的 Learning English ,或是到一些 ESL 网站上看看,如 ESL: English as a Second Language 上有一些课程。 花钱参加一些线上的英文课程,用视频和老外练习。

问问题的能力

提问的智慧How To Ask Questions The Smart Way一文最早是由 Eric Steven Raymond 所撰写的,详细描述了发问者事前应该做好什么,而什么又是不该做的。作者认为这样能让问题容易令人理解,而且发问者自己也能学到较多东西。

此文一经发出,就广受好评,被广泛转载并奉为经典。该文也有 简体中文翻译版 被流传着,所以在华人界也是篇很有名的文章。有两个著名的缩写 STFWSearch the fxxking web以及 RTFMRead the fxxking manual就是出自本文。

另外,还有一个经典的问题叫 X-Y Problem。对我来说这是一个很容易犯的错误所以你也要小心避免我曾经在我的 Coolshell 上写过这个事《X-Y 问题》)。

然后,你可以到 StackOverflow 上看看如何问问题的一些提示 “FAQ for StackExchange Site”。

作为一个程序员,不做伸手党,你必需要读一读这几篇文章,并努力践行。

写代码的修养

除了《代码大全》外,你还需要补充一些如何写好代码的知识,有以下几本书推荐。

《重构:改善既有代码的设计》,这本书是 Martin Fowler 的经典之作。这本书的意义不仅仅在于 “ 改善既有代码的设计 “,也指导了我们如何从零开始构建代码的时候避免不良的代码风格。这是一本程序员必读的书。 《修改代码的艺术》,这本书是继《重构》之后探讨修改代码技术的又一里程碑式的著作,而且从涵盖面和深度上都超过了前两部经典(《代码大全》和《重构》)。作者将理解、测试和修改代码的原理、技术和最新工具(自动化重构工具、单元测试框架、仿对象、集成测试框架等),与解依赖技术和大量开发和设计优秀代码的原则、最佳实践相结合,许多内容非常深入。这本书可以让你不仅能掌握最顶尖的修改代码技术,还可以大大提高对代码和软件开发的领悟力。 《代码整洁之道》,这本书提出一种观念:代码质量与其整洁度成正比。干净的代码,既在质量上较为可靠,也为后期维护和升级奠定了良好基础。本书作者给出了一系列行之有效的整洁代码操作实践。这些实践在本书中体现为一条条规则(或称 ” 启示 “),并辅以来自现实项目正反两面的范例。 《程序员的职业素养》,这本书是编程大师 Bob 大叔 40 余年编程生涯的心得体会,讲解成为真正专业的程序员需要什么样的态度、原则,需要采取什么样的行动。作者以自己以及身边的同事走过的弯路、犯过的错误为例,意在为后来人引路,助其职业生涯迈上更高台阶。

另外作为一个程序员Code Review 是非常重要的程序员修养。 Code Review 对我的成长非常有帮助,我认为没有 Code Review 的公司都没有必要呆(因为不做 Code Review 的公司一定是不尊重技术的)。下面有几篇我觉得还不错的 Code Review 的文章,供你参考。

Code Review Best Practices How Google Does Code Review LinkedIns Tips for Highly Effective Code Review

除了 Code Review 之外Unit Test 也是程序员的一个很重要的修养。写 Unit Test 的框架一般来说都是从 JUnit 衍生出来的,比如 CppUnit 之类的。学习 JUnit 使用的最好方式就是到其官网上看 JUnit User Guide中文版。然后有几篇文章你可以看看也可以自行 Google

You Still Dont Know How to Do Unit Testing Unit Testing Best Practices: JUnit Reference Guide JUnit Best Practices

安全防范

在代码中没有最基本的安全漏洞问题,也是我们程序员必需要保证的重要大事,尤其是对外暴露 Web 服务的软件,其安全性就更为重要了。对于在 Web 上经常出现的安全问题,有必要介绍一下 OWASP - Open Web Application Security Project。

OWASP 是一个开源的、非盈利的全球性安全组织,致力于应用软件的安全研究。其被视为 Web 应用安全领域的权威参考。2009 年,国际信用卡数据安全技术 PCI 标准将其列为必要组件,美国国防信息系统局、欧洲网络与信息安全局、美国国家安全局等政府机构所发布的美国国家和国际立法、标准、准则和行业实务守则参考引用了 OWASP。

美国联邦贸易委员会FTC强烈建议所有企业需遵循 OWASP 十大 Web 弱点防护守则。所以,对于[https://www.owasp.org/index.php/Category:OWASP_T](http://localhost:808001 左耳听风/html版本/ op_Ten_Project”>OWASP Top 10 项目 是程序员非常需要关注的最基本的也是最严重的安全问题现在其已经成了一种标准这里是其中文版《OWASP Top 10 2017 PDF 中文版》。

下面是安全编程方面的一些 Guideline。

伯克立大学的 Secure Coding Practice Guidelines。 卡内基梅隆大学的 SEI CERT Coding Standards。

此外,有一篇和 HTTP 相关的安全文章也是每个程序员必需要读的——《Hardening Your HTTP Security Headers》。

最后想说的是 “ 防御性编程 “英文叫Defensive Programming它是为了保证对程序的不可预见的使用不会造成程序功能上的损坏。它可以被看作是为了减少或消除墨菲定律效力的想法。防御式编程主要用于可能被滥用恶作剧或无意地造成灾难性影响的程序上。下面是一些文章。

The Art of Defensive Programming。 当然也别太过渡了这篇文章可以看看Overly defensive programming。

软件工程和上线

系统上线是一件比较严肃的事,这表明你写的软件不是跑在自己的机器上的玩具,或是实验室里的实验品,而是交互给用户使用的,甚至是用户付费的软件。对于这样的软件或系统,我们需要遵守一些上线规范,比如,需要认真测试,并做上线前检查,以及上线后监控。下面是几个简单的规范,供你参考。

关于测试,推荐两本书。

《完美软件:对软件测试的各种幻想》,这本书重点讨论了与软件测试有关的各种心理问题及其表现与应对方法。作者首先阐述软件测试之所以如此困难的原因–人的思维不是完美的,而软件测试的最终目的就是发现对改善软件产品和软件开发过程有益的信息,故软件测试是一个信息获取的过程。 《Google 软件测试之道》,描述了测试解决方案,揭示了测试架构是如何设计、实现和运行的,介绍了软件测试工程师的角色;讲解了技术测试人员应该具有的技术技能;阐述了测试工程师在产品生命周期中的职责;讲述了测试管理,并对在 Google 的测试历史上或者主要产品上发挥了重要作用的工程师的访谈,这令那些试图建立类似 Google 的测试流程或团队的人受益很大。

当你的系统要上线时,你是不是已经做好上线的准备了?这里有两个 Checklist 供你做上线前的一些检查。

Server Side checklist Single Page App Checklist

《Monitoring 101》这是一篇运维方面的入门文章告诉你最基本的监控线上运行软件的方法和实践。

小结

好了,总结一下今天分享的主要内容。程序员修养看似与程序员练级关系不大,实际上却能反映出程序员的工程师特质和价值观,决定了这条路你到底能走多远。有修养的程序员才可能成长为真正的工程师和架构师,而没有修养的程序员只能沦为码农。

因此,在这篇文章中,我指出了我认为比较重要的几个方面:英文能力、问问题的能力、写代码的修养、安全防范意识、软件工程和上线规范等。这些能力的训练和培养将为后续的学习和发展夯实基础。

附录:编程规范

我们在写代码时,最好参考一些已有的最佳实践。为什么要有编程规范和最佳实践,要让所有人按一定的规范来编程呢?有下面几个主要原因。

可以让你的代码很规整,这有利于代码易读性,从而可以更容易地维护。 提升开发效率,我们知道,效率来自于结构化,而不是杂乱。 可以让你的软件避免一些容易掉坑的陷阱,也让 Bug 更少,质量更高。 可以让团队成员更高效率地协作。

如果一个程序员没有这类规范和最佳实践的沉淀,那么是很难成为真正的程序员的,只能沦为码农。

当然,对于一些代码风格方面的东西,比如左大括号是否要换行,缩进是用 tab 还是空格等等,我觉得没有对错,只要团队统一就好了。

下面,我罗列了一堆各种语言的编程规范,供你参考。

编程语言相关

C 语言

NASA C Style。 C Coding Standard。 C Programming/Structure and style。 Linux kernel coding style。 GNU Coding StandardGNU 的编码规范。

C++ 语言

C++ Core Guidelines这个文档是各种 C++ 的大拿包括原作者在内在持续讨论更新的和 C++ 语言相关的各种最佳实践。 Google C++ Style Guide。

Go 语言

Effective Go Go 的语法不复杂所以Go 语言的最佳实践只需要看这篇官方文档就够了。

Java 语言

Code Conventions for the Java™ Programming Language Java 官方的编程规范。 Google Java Style GuideGoogle 的 Java 编码规范。

JavaScript 语言

JavaScript The Right Way ,一个相对比较容读的 JavaScript 编程规范,其中不但有代码规范,还有设计模式,测试工具,编程框架,游戏引擎…… Google JavaScript Style GuideGoogle 公司的 JavaScript 的编码规范,一个非常大而全的编程规范。 Airbnb JavaScript Style GuideAirbnb 的 JavaScript 编程规范。没 Google 的这么大而全,但是也很丰富了。 jQuery Core Style GuidejQuery 的代码规范。 JavaScript Clean Code前面推荐过的《代码整洁之道》一书中的 JavaScript 的实践 。

还有一些其它相对比较简单的 JavaScript 编程规范。

JavaScript Style Guides And Beautifiers ,这是一篇推荐 JavaScript 编程规范的文章,你可以看看。 JavaScript Style Guide and Coding Conventions这是 W3Schools 的 JavaScript。 Code Conventions for the JavaScript。

PHP 语言

PHP FIGPHP 编码规范及标准推荐。 PHP The Right Way除了编码规范之外的各种 PHP 的最佳实践还包括一些设计模式安全问题以及服务部署Docker 虚拟化以及各种资源。 Clean Code PHP《代码整洁之道》的 PHP 实践。

Python 语言

Style Guide for Python CodePython 官方的编程码规范。 Google Python Style GuideGoogle 公司的 Python 编码规范。 The Hitchhikers Guide to Python这不只是 Python 的编程规范,还是 Python 资源的集散地,强烈推荐。

Ruby 语言

Ruby Style GuideAirbnb 公司的 Ruby 编程规范。 Ruby Style Guide 。

Rust 语言

Rust Style Guide。 Rust Guidelines 开源社区里最好的 Rust 编程规范。

Scala 语言

Scala Style GuideScala 官方的编程规范。 Databricks Scala Guide - Databricks 的 Scala 编程规范。 Scala Best Practices。

Shell 语言

Google Shell Style GuideGoogle 的 Shell 脚本编程规范。

Node.js 相关

npm-coding-style。 Microsoft + Node.js Guidelines。 Node.js Style Guide。

Mozilla 的编程规范

Mozilla Coding Style Guide其中包括 C、C++、Java、Python、JavaScript、Makefile 和 SVG 等编程规范。

前端开发相关

CSS GuidelinesCSS 容易学,但是不好写,这篇规范会教你如何写出一个健全的、可管理的,并可以扩展的 CSS。 Scalable and Modular Architecture for CSS这是一本教你如何写出可扩展和模块化的 CSS 的电子书,非常不错。 Frontend Guidelines一些和 HTML、CSS、JavaScript 相关的最佳实践。 Sass GuidelinesSass 作为 CSS 的补充,其要让 CSS 变得更容易扩展。然而,也变得更灵活,这意味着可以被更容易滥用。这里这篇 ” 富有主见 “ 的规范值得你一读。 Airbnb CSS / Sass Styleguide Airbnb 的 CSS/Sass 规范。 说了 Sass 就不得不说 LESS这里有几篇和 LESS 相关的LESS Coding Guidelines、LESS Coding Guidelines、LESS coding standard。 HTML Style Guide一个教你如何写出性能更高结构更好容易编程和扩展的 HTML 的规范。 HTML + CSS Code Guide如何写出比较灵活、耐用、可持续改进的 HTML 和 CSS 的规范。 CoffeeScript Style GuideCoffeeScript 的最佳实践和编程规范。 Google HTML/CSS Style GuideGoogle 的 HTML/CSS 的编程规范。 Guidelines for Responsive Web Design ,响应式 Web 设计的规范和最佳实践。 U.S. Web Design Standards这是美国政府网端要求的一些 UI 交互可视化的一些规范。

最后是一个前端开发的各种注意事项列表,非常有用。

Front-End Checklist ,一个前端开发的 Checklist其中包括 HTML、CSS 和 JavaScript还和图片、字体、SEO、性能相关还包括关一些和安全相关的事项这个列表真的是太好了。

移动端相关

Kotlin

Coding Conventions。

Objective-C 语言

Objective-C Style guideStyle guide & coding conventions for Objective-C projects。 Google Objective-C Style Guide。 NYTimes Objective-C Style Guide The Objective-C Style Guide used by The New York Times。

Swift 语言

API Design Guidelines。 Swift - 一个 Swift 的相关编程规范的教程。 Swift style guide。 Swift Style Guide - LinkedIn 的官方 Swift 编程规范。 Metovas Swift style guide。 Xmartlabs Swift Style GuideXmartlabs 的 Swift 编程规范。

API 相关

HAL一个简单的 API 规范教程。 Microsoft REST API Guidelines微软软的 Rest API 规范。 API Design Guide。 RESTful API Designing guidelines-The best practices。 JSON API - RecommendationsJSON 相关的 API 的一些推荐实践。 API Security Checklist API 的安全问题的检查列表。

开发工具相关

Markdown 相关

Google Markdown Style Guide。 Markdown Style Guide。

JSON

Google JSON Style Guide。 JSON Style Guide。

Git 相关

Git Style Guide。 Few Rules from Git Documentation。

正则表达式相关

RegexHQ。 Learn regex the easy way。