ツイートシェアはてブ LINE Pocket

入門

PyCharm は、Python 開発者に幅広い必須ツールを提供する専用の Python 統合開発環境（IDE）であり、緊密に統合されて、生産的な Python、Web、およびデータサイエンス開発のための便利な環境を作成します。

最適な PyCharm を選択してください

PyCharm には 3 つのエディションがあります。

Community（無料でオープンソース(英語)）：コードアシスタンス、リファクタリング、ビジュアルデバッグ、バージョン管理統合を含む、スマートでインテリジェントな Python 開発用。
Professional（有償）：コード支援、リファクタリング、ビジュアルデバッグ、バージョン管理統合、リモート構成、デプロイ、Django や Flask などの一般的な Web フレームワークのサポート、データベースサポート、科学など、プロの Python、Web、およびデータサイエンス開発向けツール（Jupyter ノートブックのサポートを含む）、ビッグデータツール。
Edu（無料でオープンソース(英語)）：統合された教育ツールを使用してプログラミング言語と関連技術を学習します。

詳細については、エディションの比較表を参照してください。

サポートされる言語

PyCharm を使用して Python で開発を開始するには、プラットフォームに応じて python.org(英語) から Python をダウンロードしてインストールする必要があります。

PyCharm は Python の以下のバージョンをサポートしています：

Python 2 : バージョン 2.7
Python 3 : バージョン 3.5 からバージョン 3.9 まで

さらに、Professional エディションでは、Django、Flask、および Pyramid アプリケーションを開発できます。また、HTML（HTML5 を含む）、CSS、JavaScript、XML を完全にサポートしています。これらの言語はプラグインを介して IDE にバンドルされており、デフォルトでオンになっています。他の言語とフレームワークのサポートは、プラグインを介して追加することもできます（macOS ユーザーの場合は設定 | プラグインまたは PyCharm | 環境設定 | プラグインにアクセスして、詳細を確認するか、最初の IDE の起動時に設定してください）。

サポートされるプラットフォーム

PyCharm は、Windows、macOS、および Linux で動作するクロスプラットフォーム IDE です。システム要件を確認します。

要件	最小	推奨
RAM	4 GB の空き RAM	8 GB の総システム RAM
ディスク容量	2.5 GB およびキャッシュ用にもう 1 GB	5 GB 以上の空き容量がある SSD ドライブ
モニターの解像度	1024x768	1920 × 1080
オペレーティングシステム	以下の公式にリリースされた 64 ビットバージョン： Microsoft Windows 8 以降 macOS 10.13 以降 Gnome、KDE、または Unity DE をサポートする Linux ディストリビューションプレリリース版はサポートされていません。	最新の 64 ビットバージョンの Windows、macOS、または Linux (たとえば、Debian、Ubuntu、RHEL などです。)

PyCharm は、Toolbox またはスタンドアロンインストールを使用してインストールできます。PyCharm のインストールについてサポートが必要な場合は、インストール手順を参照してください：PyCharm をインストールする

PyCharm のプロジェクトから始める

PyCharm で行うすべてのことは、プロジェクトのコンテキスト内で行います。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基礎として機能します。IDE 内でプロジェクトの作業を開始するには、3 つのオプションがあります。

既存プロジェクトを開く
バージョン管理からプロジェクトをチェックアウトする
新規プロジェクトの作成

既存プロジェクトを開く

まず、コンピューターに保存されている既存のプロジェクトの 1 つを開きます。ようこそ画面の最近のプロジェクトのリストから 1 つ選択するか、開くをクリックします。

それ以外の場合は、既存のソースファイルのプロジェクトを作成できます。ファイルメニューの開くコマンドを選択し、ソースが存在するディレクトリを指定します。PyCharm は、ソースからプロジェクトを作成します。詳細については、セクション既存のソースコードからプロジェクトをインポートするを参照してください。

バージョン管理から既存のプロジェクトをチェックアウトする

VCS ストレージまたはリポジトリからソースをダウンロードすることもできます。Git（GitHub）、Mercurial、Subversion、Perforce（Professional エディションでのみサポート）を選択し、資格情報を入力してストレージにアクセスします。

次に、ソースへのパスを入力し、リポジトリをローカルホストにクローンします。

