Swiftの関数の命名規則と可読性向上のコツを解説！初心者でも読みやすいコードが書ける方法

Swift 関数の命名規則と可読性向上のコツ

先生と生徒の会話形式で理解しよう

生徒

「Swiftで関数を作るときの名前って、どう付ければいいんですか？」

先生

「いい質問ですね。関数の名前は、その処理が何をするのか一目でわかるようにすることが大事なんですよ。」

生徒

「なるほど…でも、短くてもいいし、長くてもいいって聞いたことがあります。どっちが正解ですか？」

先生

「では、Swiftの関数命名規則と、読みやすいコードを書くためのコツについて、具体的に説明していきましょう。」

1. Swiftにおける関数の命名ルールとは？

Swiftでは、関数の名前はキャメルケース（camelCase）という書き方が推奨されています。最初の単語は小文字で始め、次の単語の頭文字は大文字にします。


func greetUser() {
    print("こんにちは！")
}

greetUserのように、greet（あいさつする）＋User（ユーザー）という意味を持つ単語を組み合わせて、処理内容が想像できるようにします。

2. 名前は「何をするか」がわかるようにする

関数名は短くするよりも、「処理の意味がはっきり伝わる」ことを優先しましょう。たとえば、以下のような名前の付け方は良くありません：


func a() {
    // 意味がわからない
}

func calc() {
    // 何を計算するのかわからない
}

逆に、次のように書けば、何をする関数かすぐに理解できます。


func calculateTotalPrice() {
    // 合計金額を計算する
}

func fetchUserProfile() {
    // ユーザー情報を取得する
}

3. 動詞から始めるのが基本スタイル

関数は「何かの処理を実行するもの」なので、動詞で始めるのが一般的です。たとえば以下のようなものがあります：

printMessage()：メッセージを出力する
loadData()：データを読み込む
sendRequest()：リクエストを送る

「print」や「load」、「send」など、処理のアクションを示す言葉を先頭につけることで、読みやすくなります。

4. 引数名も命名の一部として考えよう

Swiftでは、関数の引数名も関数名とセットで読みやすさに関わります。以下のように、自然な文章になるよう意識するとベストです。


func sendEmail(to address: String, subject: String) {
    // メール送信処理
}

このように、「sendEmail(to: subject:)」と読めば意味が通じる形が理想です。

5. 略語を避けてわかりやすい単語を使おう

関数名や引数名では、短い略語や意味の曖昧な単語は避けるようにしましょう。


func updUsr() {
    // アップデート？アップロード？
}

これでは何をする関数なのか不明瞭です。以下のように、はっきりとした名前を使いましょう。


func updateUserProfile() {
    // ユーザープロファイルを更新する
}

6. 一貫性があるとコード全体が読みやすくなる

プロジェクト全体で命名スタイルを統一することで、コードの可読性が大きく向上します。

たとえば、取得処理はすべてfetchで始める、変換処理はconvertで始めるなど、共通のルールを決めると、他の人が読んでも理解しやすくなります。

Swiftを基礎から実践レベルまで学びたい人や、 iOSアプリ開発を本格的に始めたい人には、定番の入門＋実践書がこちらです。

Swift実践入門をAmazonで見る

※ Amazon広告リンク

7. 処理の目的ごとに命名パターンを変えよう

次のような処理の種類に応じて、適切な命名パターンを使うのもポイントです。

取得系 → get、fetch、load
変更系 → set、update、change
判定系 → is、has、can
処理系 → process、execute、perform

こうしたパターンを意識することで、関数を見ただけでその役割が理解できるようになります。

Windowsで始めるiPhoneアプリ開発入門｜Swiftの基本と仕組みを1時間で攻略

「iPhoneアプリを作りたいけれど、Macを持っていないから諦めている」そんな方のための画期的な入門講座です。実は、プログラミングの本質を学ぶのに高価な機材は必要ありません。本講座では、Windowsパソコンを使用し、クラウド環境を活用してAppleの最新言語Swift（スウィフト）の基礎を最短距離でマスターします。