【初心者向け】きれいなPythonプログラミングを書くコツとは？

Pythonのプログラミングを始めたばかりの初心者だが、

いざ初めてみたは良いが、そうしたポイントで初心者の人はつまづきがちです。

HATOBA

俺も大学時代、プログラミング始めたばかりの頃は同じような感じでしたので、安心してください(^^;)

今回は、そういったつまづきポイントを少しでも解消できるように、綺麗で読みやすいコードを書くためのコツをまとめました！

その前に、まずPythonのインストール方法などから知りたいという方は
こちらの記事を読んでみてください↓

あわせて読みたい

【初心者向け】Pythonとは？現役エンジニアが徹底解説。 – しんげつBlog🌑

Pythonのかんたんなサンプルコードを知りたいという方には
こちらの記事がおすすめです↓

あわせて読みたい

Pythonの面白いサンプルプログラム3選！現役エンジニアが解説。 – しんげつBlog🌑

HATOBA

こんにちは。この記事を書いたHATOBA(はとば)です。

きれいなPythonコードとは何か

きれいなPythonコードとは、端的に言うと「誰が読んでも理解しやすく、修正や追加がしやすい書き方」のことを指します。
読みやすいコードは、作業の引き継ぎやバグ修正をスムーズにする力を持っています。

その理由として、以下のような点が挙げられます。

たとえば、同じ処理をする以下のコードを比べてみてください。

# 悪い例
x = 10
y = 20
z = x + y
print(z)

# よい例
num_apple = 10
num_orange = 20
total_fruit = num_apple + num_orange
print(total_fruit)

後者のほうが、何の計算をしているか、変数の用途などがすぐにわかりやすいと思います。

このように、意味のある名前を使い、読みやすく書くことで、きれいなPythonコードに近づけます。

Python初心者が意識すべき基本の書き方

Pythonを使う際、基本の書き方を守るだけで、ぐっと見やすいコードになります。
とくに初心者の方は、ルールを意識するだけでコードの質が向上します。

意識したいポイントは以下のとおりです。

以下は、基本を意識したサンプルです。

# 商品の合計金額を出す関数
def calculate_total(price, tax):
    total = price + tax
    return total

このように整った書き方を心がけることで、他の人にも伝わるコードが書けます。
書き方の基本をしっかり守ることが、きれいなコードへの第一歩です。

Pythonの命名規則を守ろう

変数や関数の名前をわかりやすく付けることで、コードの意味がすぐに伝わります。
命名規則を守ることは、プログラム全体の理解度を高めるために欠かせません。

Pythonでは、次のような命名ルールが一般的です。

たとえば、以下のような例です。

# 悪い例
def c(a, b):
    return a * b

# よい例
def calculate_area(width, height):
    return width * height

※「よい例」の方では、変数名や関数名に対して意味が読み取りやすい命名を行っています。

このように、命名規則を守ることで、何の処理をしている関数かすぐにわかります。
名前を工夫するだけで、きれいで親切なPythonコードになります。

Pythonで役立つコードの整理術

コードが長くなると、どこに何が書いてあるのか分かりにくくなります。
整理されたコードは、読む人にやさしく、修正しやすい利点があります。

とくに意識したい整理のコツは以下の通りです。

以下は関数にまとめた例です。

# 割引価格を計算する関数
def calculate_discount(price, rate):
    return price * (1 - rate)

# 使用例
discounted_price = calculate_discount(1000, 0.1)

このように関数で分けることで、コードの見通しが良くなりますし、
整理整頓されたコードは、読み手に安心感を与えます。

[PR] 自宅で現役エンジニアから学べる TechAcademy(テックアカデミー) まずは無料相談！

当ブログでは、IT業界への転職、副業・フリーランスとしての働き方を目指している方に
「自宅で現役エンジニアから学べる TechAcademy」をおすすめしてます。

当ブログから申し込みの無料相談で「必ずもらえるAmazonギフト券500円分」をゲットしよう！

完全オンライン完結型の学習サービスなので、場所や時間を選ばず、
自宅やカフェなど好きな環境で効率的にスキルを磨けます。