詳細はセクションバージョン管理を参照してください。

新規プロジェクトの作成

プロジェクトを作成するには、次のいずれかを実行します。

メインメニューから、ファイル | 新規プロジェクトを選択します。
ようこそ画面で、新規プロジェクトの作成をクリックします。

PyCharm コミュニティでは、Python プロジェクトのみを作成できますが、PyCharm Professional では、Web フレームワークプロジェクトを作成するためのさまざまなオプションがあります。

Creating a PyCharm helps implement new project

詳細は Python プロジェクトを作成しますを参照してください。

Python インタープリターを構成する

新しいプロジェクトを作成するとき、PyCharm がプロジェクトで Python コードを実行するように Python インタープリターを設定していることがわかります。マシンで使用できるようにするには、少なくとも 1 つの Python のインストール(英語)が必要です。

新しいプロジェクトの場合、Python インタープリターは分離された仮想環境として作成されます：venv、pipenv、または Conda。作業中に、それを変更したり、新しいインタープリターを作成したりできます。同じ Python 実行可能ファイルに基づいて、複数の Python インタープリターを作成できます。これは、さまざまなタイプのアプリケーションを開発するためにさまざまな仮想環境を作成する必要がある場合に役立ちます。例：Python 3.6 に基づいて 1 つの仮想環境を作成して Django アプリケーションを開発し、同じ Python 3.6 に基づいて別の仮想環境を作成して科学ライブラリを操作できます。

以下を構成できます。

標準 Python（サポートされるバージョンを参照）または他の Python 実装（IronPython(英語)、PyPy(英語)、Jython(英語)、CPython(英語)）に基づくシステムインタープリター。
Virtualenv 環境：Virtualenv、Pipenv、および Conda。

PyCharm Professional を使用すると、リモート環境で Python コードを実行するようにインタープリターを構成することもできます。

SSH
Vagrant
WSL (Windows のみ)
Docker-based インタープリター（Docker、Docker Compose）。
Docker-based プロジェクトインタープリターに Python パッケージをインストールすることはできません。

詳細については、Python インタープリターを構成するを参照してください。

外観

PyCharm を初めて起動したとき、または開いているプロジェクトがない場合は、ようこそ画面が表示されます。IDE への主要なエントリポイントとして、プロジェクトの作成またはオープン、バージョン管理からのプロジェクトのチェックアウト、ドキュメントの表示、および IDE の設定が提供されます。

プロジェクトを開くと、メインウィンドウがいくつかの論理領域に分割されて表示されます。ここで主要な UI 要素を見てみましょう：

左側のプロジェクトツールウィンドウにプロジェクトファイルが表示されます。
エディターの右側にあり、実際にコードを書いています。開いているファイル間を簡単に移動するためのタブがあります。
エディター上のナビゲーションバーを使用すると、アプリケーションを素早く実行してデバッグすることができます。また、基本的な VCS アクションを実行できます。
ガターは、エディターの横にある縦縞であり、現在のブレークポイントを示し、定義 / 宣言にジャンプようなコード階層をナビゲートする便利な方法を提供します。また、行番号と行ごとの VCS 履歴も表示されます。
エディターの右側にあるスクロールバー。PyCharm は常にコードの品質を監視し、そのコードインスペクションの結果を常にガターに表示します（エラー、警告など）。右上隅のインジケーターは、ファイル全体のコードインスペクションの全体的なステータスを示します。
ツールウィンドウはワークスペースの下部と側面に取り付けられた特殊なウィンドウで、プロジェクト管理、ソースコードの検索とナビゲーション、バージョン管理システムとの統合などの一般的なタスクへのアクセスを提供します。
ステータスバーは、プロジェクトと IDE 全体のステータスを示し、ファイルエンコーディング、行区切り記号、インスペクションプロファイルなどのさまざまな警告と情報メッセージを示します。また、Python インタープリター設定にすばやくアクセスできます。

また、PyCharm ウィンドウの左下隅のステータスバーに、またはボタンが表示されます。このボタンは、ツールウィンドウバーの表示を切り替えます。このボタンの上にマウスポインターを置くと、現在使用可能なツールウィンドウのリストが表示されます。

