VS CodeでPythonを始める方法|環境構築・実行手順とアルゴリズムの基礎
プログラミングを始めようとVS Codeを入れたものの、「どこにコードを書けばよいのか」「実行ボタンを押しても動かない」と迷うことがあります。最初は、コードを書く道具と、コードを実行する仕組みを分けて理解すると、確認する場所が分かりやすくなります。
この記事では、パソコンにインストールしたVS Codeを使い、Pythonのプログラムを保存・実行するまでを紹介します。その後、素数判定の小さなプログラムを動かしながら、条件分岐や繰り返し、アルゴリズムの考え方を確認します。
目次
1.VS Code・拡張機能・Python本体の役割を知る
Visual Studio Code(VS Code)は、Microsoftが提供するコードエディターです。ファイルの編集や整理を行い、拡張機能を追加することで、使う言語に応じた入力支援や実行操作を利用できます。
Pythonのコードを実行するには、VS Codeと拡張機能に加えて、Python本体が必要です。Python拡張機能をインストールするだけで、Python本体まで導入されるわけではありません。
| 用意するもの | 主な役割 |
|---|---|
| VS Code | コードを書く、ファイルを保存する、作業フォルダーを管理する |
| Python拡張機能 | Pythonの入力補完や実行、デバッグなどを支援する |
| Python本体 | 書いたPythonプログラムを実行する |
この記事では、追加の外部ライブラリを使わないPython 3のプログラムを扱います。まずは一つのファイルを実行できるところまで進め、その後に必要な機能を増やしましょう。
2.VS CodeとPythonを準備する
VS Codeをインストールする
VS Codeの公式サイトから、使用するOSに対応したものをダウンロードしてインストールします。ここでは、ブラウザー版ではなく、パソコンにインストールするデスクトップ版を使います。
日本語のメニューを使いたい場合は、拡張機能画面で「Japanese Language Pack for Visual Studio Code」を探し、Microsoftが提供するものを追加してください。画面の案内に従って再起動すると、表示言語を変更できます。
Python 3をインストールする
Pythonの公式ダウンロードページや、OSに対応した公式案内を確認してPython 3を導入します。学校や職場のパソコンでは、すでに用意された環境がないかも確認してください。
インストール後は、ターミナルやコマンドプロンプトでバージョンを確認します。ターミナルは、文字で指示を入力し、プログラムの実行結果などを確認するための画面です。
| 環境 | 確認コマンドの例 | 確認できること |
|---|---|---|
| Windows | py -3 –version | Python 3のバージョンが表示されるか |
| macOS・Linux | python3 –version | Python 3のバージョンが表示されるか |
コマンドが見つからない場合は、Pythonの導入状態や、インストール方法に対応した起動コマンドを確認します。インストール後に開き直していないターミナルでは、設定変更が反映されていない場合もあります。
MicrosoftのPython拡張機能を追加する
VS Codeの拡張機能画面で「Python」を検索し、Microsoftが提供する拡張機能をインストールします。同じような名前の拡張機能もあるため、提供元を確認してください。
今回の練習では、コードを実行するために多数の拡張機能をそろえる必要はありません。整形や追加の開発支援は、必要になった段階で導入できます。
3.作業フォルダーを開き、Pythonの実行環境を選ぶ
パソコン上に「python-practice」などの作業用フォルダーを作成し、VS Codeの「ファイル」から「フォルダーを開く」を選びます。関連するファイルを同じ場所にまとめると、保存場所を確認しやすくなります。
フォルダーの信頼を確認する画面が出た場合は、内容と入手元を確認して判断してください。自分で作った練習用フォルダーと、内容を確認していないダウンロード済みのプロジェクトは、分けて扱いましょう。
「Python: Select Interpreter」でPythonを選ぶ
VS Codeのコマンドパレットを開き、「Python: Select Interpreter」を実行します。コマンドパレットは、Windows・LinuxではCtrl+Shift+P、macOSではCommand+Shift+Pで開けます。
表示された候補から、今回使うPython 3を選択してください。複数のPythonが入っている場合は、バージョンや保存場所を確認します。ここで選ぶインタープリターが、Pythonコードの実行に使われます。
候補が表示されない場合は、Python本体と拡張機能の導入状態を確認し、VS Codeを開き直してみてください。選択できる環境があるかを確認してから、コードの作成へ進みます。
4.最初のファイルを保存して実行する
VS Codeのエクスプローラーで新しいファイルを作り、「hello.py」という名前で保存します。末尾の「.py」は、Pythonのソースコードファイルであることを示す拡張子です。
次の1行を入力して保存してください。引用符や括弧は、コード内と同じ半角の記号を使います。
ファイルを開いた状態で、右上の「Run Python File in Terminal」を選びます。表示が分かりにくい場合は、エディター内で右クリックし、Pythonファイルをターミナルで実行する項目を選んでください。
ターミナルに「こんにちは、Python!」と表示されれば、このファイルを実行できています。次に文章を変更し、保存して再実行し、表示が変わることも確認しましょう。
書く・保存する・実行する・結果を見るという流れが、以降の練習でも基本になります。表示が変わらない場合は、実行しているファイル名と保存状態を確認してください。
5.アルゴリズムは、入力から答えを得るための手順
アルゴリズムとは、問題を解くための具体的な手順です。コードを書く前に、何を受け取り、どの順番で調べ、どの条件で答えを出すかを言葉にしてみましょう。
ここでは、「入力された整数が素数かどうかを判定する」という問題を考えます。素数は、2以上の整数のうち、正の約数が1と自分自身だけの数です。1や0、負の整数は素数ではありません。
素数判定の手順を考える
- 入力された整数が2未満なら、素数ではないと判定する。
- 2から順に、割り切れる整数があるか調べる。
- 割り切れる整数が見つかったら、素数ではないと判定する。
- 必要な範囲を調べても見つからなければ、素数と判定する。
例えば、21は3で割り切れるので素数ではありません。一方、17は2、3、4のいずれでも割り切れず、素数と判定できます。
なぜ平方根まで調べればよいのか
2以上の整数が素数でない場合、1より大きい2つの整数の積で表せます。その2つが両方とも元の数の平方根より大きければ、積が元の数を超えてしまいます。そのため、少なくとも一方は平方根以下です。
この性質を使うと、割る数を元の数の平方根まで調べれば十分です。次のコードでは平方根を直接計算せず、「割る数×割る数が入力値以下」という条件で繰り返します。
6.素数判定プログラムを動かす
同じ作業フォルダーに「prime_check.py」を作り、次のコードを保存してください。行頭の空白もコードの構造を表すため、字下げを保ったまま入力します。
「prime_check.py」を開いてターミナルで実行します。「整数を入力してください:」と表示されたら、ターミナルをクリックし、17などを入力してEnterキーを押してください。
このプログラムは、1回の入力を判定したら終了します。別の値を試すときは、もう一度実行してください。最初は、手で確認できる小さな整数を使いましょう。
コードの役割を確認する
| コードの部分 | 役割 |
|---|---|
| def is_prime(n): | 整数nの素数判定を行う関数を定義する |
| if n < 2: | 2未満の整数を先に除外する |
| while divisor * divisor <= n: | 割る数が必要な範囲にある間、処理を繰り返す |
| n % divisor == 0 | 割った余りが0、つまり割り切れるかを調べる |
| divisor += 1 | 次に調べる割る数を1増やす |
| return True / return False | 判定結果を返し、関数の処理を終了する |
| int(input(…)) | 入力された文字列を整数へ変換する |
| except ValueError: | 入力を整数に変換できなかった場合に案内を表示する |
特に「<=」の等号を外さないことが大切です。25なら5、49なら7も確認する必要があるため、平方根と等しい割る数まで調べます。
答えを予想してから、複数の入力で確認する
17だけで正しく動いても、ほかの入力で正しいとは限りません。素数以外の数や、境界になる値、整数として扱えない入力も試してください。
| 入力例 | 期待する結果 | 確認すること |
|---|---|---|
| -3、0、1 | 素数ではない | 2未満を除外できるか |
| 2、3 | 素数 | 小さい素数を正しく判定できるか |
| 4、9、25、49 | 素数ではない | 平方数を正しく判定できるか |
| 97 | 素数 | 繰り返しの終了後に正しく判定できるか |
| abc、2.5、空欄 | 整数で入力するよう案内する | 整数に変換できない入力を扱えるか |
この方法は、小さな整数で処理の仕組みを学ぶための例です。非常に大きな整数では確認回数が増えるため、あらゆる用途で高速な素数判定法というわけではありません。
7.探索アルゴリズムでは、速さと前提条件を見る
アルゴリズムの違いを考える別の例として、データの探索があります。先頭から順に確認する線形探索と、範囲を半分ずつ絞る二分探索では、必要な確認の仕方が異なります。
ただし、一般的な二分探索で値を探すには、データが比較に使う順序で整列していることが必要です。順番がばらばらのデータに、そのまま適用することはできません。
| 方法 | 調べ方 | 主な前提・注意点 |
|---|---|---|
| 線形探索 | 先頭から順に値を確認する | 整列されていないデータにも使える。最悪の場合はすべて確認する |
| 二分探索 | 中央の値と比べ、調べる範囲を半分ずつ狭める | 整列済みのデータを使う。整列の準備やデータへのアクセス方法も考える |
例えば「2、5、8、12、16、23、38」から23を探すなら、中央の12と比較して右側へ進めます。次に右側の中央である23を確認すれば、見つかります。
一方、一度だけ探すために未整列のデータを並べ替える場合は、その準備にも処理が必要です。方法を選ぶときは、探索だけでなく、準備と実行を合わせて考えましょう。
8.動かないときは、問題を分けて調べる
実行できない原因には、環境の設定、保存場所、文法、処理の考え方などがあります。すぐにすべてを入れ直すのではなく、どの段階で止まっているかを確認してください。
| 状況 | 最初に確認すること |
|---|---|
| Pythonが見つからない | Python本体の導入状態と、選択したインタープリター |
| 実行する項目が見つからない | Python拡張機能、ファイルの拡張子、フォルダーの制限状態 |
| SyntaxErrorが出る | 指定された行付近の記号、括弧、引用符、コロン |
| IndentationErrorが出る | 行頭の空白と、字下げのそろい方 |
| 入力待ちのまま進まない | ターミナルに入力してEnterキーを押したか |
| 変更前の結果が出る | 保存したか、別のファイルを実行していないか |
| 終了するが答えが違う | 条件式、繰り返しの範囲、変数の変化 |
エラーメッセージは、種類、ファイル名、行番号を手掛かりに読みます。ただし、表示された行より前の括弧の閉じ忘れなどが原因の場合もあるため、周辺も確認しましょう。
AIには、結果と再現条件を渡す
AIに質問するときは、期待する動作、実際の動作、入力した値、エラーメッセージ、関連コードをまとめます。「動きません」だけより、原因を絞る材料が増えます。
例えば「49が素数と表示されます。49は7で割り切れるので素数ではないはずです。繰り返し条件を確認してください」と伝えます。修正案を受け取った後は、49だけでなく、2や97なども再確認してください。
AIの説明や修正案を学習につなげるには、コードを読み、変更し、実行結果を確かめることが大切です。初心者が身につけたい基礎と学び方を整理しています。
AI時代もプログラミング学習は必要?初心者が身につけたい基礎と学び方 記事を読む →9.動いた後は、一つずつ変更して確かめる
最初のプログラムが動いたら、機能を一つだけ変更してみましょう。変更する前に、どの入力で何が表示されるべきかを決めておくと、成功したかどうかを判断できます。
- 素数かどうかに加え、素数でない場合は見つかった約数も表示する。
- 1から100までの素数を一覧表示する。
- 終了用の入力が来るまで、繰り返し判定できるようにする。
変更前のコードを残しておけば、うまく動かなくなったときに比較できます。一度に複数の機能を追加せず、変更と確認を繰り返してください。
画面付きのアプリを作りたい場合は、入力欄やボタン、結果表示なども必要になります。今回の判定処理を理解したうえで、画面と処理をつなぐ学習へ進めます。
小さなプログラムから、画面のあるアプリ作成へ進みたい方へ。AIを使いながら、機能を決め、動作を確認し、公開まで進める学習手順を紹介しています。
プログラミング未経験から始めるAI開発|環境構築・アプリ作成・公開の学習手順 記事を読む →10.よくある質問
最初から仮想環境を作る必要はありますか?
今回のように外部ライブラリを追加しない短いプログラムは、導入したPython 3で実行できます。ライブラリを使う開発へ進む際は、プロジェクトごとに必要なパッケージを分けるため、仮想環境の使い方も学びましょう。
数学が得意でないと、プログラミングは難しいですか?
必要な数学は作るものによって異なります。今回の素数判定では、整数、割り算の余り、約数などを使います。分からない概念を小さな数で確かめながら、処理の手順と結び付けて考えてください。
VS Codeは、コードの誤りをすべて見つけてくれますか?
すべてではありません。入力支援や診断機能で見つかる問題がある一方、実行しても終了するが答えが違う、といった処理上の誤りもあります。期待する結果を用意し、複数の入力で確かめることが必要です。
11.まずは保存・実行・確認を一通り経験する
プログラミングの学習では、道具をそろえることに加え、入力に対して何が起こるかを確認することが大切です。VS Code、Python拡張機能、Python本体の役割を整理し、まずは短いファイルを実行してみましょう。
その後、素数判定のような小さな処理で、条件と繰り返しの意味を確かめます。答えを予想し、実行し、違いがあれば調べるという経験を、一つずつ積み重ねてください。
参考資料
- Microsoft:Visual Studio Codeの入門ガイド
- Microsoft:Getting Started with Python in VS Code
- Microsoft:Running Python code in Visual Studio Code
- Microsoft:Python environments in VS Code
- Python公式:ダウンロード
- Python公式:制御構造ツール
- Python公式:bisect — 配列二分法アルゴリズム
Learning Tools
記事を検索したい方はここから!
記事を検索
関連記事や、今の内容に近いテーマをすぐに検索できます。
例: AI / 情報Ⅰ / Python / 統計 / 資格 / 学習法