コードエディタ

コードエディタの使い方を学びます。


Author:Pedro LimaLast revision:2024/12/18

Arduino Lab for MicroPythonには、簡単にMicroPythonのコードを書き、整形し、実行するための、使いやすいコードエディタを含んでいます。この記事では、コードエディタの仕組み、MicroPythonで重要なフォーマット規則、コードをきれいでエラーのない状態にするためのいくつかのコツを示します。

要件

  • Arduino Lab for MicroPython
  • MicroPythonが利用できるArduinoボード(エディタを使うだけであれば不要ですが、コードを実行するのに必要です)
i
Arduino Lab for MicroPythonは、Arduino Cloudで、オンラインでも利用可能です。

Arduino Lab for MicroPython

Arduino Labのコードエディタは、コーディングを効率化するように設計されていて、以下のツールを提供します。

  • MicroPythonコードの記述とフォーマット
  • インデントの容易な確認と管理
  • REPLでのコード実行と結果の直接確認

エディタに慣れてくれば、MicroPythonが、他の言語とは異なるいくつかの文法があることを覚えてください。

概要

  1. ボードの接続・切断: MicroPythonが利用できるArduinoボードの接続・切断に使います。ボードでコードの実行・テストできるよう、エディタと通信できるようにします。
  2. スクリプトの実行・停止: スクリプトを実行・停止します。出力はREPLに表示され、フィードバックやエラーメッセージが即座に表示されます。
  3. ファイル管理: MicroPythonボード上のファイルを管理できます。スクリプトをアップロード、ダウンロード、管理ができます。
  4. スクリプトの編集: MicroPythonコードを書いたり修正したりするエディタのメインエリアです。
  5. 端末の拡大: 端末部分の拡大・折り畳みを行います。端末では、REPLの出力を表示し、コードのデバグや操作をリアルタイムに実現します。

ファイル

Arduino Lab for MicroPythonのファイル管理は直感的で、効率的な構成やボードとPC間での転送が可能です。

  1. ボードストレージ: MicroPythonが利用できるArduinoボードに格納されたファイルが表示されます。ボード上に保存されているスクリプトやデータの閲覧・管理が可能です。
  2. PCストレージ: PC上のファイルが表示されます。アップロード・ダウンロードするファイルの選択・管理が可能です。
  3. ファイルのダウンロード・アップロード: PCとボード間でのファイル転送に使います。新しいスクリプトのアップロードや、ボードからデータログのダウンロードができます。
  4. ファイル・フォルダの作成: ボードやプロジェクトディレクトリに、ファイルやフォルダを直接作成することができます。これにより、コードやファイルを簡単に整理できます。
i
ファイルシステムの詳細なチュートリアルは、ファイルシステムのチュートリアルを参照してください。

REPL

REPLは、端末を拡大すると表示されます。ここで端末を操作可能です。ボタンは、基本機能である、コピー・ペーストが実行できます。このウインドウでは、CTRL+Cはききません。

i
REPLの詳細なチュートリアルは、REPLのチュートリアルを参照してください。

コードエディタ

インデント

MicroPythonでは、インデント(スペースやタブを使います)は、コードの構造を定義する基本です。他の多くの言語とは異なり、MicroPythonでは、コードブロックの定義に{}のような記号ではなく、インデントを使います。

  • 一貫性のあるインデント: 典型的には、各コードブロック(関数やループ、条件の内側など)はスペース4つでインデントします。同じブロックの全ての行は、同じ数のスペースでインデントしてください。
  • ネストしたブロック: ネストしたコードでは、単純にスペース4つかタブを追加で挿入してください。

正しいインデントの例

1
2
3
4
5
def greet(name):
    if name:
        print(f"Hello, {name}!")
    else:
        print("Hello, world!")

この例では、コードのインデントレベルが、どの行がどのブロックに属するかを定義しています。print文は、ifelse文の下に揃って、それらのブロックに属することを示しています。

よくあるインデントの間違いを避ける

  • タブとスペースを混ぜる: スペースかタブを一貫して使ってください。混ぜるとインデントエラーが発生するかもしれません。一貫性を保ちやすいので、一般にはタブの方が好まれています。
  • インデントがない: ブロック内の全ての行(if文の中の行など)は、正しくインデントする必要があります。そうでない場合は、シンタックスエラーが発生します。

コメント: インラインと複数行

コードの理解を助けたり、複雑なロジックを文書化するのに、コメントは不可欠です。MicroPythonでは、

  • インラインコメント: シングルラインコメントは#を使います。#記号の後ろにあるものは全て、インタープリタにより無視されます。
1
print("Hello, world!")  # This prints a greeting
  • 複数行コメント: MicroPythonには、専用の複数行コメントがありません。回避策として、複数行コメントと同じ効果を得るために、複数のインラインコメントを使ったり、3つの引用符(""" ... """)を使った複数行の文字列を使います。
1
2
3
4
5
6
7
8
# This is a comment
# that spans multiple lines.

"""
Alternatively, we can use
triple quotes to comment on
multiple lines.
"""

効果的にコメントを使うと、コードの目的やロジックがわかりやすくなります。

MicroPythonの文法: セミコロン不要

MicroPythonでは、各行の終わりで自動的に文は終わります。このため、C++やJavaのような言語とは異なり、セミコロン(;)は不要です。コードが簡潔でわかりやすく、読みやすくなります。

1
2
3
4
5
6
7
# In C++: 
# int a = 5; 
# int b = 10;

# In MicroPython:
a = 5
b = 10

しかし、2つのコマンドを1行に書きたいときは、セミコロンを使うことができます。

1
a = 5; b = 10

しかし、コードが読みにくくなるので、一般にはこれは推奨されません。

コードの実行とコンパイル

MicroPythonでは、従来のArduinoのスケッチとは異なり、コードはコンパイルしません。その代わり、コードは1行ごとに解釈されます。このため、MicroPythonは対話型で、迅速なテストや開発を柔軟に実行できます。

  • コードの記述: 通常通りエディタにコードを書きます。
  • コードの実行: コードを実行するとき、Arduino Lab for MicroPythonは、コードをREPLに送ります。REPLは各行を読んで、すぐにに実行します。
  • 結果の確認: 出力(あるいはエラー)は、すぐに表示されます。これにより、コードのテストを迅速に実施でき、すぐにフィードバックが得られます。

エディタ利用のベストプラクティス

コードエディタを有効に使うためのコツをいくつか紹介します。

  • 説明的な名前を使う: コードを読みやすくするために、変数や関数には、それらを明確に説明する名前をつけてください。
  • モジュール化する: 維持管理を簡単にするために、複雑なコードは関数に分割してください。
  • コメントを残す: なぜそのコードを書いたのかがわかる、役に立つコメントを残してください。
  • インデントに注意する: きれいでエラーのないコードを書くために、インデントに注意を払ってください。

オリジナルのページ

https://docs.arduino.cc/micropython/environment/code-editor/

最終更新日

August 16, 2026

inserted by FC2 system