ツールウィンドウの表示と非表示の詳細については、ユーザーインターフェースの概要とツールウィンドウのページを参照してください。

スマートアシスタンスによるコード

新しいプロジェクトを作成するか、既存のプロジェクトを開いたら、コーディングを開始します。

Python ファイルの作成

プロジェクトツールウィンドウでプロジェクトルートを選択してから、メインメニューからファイル | 新規 ... を選択するか、Alt+Insert を押します。

ポップアップからオプション Python ファイルを選択し、新しいファイル名を入力します。

PyCharm は新しい Python ファイルを作成し、編集用に開きます。

PyCharm は重要なことに集中できるようにルーチンを処理します。貴重な時間を無駄にすることなく、エラーのないアプリケーションを作成するには、次のコーディング機能を使用します。

コード補完

コード補完は、作業しているファイルの種類に関係なく、時間を節約してくれます。

基本補完機能は、名前を入力して即座に名前を入力するときに機能します。

スマート型補完機能は、現在作業中のコンテキストを分析し、その分析に基づいてより正確な提案を提供します。

インテンションアクション

PyCharm は、現在行っていることを監視し、インテンションアクションと呼ばれる賢い提案を行って、時間を節約します。電球で示されるインテンションアクションでは、正しいコードに自動変更を適用できます（正しくない可能性があるコードにクイックフィックスを提供するコードインスペクションとは対照的です）。コンストラクターにいくつかのパラメーターとフィールド初期化子を追加することを忘れましたか？ PyCharm には問題ありません。電球をクリックして（または Alt+Enter を押して）、提案されたオプションの 1 つを選択します。

コードをきれいに保つ

PyCharm はあなたのコードを監視し、正確かつ清潔に保ちます。潜在的なエラーと問題を検出し、クイックフィックスを提案します。

IDE が未使用のコード、無限ループ、およびあなたの注意を必要とする他の多くのものを見つけるたびに、電球が表示されます。それをクリックするか、Alt+Enter を押して修正を適用します。

いくつかのコードを生成する

PyCharm で利用可能なコード生成オプションを使用すると、コードの記述がはるかに簡単かつ迅速になります。コード | 生成メニュー Alt+Insert は、使用箇所からシンボルを作成するのに役立ち、オーバーライドやいくつかの機能の実装を提案します。

開発に特に重要なものが欠落している場合は、このテンプレートセットを独自のもので拡張してください。また、コードを完全な構造ですばやく囲むことを検討してください（コード | 囲むを選択するか Ctrl+Alt+T を押します。例： if ステートメントを使用：

探索の方法

プロジェクトが大きいとき、または他の誰かのコードを操作しなければならないときは、探しているものを素早く見つけてコードを詳しく調べることが重要です。これが、PyCharm がどんなに複雑なコードでも自分のやり方を見つけるのに役立つ一連のナビゲーションおよび検索機能を備えている理由です。

基本的な検索

これらの検索機能を使用すると、現在開いているファイル Ctrl+F またはプロジェクト全体 Ctrl+Shift+F の両方で、コードのフラグメントを検索して置き換えることができます。

使用箇所を検索

特定のシンボルが使用されている場所を見つけるために、PyCharm は使用箇所の検索 Alt+F7 を介したフルスケール検索を提案します。

インポートや呼び出しの階層を使って、ファイル構造を見るだけで多くのことを知ることができます：

また、次の場所に移動できます。

左側のガターにあるアイコンもナビゲーションに役立ちます：

Navigating by using the left-hand gutter

プロジェクトでのすべてのアクティビティを記憶して、PyCharm は最近使ったファイル Ctrl+E または最近変更したファイル Alt+Shift+C に簡単にナビゲートできます。

変更履歴を確認するには、戻る / 進むナビゲーション（Ctrl+Alt+Left / Ctrl+Alt+Right）を使用するか、最後の編集場所 Ctrl+Shift+Backspace に移動してください。

どこでも検索

探しているものの概要がわかっている場合は、既存のナビゲーション機能のいずれかを使用して、対応する要素をいつでも見つけることができます。しかし、すべての隅々で何かを探したい場合はどうでしょうか？答えはどこでも検索を使用することです !

