VSCodeとは？

マイクロソフトが開発したソースコードエディタ「Visual Studio Code」の略です。
無料・軽量・多機能の三拍子揃ったエディタとして、急速に支持を広げているそうです。

2019/10版より、RaspberryPi（ARM v8）へのSSH接続機能が公式サポートされたので、
RaspberryPi内のPythonコード遠隔編集を試した結果を記事にしました。

結論から言うと、ブレークポイント付きのデバッグが実現できたりと、快適な遠隔開発環境を実現できました！

※SSHでなく直接RaspberryPiでVSCodeを使用したいとき

2021/4に、VSCodeがRaspberryPi OSに正式対応しました。こちらの記事が参考になるかと思います

必要なもの

・RaspberryPi (本例ではRaspberryPi3 ModelB)
・上記と同じネットワークにつながったPC (本例ではWindows10)
・Visual Studio Code 1.39.2以降（上記PCにインストール、本例では1.44.2使用）

手順

下記記事を参考にさせて頂きました
https://qiita.com/hukatama024e/items/9f96730381f0a34c6da6

①SSH接続の設定と、configファイルの保存

本記事「公開鍵認証の場合」を参考に、SSH公開鍵認証の確立とconfigファイルの保存を実施してください。

なお、configファイルはPC内の下記フォルダに保存してください
C:\Users\[ユーザー名]\.ssh

②VSCodeのインストール

PC側にVSCodeをインストールしてください

参考記事
https://qiita.com/psychoroid/items/7d85ae6bade4a67aedb1

③Remote Developmentのインストール

VSCodeを起動し、下記の手順でRemote Developmentをインストールしてください

※Remote - SSHなど必要な関連ツールも、Remote Developmentをインストールすると同時にインストールされます。

④RaspberryPiに接続

下図の手順で、接続するSSHサーバ = RaspberryPiを選んでください（下図の場合「raspi」）

新たにウインドウが開き、プラットフォーム選択を求められるので、Linuxを選ぶ

公開鍵認証のパスワードを求められるので、入力してEnterを押す

初回接続は時間が掛かるので、しばらく待つ。
成功すると、下図の赤枠をクリックしてRaspberryPi内のファイルにアクセスできる

⑤RaspberryPi内にコードを作成

ここから先はコンソールでも良いですが、GUIで操作する前提で記載を進めます。

・空ファイルの作成
「File」→「New File」で空のファイルを作成します

・コード内容の記載
例えば、以下のようなPythonコードを記載します（numpyで標準偏差を求めて表示）

・コードの保存
「File」→「SaveAs」→保存パスを指定→「OK」

・コンソールから実行してみる
「Terminal」→「New Terminal」でコンソールを開き

コードのあるフォルダに移動し、

python3 test.py

でPythonコードを実行

正常に結果がコンソール出力されていることが分かります。

⑥作成したコードをデバッグ実行

なんとVSCodeのGUIで、コードのデバッグまで出来てしまいます。
ブレークポイントで停止もできるので、開発効率が上がること間違いなしです！

・Pythonリンターのインストール
既にPCローカルでインストールしている場合も、「install in SSH:[ホスト名]」をクリックしてRaspberry Pi内にもPythonリンタをインストールします。

インストールが終わると「Reload Required」と出てくるので、クリックして再起動

・作業用フォルダ（通常はコードのあるフォルダ）を開く

・デバッグの実行
デバッグしたいコードを開いたのち、下記の操作を実行

コンソールが開き、デバッグが実行されます

・ブレークポイントの動作確認
下図のようにブレークポイントで処理を止め、変数内容の確認も可能です。

以上で、VSCodeでRaspberryPi内のコードを遠隔デバッグすることができました。
GUIでサクサク開発できる環境が整い、個人的には満足の結果です！

追記：pipでインストールしたライブラリのimport時にエラーが出るとき

RaspberryPi側にpyenvで環境構築した場合、
pipでインストールしたライブラリのimport時に下記エラーが出ます。

エラー内容：Unable to import 'bluepy' pylint(import-error)

原因

こちらに記載されているように、
VSCodeでデバッグ時に参照するPythonと、pyenvのPythonの場所が違うことが原因と思われます

対処法

/home/[ユーザ名]/.vscode-server/extensions/ms-python.python-‥/pythonFiles/.vscode
にある
settings.json
を開き、下記最後の1行を追加

{
    //
    //元々の記載
    //
    "python.pythonPath": "[pyenvのPythonの場所]"
}

※pyenvのPythonの場所は、デフォルトでは
/home/[ユーザ名]/.pyenv/shims/python
のはずです
※既にpython.pythonPathが記載されていた場合、コメントアウトして新たに1行追加してください

それでもエラーが出る場合

⑥で開いた作業用フォルダ内に「.vscode」フォルダを作り、
フォルダ内に下記settings.jsonファイルを作成

{
    "python.pythonPath": "[pyenvのPythonの場所]"
}

これで強制的にpyenvのPythonが実行されるはずです