回复内容：
一个是美观，一个是一目了然
/**
* 获取分类商品列表
* @param $shop_id 店铺id
* @param $cate_id 分类id
* @param $page 页码
* @param $per_page 页数
* @return mixed
*/这是使用phpstorm自动生成的
首先注释是让人一目了然，但是跟美观没关系。。还有注释一般为两种，一种是代码行级别的，一种是方法级别的，方法级别一般要求用文档注释。
建议看下，PHP PSR代码标准编程规范
https://github.com/hfcorriez/...