【Grok3】AnacondaとVS Codeで始めるPython開発環境の構築ガイド

環境整備
2025.06.07

Python開発を効率的かつ整理して進めるために、Anacondaと**Visual Studio Code（VS Code）**を使った開発環境の設定方法を解説します。このガイドでは、path、仮想環境、condaをキーワードに、Anacondaの基本環境（base）とプロジェクトごとの仮想環境の使い分けを軸に、初心者から上級者まで使える実践的なワークフローを紹介します。さらに、VS Codeでコマンドプロンプトを標準ターミナルに設定する方法も追加。ブログ風に、わかりやすくステップをまとめましたので、ぜひ参考にしてください！

  1. なぜAnacondaと仮想環境を使うのか？
    1. base環境と開発用仮想環境のメリット
  2. 環境構築の手順
    1. 1. Anacondaのインストールと初期設定
    2. 2. 仮想環境の作成
    3. 3. 仮想環境の有効化
    4. 4. VS Codeの設定
    5. 5. 作業の終了
    6. 6. 環境の管理と共有
  3. 実践的なワークフロー
  4. 追加のTips
  5. まとめ
    1. 使われる手法2：スクリプト側でcertifiをわかりやすくできる
    2. 🔧 修正コード例（OpenAI API使用時）
    3. 🔄さらにやるべきこと（念のため）
      1. 1.Conda環境のcertifi更新
      2. 2.python -m sslで確認
    4. 🧪被害被害な時の緊急回避（非推奨）
    5. まとめ
  6. ❌ 問題1：SSL証明書エラー
  7. ✅ 対策1：certifiを知らない指定するだけでは許容できないケースあり
    1. 🔧試して追加ほしい対策（確実に効果的な方法）
  8. ✅ 対策2：AnacondaにバンドルされているInstall Certificatesスクリプトを実行する（Windows）
    1. 📌手順
    2. 🔥最終回避策（非推奨ですが一時的には効果的）
  9. ❌ 問題2：traceback.print_exception()に引数が足りない
    1. ✅正しい使い方：
  10. ✅全体の修正まとめ
    1. 🔁 1. SSL回避（開発中のみ）
    2. ✅ 2. トレースバックの修正
  11. 根本的な対処法：Windows + Anaconda 環境にルート証明書を正しく認識させる
    1. 🔧対処ステップ（100％安全な解決法）
    2. ✅ 手順①：Anaconda プロンプトを起動する
    3. ✅ 手順②：Install Certificatesスクリプトを実行（Python付属）
    4. ✅ 手順③：SSL_CERT_FILEをわかりやすく指定（必要な場合）
    5. ✅はっきり：Requestsやがhttpx使う証明書がOSに依存することもある
  12. 🔥 最終手段：Windows 全体に証明書をインポート（上級者向け）
    1. 1.このリンク先からをcacert.pemダウンロード
    2. 2. 任意の場所に保存（例：C:\certs\cacert.pem）
    3. 3. 環境変数を設定：
  13. ✅ 確認コマンド（SSL通信チェック）
  14. 📌 結論

なぜAnacondaと仮想環境を使うのか？

Anacondaは、Pythonのパッケージ管理や仮想環境を簡単に扱えるツールです。プロジェクトごとに独立した環境を作ることで、ライブラリのバージョン衝突を防ぎ、開発環境をクリーンに保てます。一方、VS Codeは軽量かつカスタマイズ性の高いエディタで、Anacondaとの相性が抜群。base環境と開発用仮想環境をうまく使い分けることで、プロジェクトの再現性や管理が飛躍的に向上します。

base環境と開発用仮想環境のメリット

項目base環境開発用仮想環境（例: myenv）
役割conda自身の更新・管理用プロジェクトごとの作業用
生成Anacondaインストール時に自動作成conda create -n myenv python=3.11などで作成
有効化conda activate base（Anacondaプロンプトでは自動）conda activate myenv
VS Codeの設定通訳として「Python 3.11 (base)」を選択通訳として「Python 3.11 (myenv)」を選択
パッケージ最小限に（軽量維持）conda install … や pip install … で必要に応じて
共有・再現基本的にはしないconda env export > env.yml で環境を共有
  • base環境：Anaconda自体の管理に特化。軽量に保ち、プロジェクト用のパッケージはインストールしないのがベスト。
  • 開発用仮想環境：プロジェクトごとに独立させ、ライブラリやバージョンをカスタマイズ。チームでの共有や再現が容易。