どういうサービス？

最大の特徴は、指導を担当するのがすべて現役のプロエンジニアである点です。
実務で使われる知識や考え方を直接学べるため、教材だけでは得られない実践的なスキルを習得できます。

学習中は週2回のマンツーマンメンタリングで進捗確認や課題のフィードバックが受けられるほか、
毎日15時〜23時に対応しているチャットサポートを活用すれば、疑問点をその日のうちに解消可能です。

HATOBA

コース申し込まれる方は初心者が9割以上らしいですよ～ ほぼ未経験とかでも心配いらないです！

挫折しにくい学習設計が用意されているため、独学で続かなかった方でも安心です。

教育訓練給付金の対象コースでは最大70％（約38万円）の補助が受けられるのも魅力！

申込方法教えて！

興味ある方は、まず公式サイトの無料相談や無料体験を申し込んでみてください(※下側に画像リンクを用意してます)

評判とか口コミどうなん？

受講生の印象としては
「サポートが丁寧で続けやすい」「転職活動で役立った」
という声が多く、

一方で「担当によって対応に差がある」といった口コミも一部あります。

とはいえ、全体的にはオンラインでありながら、受講者に寄り添ってくれる指導スタイルが好評です。

受講するメリットは？

TechAcademyのメリットは「学んだスキルをそのままキャリアにつなげやすい点」です。
受講中に作成するポートフォリオは転職や案件獲得の武器になり、
キャリア支援サービス「TechAcademyキャリア」ではポートフォリオ添削や面接対策、
企業からのスカウトを受けることも可能。

HATOBA

受講した人には副業の仕事を１案件以上斡旋してくれるんだって～

転職はもちろん、副業で案件を取るためのノウハウも学べるため、
学習から収入アップまでの流れをスムーズに描けます。

料金どのぐらいなの？

料金はコースや期間によって異なりますが、例えばPythonやWeb開発の4週間コースは社会人で約17万円から。
より長期的に学ぶプランや転職保証コースでは数十万円〜最大80万円台となります。

ただし給付金制度や割引を活用すれば、実質的な負担を大きく減らすことが可能です。

それって私向きなの？

このように、TechAcademyは

という方に
最適な学習サービスです。

逆に、

にはあまり向かないかもしれません。

もし

• 今の仕事に不安がある
• 副業で新しい収入源を得たい
• 将来フリーランスとして自由に働きたい

と思っているのであれば
TechAcademyはキャリアを大きく変えるきっかけになるはずです。

HATOBA

こちらのリンクから申し込みの無料相談でAmazonギフト券500円分が必ずもらえますよ～ やってみて損はないはず！

興味ある方はぜひこちらから↓ まずは無料相談の申し込みをしてみてください！

Pythonの標準スタイルを知ろう

Pythonには、書き方の手本となる「PEP8」という決まりがあります。
この決まりに従えば、誰が見ても統一感のあるコードになります。

PEP8の代表的なルールは次のとおりです。

※正式なドキュメント(日本語訳)のリンクはこちらです↓

ボリュームが多いですが、ある程度Pythonに慣れたらざっと目を通してみてください。

たとえばPEP8を意識してみると、このような書き方のコードになります。

# 数値を二倍にする関数
def double_number(number):
    return number * 2

このように、スタイルの決まりを知っておくと、いつでもきれいなPythonコードが書けるようになります。

Python初心者におすすめの練習方法

きれいなPythonコードを書く力は、練習によって育てられます。
特別な知識よりも、くり返し書いて見ることが上達の近道です。

初心者におすすめの練習法はこちらです。

実際に手を動かしながら、読みやすい書き方を意識すると、自然ときれいなコードが書けるようになります。
とにかく書いて、直して、学ぶことが大切です。

まとめ

今回は、初心者がつまづきがちなポイント

をすこしでも解消できるように、綺麗で読みやすいコードを書くコツについて記載しました。

まずは簡単なコードから、徐々にステップアップを目指してみて下さい。

ここまで読んでくれてありがとうございました。