Clean Code
1. 关于代码
- 遵循后台/前端框架的项目结构,文件放到该放的文件夹里面。
- 文件的命名:全部小写,名字表达出功能。
- 函数、变量命名:名字表达出功能,禁止使用看不懂的名字。
- 代码注释:通过函数名、变量名能一眼看出功能的,无须写注释;含复杂逻辑的,一定写注释。
- 代码重构:相同逻辑的代码块出现多次,建议重构成函数。类似功能的代码,放在一起。
- 接口返回模型:坚持使用统一的接口返回格式,便于异常处理。
2. 关于Git
- 阅读完Pro Git的重点章节后,再使用Git。
- 本项目规模很小,无需使用分支开发模式。
git commit
中的message
应当简介地描述出所作的改动,禁止直接在github上上传/改动文件而不写入任何message
。git push
前先git pull
。- 每次提交的内容应当只针对一个功能的添加/改动,不建议一次性提交包含多个功能点修改的内容。
- 只要合理地使用git,不用担心项目改动后出现的bug,因为可以回退。
- 如果实在不熟悉git的使用,建议下载GitHub Desktop。
- git的速度太慢或连接不上:科学上网是最佳途径。
Author: 冯旭
Create Time: 2022-02-19
Update Time: 2022-02-19