编程规范: 代码中特殊注释TODO、FIXME、XXX 的含义

特殊注释

在编写代码的时候我们可以利用一些公认的特殊注释方式快速简介表达自己的目地

TODO: <说明>

通常写在一些函数的上方或者内部,当然,实际上你可想写哪儿就写哪儿。它表示该注释标识处,有一些代码功能还未实现,未来会实现,<说明> 中应该简单描述下该功能。

FIXME: <说明>

该注释表示该注释标记处的代码有问题或者是错误的,有可能无法正常工作,需要修复,<说明> 中应该简单描述下如何修复该问题。

XXX: <说明>

该注释表示该注释标记处的代码功能虽然实现了,但是实现的方式可能并不那么的好,可以进行一些改进优化,<说明> 中应该简单描述下改进优化的策略。

示例

Golang 中
// TODO: 将实现的功能
// FIXME: 如何修复该部分代码问题
// XXX: 如何改进优化该部分代码

或者

/*
	TODO: 将实现的功能
	FIXME: 如何修复该部分代码问题
	XXX: 如何改进优化该部分代码
*/
Python 中
# TODO: 将实现的功能
# FIXME: 如何修复该部分代码问题
# XXX: 如何改进优化该部分代码

或者
 
Python中的符号 ' 和 " 都表示字符串
'''
	TODO: 将实现的功能
	FIXME: 如何修复该部分代码问题
	XXX: 如何改进优化该部分代码
'''
或者
"""
	TODO: 将实现的功能
	FIXME: 如何修复该部分代码问题
	XXX: 如何改进优化该部分代码
"""

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值