Menu

5.4. 代码注释和解析

简介

技术文章里,避免不了的,会带有大量的注释,本篇文章讨论代码注释和代码讲解时需要注意的地方。

1. 避免无用的注释

很多时候是代码生成器生成的,如下:

<?php

use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class UsersAddEmailVerified extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->boolean('email_verified')->default(false)->after('remember_token');
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('email_verified');
        });
    }
}

此时应删除掉注释,原因如下:

file

删除以后,干净也专注很多了:

<?php

use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class UsersAddEmailVerified extends Migration
{
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->boolean('email_verified')->default(false)->after('remember_token');
        });
    }

    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('email_verified');
        });
    }
}

2. 善用注释来讲解大块代码

大块代码在文章中讲解,经常会遇到以下的问题:

file

一个合理的做法是,直接在代码里添加注释,这样可读性要好多了:

file

本文章首发在 Laravel China 社区
上一篇 下一篇
讨论数量: 1
发起讨论


Jourdon
5.3 和 5.5 内容是重复的?
0 个点赞 | 0 个回复 | 问答
刻意练习,每日精进。
0
点赞
103
浏览
1
讨论

维护者