環境構築の手順

以下は、AnacondaとVS Codeを使った開発環境の構築と運用ワークフローです。シンプルかつ実践的な手順をまとめました。

1. Anacondaのインストールと初期設定

  1. Anacondaのインストール
    Anacondaの公式サイトからインストーラーをダウンロードし、指示に従ってインストールします。インストール時に「Add Anaconda to my PATH environment variable」のチェックは外すことを推奨（システムPATHを汚さないため）。代わりに、Anacondaプロンプトやターミナルでcondaコマンドを利用します。
  2. PATHの確認
    Anacondaが正しくインストールされたか確認するには、ターミナルで以下を実行： conda --version バージョンが表示されればOK。表示されない場合は、Anacondaのインストールディレクトリ（例: ~/anaconda3/bin）がPATHに追加されているか確認してください。
  3. condaの初期化
    ターミナルでcondaを有効化するには： conda init これでbashやzshなどのシェルでcondaコマンドが使えるようになります。ターミナルを再起動すると、(base)環境が自動で有効化されます。

2. 仮想環境の作成

プロジェクトごとに仮想環境を作成して、依存関係を整理します。たとえば、Python 3.11を使った仮想環境myenvを作成する場合：

conda create -n myenv python=3.11

このコマンドで、指定したPythonバージョンの新しい仮想環境が作られます。

3. 仮想環境の有効化

作成した仮想環境を有効化します：

conda activate myenv

ターミナルに(myenv)と表示されれば成功。base環境から切り替わります。
日本語ワンフレーズ：「基本環境から切り替えます conda activate myenv。」（myenvの綴りに注意！）

4. VS Codeの設定

VS Codeで仮想環境を利用するには、以下の手順で設定します：

  1. Python拡張機能をインストール
    VS Codeの拡張機能マーケットプレイスから「Python」拡張機能をインストールします（Microsoft提供）。
  2. インタプリタの選択
    • ターミナルで(myenv)を有効にした状態でVS Codeを開くと、自動で「Python 3.11 (myenv)」が選択される場合があります。
    • 手動で選択する場合は：Ctrl + Shift + P → 「Python: Select Interpreter」を選択 → 「Python 3.11 (myenv)」を選択。
    • VS Codeの最下部ステータスバーに「myenv」が表示されていれば設定完了。
  3. パッケージのインストール
    仮想環境内で必要なライブラリをインストールします。たとえば、numpyをインストールする場合： conda install numpy または、pipを使用： pip install numpy base環境には極力パッケージをインストールせず、仮想環境で管理しましょう。
  4. VS Codeのターミナルをコマンドプロンプトに設定
    Windows環境では、PowerShellでPythonやcondaが正しく動作しない場合があります（特にPATHや環境変数の問題で）。そのため、**コマンドプロンプト（cmd）**をVS Codeの標準ターミナルに設定することを推奨します。以下の手順で設定します：
    • VS Codeを開き、Ctrl + ,（カンマ）で設定を開く。
    • 検索バーに「terminal default profile」と入力。
    • 「Terminal: Select Default Profile」を選択し、「Command Prompt」を選択。
    • または、設定JSONに直接以下を追加："terminal.integrated.defaultProfile.windows": "Command Prompt"
    • これでVS Codeのターミナルがコマンドプロンプトになり、condaコマンドやPythonの実行が安定します。ターミナルでconda activate myenvを実行して、仮想環境を有効化してください。

5. 作業の終了

作業が終わったら、仮想環境から抜けます：

conda deactivate

これで(base)環境に戻ります。base環境が出ていないターミナルでも、直接conda activate myenvで仮想環境に入れます。

6. 環境の管理と共有

  • 環境一覧の確認
    現在使える仮想環境を確認するには： conda env list base環境や作成した仮想環境（例: myenv）がリストに表示されます。
  • 環境の共有
    プロジェクトの環境を他の人と共有したい場合、仮想環境をエクスポート： conda env export > env.yml 他の人は以下のコマンドで同じ環境を再現できます： conda env create -f env.yml
  • 不要な環境の削除
    使わなくなった仮想環境は以下で削除： conda remove -n myenv --all

実践的なワークフロー

以下は、日常的な開発の流れをまとめたものです。珍しいのは3行だけ！

