はじめに
自分は常にpyhonを触っているというわけではありません。VS Codeも、必要に応じて起動する程度です。
で、困るのは、しばらく時間をあけてから、あらためてPython（VS Code）を引っ張りだしたとき、
「あれ？ どこから手をつければいいんだっけ？」
と、立ち往生してしまうことです。
さくさく用事を片付けてしまいたいだけなのに、毎回、これでは困ります。
この記事は、そんなときのためのメモになります。
環境
- Mac OSX
- VSCode(Visual Studio Code)
- python3
初期設定
VS codeもpythonもインストール済。各種設定も済んでいるという想定ですが、このあたりについては、以下のサイトを参考にしました。
- Python3の導入
- Macにはpython2系がインストールされていますが、python3を使いたい場合は、homebrewを使うのがお手軽です。
MacにPython3をインストールし環境構築【決定版】
- VS Codeの導入
- VS Codeに導入には、こちらのサイトを参考にしました（Windows10、OSX対応）。
Visual Studio Codeから「Hello Python」してみよう
- プラグイン
- 拡張機能が豊富なところも、VS Codeの嬉しいところです。
【2021年決定版】VSCodeをPython超特化型にする、最高の拡張機能20選まとめ。
まあ日本語化はやっておくとして、自分が入れたものは、下の二つです。
・indent-rainbow（インデントを視覚的にわかりやすく表示）
・ZenKaku（全角スペースをグレー表示）
配色テーマとしては、
GitHub Theme
を使っています。
さて、何からやるんだっけ……
VS Codeはワークスペースが基本です。
まずは、ワークスペースに指定するための、フォルダを作りましょう。
フォルダはVS Code外で、普通にファインダー（エクスプローラー）から作成します。
ここでは、firststepというフォルダを作成しました。
いよいよVS Code
ここで、ようやくVS Codeを起動します。
すでにワークスペースが開いている場合は（半年前につくった何か、とか）、【ファイル】→【ワークスペースを閉じる】で、閉じておきます。
そして、新しくワークスペースを作成します。
ワークスペースを作成するには、【ファイル】→【フォルダをワークスペースに追加】で、先ほど作成したフォルダを指定します。（フォルダをウィンドウにドラック&ドロップしてもよし）
すると、下図のような警告がでますが、今の場合、「はい、作成者を信頼します」一択ですよね。
さて、どうやらワークスペースはできたようですが、「未設定（ワークスペース）」の「未設定」という表示が、不安を煽ります。
【ファイル】→【名前をつけてワークスペースを保存】で、ワークスペースを保存しておきましょう。
保存ファイル名は、.code-workspaceは残して、firststep.code-workspaceとしました。
firststep.code-workspaceというファイルが、自動的に作成されましたね。
中身を見ればとピンとくると思いますが、このワークスペース専用の設定を記述するところですので、必要に応じて使っていきまます。
とりあえずは何もしなくて大丈夫です。
ワークスペースはできたぞ。さあ、コードを書き始めよう
と、腕をまくったところで、
「あれ？ Pythonって確か、ちょっとしたお作法がなかったっけ？」
そう、Pythonでは、c言語でいうところのヘッダファイルのように、使用する関数名等をあらかじめ定義しておくという仕組みがありません。
自作のメソッドやクラスは、使用する前に記述しなければならないので、肝腎の主処理の記述が下へ下へと、どんどん下がってしまいます。
それを回避するために、「実行ファイルかどうかを確認して、メイン関数に飛ばす」みたいな書き方が定石となっているのでした。
こんなテンプレートを用意しておき、コピペで使うことにしましょう。
def main():
"""
エントリポイント
"""
print('Hello Saitama!')
hoge()
def hoge():
return True
if __name__ == "__main__":
main()
このテンプレートは本当に最小限なものなので、それっぽいものが欲しいときは、以下のエントリーが参考になります。まあ、ちょこっと試すくらいなら、上記で大丈夫でしょう。
それでは、１つ目のファイルの作成です。
【ファイル】→【新規ファイル】で新規ファイルを作成します。言語を選択します。という表示がでるので、クリック。もちろんPythonを選びます。
ファイルを保存しておきましょう。【ファイル】→【名前をつけて保存】で、「firststep」というファイル名にしました。
白紙の画面に、さきほどのソースコードをペタリと貼り付ければ、完成です。
さあ、サクサクとコードを書いて、退勤時間までに帰りましょう！