それを試すには、ウィンドウの右上にある虫めがねのボタンをクリックするか、ダブルシフト（Shift を 2 回押して）を呼び出してください。

実行、デバッグ、テスト

コードを操作して何ができるのかを発見したら、今度はアプリを実行、デバッグ、テストしましょう。

実行

アプリケーションを実行する最も簡単な方法は、エディターを右クリックして、コンテキストメニューから実行 <名前> を選択することです。

Python スクリプトに __main__ 句が含まれている場合、ガターのボタンをクリックして、目的のコマンドを選択できます。

PyCharm を使用して実行、デバッグ、またはテストの操作を実行するときは、常に既存の実行 / デバッグ構成のいずれかに基づいて、そのパラメーターを使用してプロセスを開始します。

初めてアプリケーションを実行すると、PyCharm は自動的に一時的な実行 / デバッグ構成を作成します。デフォルトのパラメーターを指定または変更して永続的な実行 / デバッグ構成として保存するように変更できます。

実行 / デバッグ構成を操作するで実行 / デバッグ構成を調整する方法を参照してください。

デバッグ

アプリケーションはランタイムエラーに遭遇しますか？その原因を突き止めるためには、デバッグをする必要があります。PyCharm はすべてのプラットフォームでデバッガーをサポートしています。

デバッグは、プログラムの実行を中断するブレークポイントを配置することから開始するため、プログラムデータを探索できます。ブレークポイントを表示する行の側ガターをクリックするだけです。

アプリケーションのデバッグを開始するには、Shift+F9 を押します。次に、プログラムの実行を段階的に実行し（実行メニューまたはデバッグツールウィンドウの使用可能なオプションを参照）、任意の式を評価し、監視を追加し、変数の値を手動で設定します。

詳細はセクションデバッグを参照してください。

テスト

アプリケーションをテストすることをお勧めします。PyCharm は、できるだけ簡単に行うことができます。

PyCharm を使用すると、次のことができます。

テストの作成
特別な実行 / デバッグ構成のテストを作成します。
テストの実行 / デバッグ構成を使用して、IDE からテストを実行し、デバッグします。
そして最後に、最も重要なこと - 実行ツールウィンドウのテストランナータブでテスト結果を調べることができます。

数字については、テストランナータブのセクションを参照してください。

PyCharm は Python の主要なテストフレームワークをすべてサポートしています：

これらのフレームワークのそれぞれについて、PyCharm は独自の実行 / デバッグ構成を提供します。

詳細については、チュートリアルステップ 3. 最初の Python アプリケーションをテストするおよびテストの実行セクションを参照してください。

PyCharm Professional を使用すると、Python コードをリモートで実行、デバッグ、テストできます。ローカルアプリケーションを一部のリモートサーバーにデプロイできます。デプロイサーバーについては、セクション Web サーバーとの同期の構成を参照してください。PyCharm Professional はローカルとリモートフォルダーを比較し、ローカルコピーをサーバー上にデプロイされたものと同期させますにも役立ちます。

ソースコードをバージョン管理下に置く

VCS

ソースコードをバージョン管理下に置いている場合は、PyCharm が多くの一般的なバージョン管理システム（Git（または GitHub）、Mercurial、Perforce（Professional エディションでのみサポートされています）、Subversion）と統合されていることを知って喜んでいます。資格情報と特定の VCS に固有の設定を指定するには、設定 | バージョン管理（または macOS ユーザーの場合は PyCharm | 環境設定 | バージョン管理）に移動します。

VCS メニューには、使用可能なコマンドに関する手掛かりが表示されます。例：ローカルの変更ビュー VCS | 変更の表示（または Alt+9 を押す）から、加えた変更を確認し、変更をコミットし、変更リストを作成できます。また、エディターの上のナビゲーションバーでいくつかの VCS 基本コマンドを見つけます。

詳細はセクションバージョン管理を参照してください。

ローカルヒストリー

従来のバージョン管理に加えて、ローカルヒストリーを使用できます。ローカルヒストリーにより、PyCharm はソースコードに加えた変更、リファクタリングの結果などを自動的に追跡する

ローカルヒストリーは常に有効です。ファイルまたはフォルダーについて表示するには、VCS | ローカルヒストリー | ヒストリーの表示を選択してローカルヒストリーを表示します。ここで、変更を確認したり、元に戻したり、パッチを作成したりできます。