# ① 環境作成
conda create -n myenv python=3.11

# ② 作業開始
conda activate myenv    # ← (myenv) に変わる

# ③ 終了
conda deactivate        # ← (base) に戻る

追加のTips

  • condaとpipの使い分け
    condaでインストール可能なパッケージはcondaを優先（依存関係の管理が強い）。condaにない場合はpipを使用。ただし、混在させると依存関係が壊れる可能性があるので注意。
  • VS Codeのターミナル設定の確認
    コマンドプロンプトを標準に設定した後、ターミナルでconda --versionやpython --versionを試して動作を確認してください。PowerShellでの不具合（例: conda activateがエラーになる）が解消されます。
  • Anacondaの更新
    base環境でAnaconda自体を最新に保つには： conda update -n base conda
  • 仮想環境のバックアップ
    定期的にenv.ymlをエクスポートして、Gitリポジトリに保存しておくと、環境の再現が簡単です。

まとめ

AnacondaとVS Codeを組み合わせることで、Python開発環境を効率的かつ柔軟に構築できます。base環境でAnacondaを管理し、仮想環境でプロジェクトを分離することで、依存関係の衝突を防ぎ、チームでの共有もスムーズに。さらに、WindowsユーザーはVS Codeのターミナルをコマンドプロンプトに設定することで、Pythonやcondaの動作を安定させられます。ワークフローはシンプルで、以下の3行を覚えておけばOK：

conda create -n myenv python=3.11
conda activate myenv
conda deactivate

さあ、これで準備万端！Pythonでのコーディングを楽しんでください！

使われる手法2：スクリプト側でcertifiをわかりやすくできる

Anaconda + Windows環境では、Pythonが正しいルート証明書ファイルを参照できていないことが原因で、SSLエラーが発生しやすいです。その場合、以下のようにコードの証明書ファイルをわかりやすく指定しcertifiてみてください。

🔧 修正コード例（OpenAI API使用時）

パイソンコピー編集import openai
import os
import certifi
import ssl
import urllib3

# 明示的に証明書ファイルを指定
os.environ['SSL_CERT_FILE'] = certifi.where()

# 安全のため urllib3 を使っても OK にしておく
http = urllib3.PoolManager(
    cert_reqs='CERT_REQUIRED',
    ca_certs=certifi.where()
)

🔄さらにやるべきこと（念のため）

1.Conda環境のcertifi更新

バッシュコピー編集conda update certifi

2.python -m sslで確認

VSCodeのターミナルで以下を実行してみてください：

バッシュコピー編集python -m ssl

うまく動けばSSL証明書まわりは正常に設定されています。エラーが出たら、SSLのインストールに問題があります。

🧪被害被害な時の緊急回避（非推奨）

SSLチェックを有効化する方法もありますが、セキュリティ的に危険なので一時的なデバッグ以外では推奨しません：

パイソンコピー編集import ssl
import openai

ssl._create_default_https_context = ssl._create_unverified_context

まとめ

  • 今回はcertifi.where()をos.environ['SSL_CERT_FILE']に指定するのが有効です。
  • もし被害ならpython -m ssl環境チェック。
  • 必要に応じてconda update certifiも追加。

【さらに追加】

❌ 問題1：SSL証明書エラー

ヤムルコピー編集https.ConnectError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1129)

→これは「ローカル証明書が読み込めない」というエラーです。

✅ 対策1：certifiを知らない指定するだけでは許容できないケースあり

次のような状況では、os.environ["SSL_CERT_FILE"] = certifi.where()だけではできないことがあります。

🔧試して追加ほしい対策（確実に効果的な方法）

パイソンコピー編集import ssl
import certifi

ssl_context = ssl.create_default_context(cafile=certifi.where())

# OpenAIにリクエストするとき、明示的に context を渡す
# httpx や urllib3 を使う場合も、この context を利用

ただし、openaiパッケージは内部的にhttpx使っているため、この
SSL コンテキストを直接渡すことが難しい場合もあります。

✅ 対策2：AnacondaにバンドルされているInstall Certificatesスクリプトを実行する（Windows）

Anaconda の Python のInstall Certificatesバッチスクリプトがあるはずです。

📌手順

  1. 以下のファイルを探してください（Anacondaディレクトリ内）：
