PyCharm 2020.2ヘルプ

入門

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

最適な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です。システム要件を確認します。

要件最小推奨
RAM4 GBの空きRAM8 GBの総システムRAM
ディスク容量2.5 GBおよびキャッシュ用にもう1 GB5 GB以上の空き容量があるSSDドライブ
モニターの解像度1024x7681920×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つ選択するか、開く をクリックします。

Welcome screen

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

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

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

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

Clone a repository

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

新規プロジェクトの作成

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

  • メインメニューから、ファイル | 新規プロジェクトを選択します。

  • ようこそ画面で、新規プロジェクトの作成をクリックします。

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

Creating a new project

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に基づいて別の仮想環境を作成して科学ライブラリを操作できます。

以下を構成できます。

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

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

見回す

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

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

The Main window
  1. 左側のプロジェクトツールウィンドウにプロジェクトファイルが表示されます。

  2. エディターの右側にあり、実際にコードを書いています。開いているファイル間を簡単に移動するためのタブがあります。

  3. エディター上のナビゲーション・バーを使用すると、アプリケーションを素早く実行してデバッグすることができます。また、基本的なVCS アクションを実行できます。

  4. ガターは、エディターの横にある縦縞であり、現在のブレークポイントを示し、定義/宣言にジャンプようなコード階層をナビゲートする便利な方法を提供します。また、行番号と行ごとのVCS履歴も表示されます。

  5. エディターの右側にあるスクロール・バー。PyCharmは常にコードの品質を監視し、そのコードインスペクションの結果を常にガターに表示します(エラー、警告など)。右上隅のインジケーターは、ファイル全体のコードインスペクションの全体的なステータスを示します。

  6. ツール・ウィンドウはワークスペースの下部と側面に取り付けられた特殊なウィンドウで、プロジェクト管理、ソースコードの検索とナビゲーション、バージョン管理システムとの統合などの一般的なタスクへのアクセスを提供します。

  7. ステータスバーは、プロジェクトとIDE全体のステータスを示し、ファイルエンコーディング、行区切り記号、インスペクションプロファイルなどのさまざまな警告と情報メッセージを示します。また、Pythonインタープリター設定にすばやくアクセスできます。

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

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

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

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

Pythonファイルの作成

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

Create a Python file

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

Creating a new Python file

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

New Python file

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

コード補完

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

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

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

Smart code completion

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

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

Intention Action

使用可能なインテンションアクションの全リストは、macOSユーザーの場合はファイル | 設定 | エディター | インテンションまたはPyCharm | 環境設定 | エディター | インテンションにあります。

コードをきれいに保つ

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

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

使用可能なインスペクションの完全なリストは、設定 | エディター | インスペクション(またはmacOSユーザーの場合はPyCharm | 環境設定 | エディター | インスペクション)にあります。それらのいくつかを無効にするか、他のものを有効にし、さらに各インスペクションの重大度を調整します。エラーと見なすか警告と見なすかを決定します。

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

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

Generate code

ライブテンプレートを使用して(コード | ライブ・テンプレートの挿入を選択するか Ctrl+Jを押します)、コード全体を作成します。設定/環境設定ダイアログ Ctrl+Alt+S (macOSユーザーの場合は設定 | エディター | ライブ・テンプレートまたはPyCharm | 環境設定 | エディター | ライブ・テンプレート)で、使用可能なすぐに使用可能なライブテンプレートを調べることができます。

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

Surround code

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

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

使用箇所を検索

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

Find usages

プロジェクトのナビゲーション

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

File structure

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

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

Navigating by using the left-hand gutter

タイムラインをナビゲートする

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

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

どこでも検索

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

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

search everything window

実行、デバッグ、テスト

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

実行

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

Running code

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

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

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

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

デバッグ

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

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

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

Debug tool window

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

テスト

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

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

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

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基本コマンドを見つけます。

Version Control System

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

ローカル・ヒストリー

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

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

プロセスデータ

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

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

Jupyter notebook support

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

R plugin

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

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

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

DB tool window

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

環境をカスタマイズする

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

外観

最初に微調整するのは、一般的な「ルックアンドフィール」です。ファイル | 設定 | 外観および振る舞い | 外観(macOSユーザーの場合はPyCharm | 環境設定 | 外観および振る舞い | 外観)に移動してIDE テーマを選択します。明るいテーマ、または暗い設定が必要な場合はDarculaを選択します。

エディター

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

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

コード・スタイル

コード・スタイルファイル | 設定 | エディター | コード・スタイル(macOSユーザーの場合はPyCharm | 環境設定 | エディター | コード・スタイル)で各言語に定義できます。独自のコーディングスタイルスキームを作成して保存することもできます。

Code style settings

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

キーマップ

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

使うキーボードショートカットのセットはあなたの最も親密な習慣の一つです - あなたの指はキーの特定の組み合わせを「覚えて」い、この習慣を変えることはされるより簡単に言われます。PyCharmはデフォルトのキーマップ(メインメニューからヘルプ | キーマップ・リファレンスを選択)を提供し、あなたのコーディングを本当に生産的で便利にします。ただし、ファイル | 設定 | キーマップ変更することはいつでも変更できます(macOSユーザーの場合はPyCharm | 環境設定 | キーマップ)。

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

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

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

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

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

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

最終更新日: 2020年9月16日

関連ページ:

Python

PyCharmでPythonスクリプトを開発するには、Pythonをダウンロードしてインストールし、少なくとも1つのPython インタープリターを構成します。Windowsユーザーの場合、Windows用Pythonをインストールすることをお勧めします。サポートされるバージョン:Python 2:...

PyCharmをインストールする

PyCharmは、Windows、macOS、およびLinuxオペレーティングシステムで一貫したエクスペリエンスを提供するクロスプラットフォームIDEです。PyCharmには、Professional、Community、およびEduの3つのエディションがあります。CommunityおよびEduエデ...

プロジェクトを開く、再開する、閉じる

PyCharmを使用すると、複数のプロジェクトを異なるウィンドウで同時に開くことができます。デフォルトでは、プロジェクトを開くときに別のプロジェクトを開くたびに、PyCharmはプロジェクトを同じウィンドウで開くか、新しいウィンドウで開くかを選択するように求めます。必要に応じて、システム設定ページの...

バージョン管理

VCS 操作のポップアップ( またはVCS | VCS 操作のポップアップ)を使用すると、VCS関連のコマンドをすばやく呼び出すことができます。ポップアップ内のアクションのリストは、現在有効になっているVCSによって異なります。VCSオペレーションポップアップコマンドのリストは設定可能です。設定/環...

ようこそ画面

PyCharmは、プロジェクトが開かれていないときにようこそ画面を表示します。例:PyCharmを初めて実行したとき、または開いているプロジェクトの唯一のインスタンスを閉じたとき。この画面から、新しいプロジェクトを作成したり、PyCharm Eduで学習パスを開始したり、既存のプロジェクトをバージョ...

Python プロジェクトを作成します

純粋なPythonプロジェクトは、Pythonプログラミングを対象としています。プロジェクトを作成するには、次のいずれかを実行します。メインメニューから、ファイル | 新規プロジェクトを選択します。ようこそ画面で、新規プロジェクトの作成をクリックします。新規プロジェクトダイアログが開きます。新規プロ...