プロセスデータ

PyCharm には対話的な Python コンソールがあり、インスペクション、中括弧と引用符のマッチング、もちろんコード補完を使用したオンザフライの構文チェックにより、データに対してスマートな操作を実行できます。Anaconda の組み込みサポートを利用することもできます。

PyCharm Professional を使用すると、さまざまな科学的および統計的データを分析および視覚化できます。Jupyter Notebook の統合により、ノートブックのソースコードの編集、実行、デバッグ、およびストリームデータ、イメージ、その他のメディアを含む実行出力の調査が可能になります。

PyCharm に R プラグインをインストールすると、R 言語(英語)を使用してさまざまな統計計算を実行し、コーディング支援、ビジュアルデバッグ、スマート実行およびプレビューツール、およびその他の一般的な IDE 機能を使用できます。

既に気づいたことがあるように、さまざまなタイプのプロジェクト（Django など）を作成するには、データソースが必要です。また、ソースコードに SQL 文を挿入することも可能です。

PyCharm Professional ではデータベースを作成することはできませんが、データベースを管理およびクエリする機能は提供されます。特定のデータベースへのアクセスが許可されると、データベースの構造を反映する PyCharm 内の 1 つ以上のデータソースを構成し、データベースアクセス資格情報を保存できます。この情報に基づいて、PyCharm はデータベースへの接続を確立し、そこに含まれる情報を取得または変更する機能を提供します。

データベースへのアクセスは、データベースツールウィンドウ（表示 | ツールウィンドウ | データベース）によって提供されます。このツールウィンドウでは、データベースを操作できます。データベースのデータ構造を表示および変更したり、関連する他のタスクを実行したりすることができます。

詳細はデータベースツールおよび SQL を参照してください。

環境をカスタマイズする

IDE を自由に調整して、ニーズに完全に適合し、できる限り便利で快適なものにしてください。ファイル | 設定（macOS ユーザーの場合は PyCharm | 環境設定）に移動して、使用可能なカスタマイズオプションのリストを確認します。

外観

エディター

ファイル | 設定 | エディター（macOS ユーザーのための PyCharm | 環境設定 | エディター）で利用可能な多くのページはエディターの振る舞いのあらゆる面を調整できます。ここでは、一般的な設定（ドラッグアンドドロップの有効化、スクロール設定など）から、使用可能な各言語およびユースケースの色設定、タブおよびコードの折りたたみ設定、コード補完の動作まで、さまざまなオプションを利用できます。そして後置テンプレートさえも。

詳細はセクション PyCharm 設定の構成を参照してください。

コードスタイル

詳細は、コードスタイルの構成およびコード品質支援のヒントとコツ、またはコードをきれいに見せる方法を参照してください。

キーマップ

PyCharm はキーボード中心のアプローチを採用しています。つまり、IDE で可能なすべてのアクションがキーボードショートカットにマッピングされています。

事前定義されたキーマップ（Emacs、Visual Studio、Eclipse、NetBeans など）もあり、既存のキーマップに基づいて独自のキーマップを作成することもできます。

vi / Vim で最も生産的に感じるなら、エミュレーションモードはあなたに両方の長所を与えます。IDE で IdeaVim プラグインを有効にして vim キーマップを選択します。

詳細はセクションキーボードショートカットの構成を参照してください。

以上です ! 先に進んで開発を楽しみましょう !

重要な PyCharm 機能のこの簡単な概要がすぐに開始できることを願っています。開発者の生活をより簡単で楽しいものにする多くの重要な機能と、ソースコードをすっきりときれいにしています。これらの最初のいくつかのステップを今すぐ実行し、適切なタイミングで深く掘り下げます。

PyCharm を楽しみましょう ! ご不明な点がございましたら、ディスカッションフォーラム、twitter(英語)、ブログ(英語)にアクセスしてください。ニュース、更新、役立つヒントやコツを見つけることができます。また、サポートチーム(英語)）または PyCharm の課題トラッカー(英語)に課題を報告することをためらわないでください。

最終更新日 : 2020 年 10 月 22 日

PyCharm 2020.2 ヘルプ

入門