PHPテンプレートコピー編集<Anacondaのフォルダ>\Lib\site-packages\certifi\win32\install_certifi_ssl.py

または：

バッシュコピー編集<Anacondaフォルダ>\Install Certificates.command
  1. コマンドプロンプトで以下を実行：
バッシュコピー編集python -m pip install --upgrade certifi
python -m certifi
  1. とりあえず直らなければ、最終手段としてssl._create_unverified_context使う回避策：

🔥最終回避策（非推奨ですが一時的には効果的）

パイソンコピー編集import ssl
ssl._create_default_https_context = ssl._create_unverified_context

これをスクリプトの許可に書くことで、SSL認証チェックを無効化できます（危険なので開発中のみ！）

❌ 問題2：traceback.print_exception()に引数が足りない

CSSコピー編集TypeError: print_exception() missing 2 required positional arguments: 'value' and 'tb'

✅正しい使い方：

パイソンコピー編集except Exception as e:
    import traceback
    traceback.print_exception(type(e), e, e.__traceback__, file=sys.stderr)

✅全体の修正まとめ

🔁 1. SSL回避（開発中のみ）

パイソンコピー編集import ssl
ssl._create_default_https_context = ssl._create_unverified_context

✅ 2. トレースバックの修正

パイソンコピー編集except Exception as e:
    traceback.print_exception(type(e), e, e.__traceback__, file=sys.stderr)

********************************FINAL*********************************

根本的な対処法：Windows + Anaconda 環境にルート証明書を正しく認識させる

🔧対処ステップ（100％安全な解決法）

以下の方法は、「開発用Pythonに正しいSSL証明書を再インストールする」公式手順です。

✅ 手順①：Anaconda プロンプトを起動する

（普通のコマンドプロンプトではなく、Anacondaプロンプト）

✅ 手順②：Install Certificatesスクリプトを実行（Python付属）

以下のコマンドをそのままコピペして実行：

バッシュコピー編集python -m pip install --upgrade certifi
python -m ensurepip --default-pip
python -m pip install --upgrade pip setuptools

あとあと、以下を実行：

バッシュコピー編集python -m certifi

出力された.pemファイルのパスを確認します（例：C:\Users\ユーザー名\AppData\Local\Programs\Python\Python39\lib\site-packages\certifi\cacert.pem）

✅ 手順③：SSL_CERT_FILEをわかりやすく指定（必要な場合）

コードの許可に入れてください：

パイソンコピー編集import os
import certifi
os.environ['SSL_CERT_FILE'] = certifi.where()

✅はっきり：Requestsやがhttpx使う証明書がOSに依存することもある

Windows環境によっては、企業ネットワークやプロキシの影響で「証明書のパスがブロック」される場合があります。その
場合は、ネットワーク管理者が「ルートCAをWindowsに手動で追加」してもらう必要があります。

🔥 最終手段：Windows 全体に証明書をインポート（上級者向け）

1.このリンク先からをcacert.pemダウンロード

2. 任意の場所に保存（例：C:\certs\cacert.pem）

3. 環境変数を設定：

バッシュコピー編集set SSL_CERT_FILE=C:\certs\cacert.pem

またはコードで：

パイソンコピー編集os.environ['SSL_CERT_FILE'] = "C:/certs/cacert.pem"

✅ 確認コマンド（SSL通信チェック）

バッシュコピー編集python -c "import ssl; print(ssl.get_default_verify_paths())"

この出力結果が「存在しないファイル」になっていないか確認してください。

📌 結論

方法内容
✅最も確実python -m pip install --upgrade certifi→python -m certifi
🛠確認方法python -c "import ssl; print(ssl.get_default_verify_paths())"
⚠エラーが続くときWindowsの証明書ストアが壊れている、または会社のネットワーク設定の影響あり

from openai import OpenAI

client = OpenAI(
api_key = “YOUR_KEY”,
base_url = “https://xxx.co.jp/xxx/”, # Azure ならエンドポイント
default_headers={“api-version”: “2023-05-15”} # Azure 専用
)

resp = client.chat.completions.create(
model=”gpt-4o-mini-001″, # Azure は deployment 名
messages=[
{“role”:”system”, “content”:”あなたはアシスタント”},
{“role”:”user”, “content”:”売れまくるドローン仕様は？”}
]
)
print(resp.choices[0].message.content)

コメント

タイトルとURLをコピーしました