コメントの書き方にクセがでる

生成AIでコードをかいていると細かくコードにコメントを入れてくれます。関数の上になんの処理か、関数を変数にいれるときの横にコメントを書いたり、人間だと書いたり書かなかったり

あとコメントが自分の書いたコード生成AIが書いたコードを入れていくとコメントのタイプが混在していきます #だったり　''' ''' や//だったりこれらが混在してたりします。

こんな感じでプログラミング初心者はコードに統一感がなくなってくるので、コードを見られると生成AIで書いたでしょって簡単にばれちゃいますね

試しにAIで上記の条件でコードを書いてもらいました


import random

# ランダムな数値のリストを生成する関数
def generate_random_numbers(count):
    """この関数は指定された数のランダムな数値を生成します。"""
    numbers = []  # 数値を格納するリスト
    for i in range(count):  # 指定回数ループ
        numbers.append(random.randint(1, 100))  # 1から100のランダムな数値を追加
    return numbers

"""
数値のリストを昇順にソートする関数
組み込みの sorted 関数を使用
"""
def sort_numbers(numbers):
    return sorted(numbers)  # リストをソート

# 平均値を計算する関数
def calculate_average(numbers):
    """数値のリストの平均を計算します。"""
    total = sum(numbers)  # 数値の合計を求める
    count = len(numbers)  # 数値の個数を取得
    return total / count  # 平均を計算

# メイン処理
if __name__ == "__main__":
    num_list = generate_random_numbers(10)  # 10個のランダムな数値を生成
    sorted_list = sort_numbers(num_list)
    avg = calculate_average(sorted_list)  # 平均値を計算

    # 結果を出力
    print("生成された数値:", num_list)
    print("ソートされた数値:", sorted_list)
    print("平均値:", avg)

こんな感じになるので、処理は問題ないですがコードが美しくないですよね

成長するコツはこういったコードを書いたあとに自分できれいに書き直すことが大事かなって思いました

ある程度プログラミング初心者がコードを書けるようになると、AIに書いてもらったコードが実は冗長的だったり効率が悪い処理などがあったりします。そいうのを見つけて、自分で買い直す練習をするのも楽しいものですよね

コメントは非常に重要なので、きれいに各クセをつける
ただコピペしないってことを意識して、この人自分でコードかけない人だとおもわれないようにしたいものです