来自：http://www.jetbrains.com/pycharm/quickstart/

快速入门指南。探索IDE 通讯教授

欢迎来到PyCharm！这个简短的指南旨在帮助您在PyCharm IDE一握。

在开始之前...

请确保至少有一个的Python解释器，版本从2.4到3.4正确安装到计算机上。
介意PyCharm有两个版本：社区版和专业。该版本之间的差异探讨版本比较矩阵。

请注意下载页面中包含针对各种平台的安装说明; 这些指令可以改变为不同的操作系统。

初始设置

如果这是您第一次启动您的PyCharm，它会问你几个重要问题：

首先，你是否已经设置要保留（例如，从以前的版本）
许可信息
最后，你要使用的键盘映射和主题：

需要注意的是PyCharm有几个预定义的键盘映射：对于那些谁像Eclipse或Visual Studio，为Emacs的球迷，GNOME，KDE等等。探索在可用的键盘布局的列表按键对应页面设置/首选项对话框。

对于专用Vim的用户，PyCharm表明IdeaVim插件，可以帮助编码，PyCharm仿佛在Vim编辑器。对于那些谁不能没有真正的Emacs，PyCharm提供的可能性，使用它作为外部编辑器。

如果以后你决定你最初的选择是错误的，你可以随时更改设置。要了解更多有关配置IDE主题，键盘映射，请访问我们的文档和教程：

另请参见：: 入门PyCharm 配置键盘方案

从欢迎屏幕设置默认值

同样，如果这是你第一次启动（或者如果你没有打开的项目），你会看到欢迎界面。如果您单击链接配置，你会看到欢迎屏幕的提示您配置环境，插件，导入和导出设置页面。你必须点击配置一次-并查看设置/首选项对话框。如果你看一下这个对话框中，你会发现头“模板项目设置”：

这是什么意思？这些设置将被用于创建一个新的项目每次。例如，你想你的所有新创建的项目使用相同的解释- OK，你可以定义这样的解释在模板项目设置。

该IDE设置描述你的工作环境（键盘映射，配色方案等）。例如，你希望你的编辑器始终显示行数。在设置/首选项对话框，转到IDE设置，展开节点编辑器，并在外观页，选中复选框“显示行号”：

接下来，假设你想使用一些特定的颜色方案编辑器，你是不是满意，在默认情况下提出的颜色。OK，选择基本方案，创建其副本，然后改变颜色（默认情况下提出的方案是不可编辑）。

还可以设置您的首选字体大小为编辑器-这是在的字体页面进行颜色和字体设置。再次，你必须首先创建计划的副本，如果你还没有做它已经，然后指定为编辑器所需的字体大小。这种字体大小将应用到当前的编辑器选项卡，所有新开的编辑。然而，它不影响在IDE部件的字体大小。

需要注意的是，你总能看到在预览窗格中的实验结果：

整个过程被描述一步一步的教程什么我PyCharm样子。

当已经创建了一个项目，你可以在任何时候更改其设置。当前项目配置的设置将在稍后讨论，在部分定制一切为您的项目！。

最后，您可以显示或隐藏所有实际的UI元素：工具栏按钮，主菜单，主工具栏（菜单View）; PyCharm，您还可以选择观看模式。详情请参阅文档：

另请参见：: PyCharm工具窗口展示和全屏观看模式

工程

你PyCharm所做的一切，是的范围内完成项目。什么是最有趣的PyCharm项目管理，是有可能在一个框架中打开多个项目。当你创建一个新的项目（文件→新建项目），或打开一个现有的（文件→打开），PyCharm建议你选择你想要打开的项目，该项目的方式：在新窗口中，在同一个窗口关闭后，以前打开的项目中，或者加入到先前打开的项目中。

你可以有很多项目在一个窗口中打开的要求。这样一来，第一个项目被认为是主要项目。所添加的项目的所有符号都从主项目可见。

作为一个练习，创建一个新的空项目，在那里你可以开发一些纯Python代码。这种情况下，进行了详细的教程讨论入门PyCharm -尤其是部分创建一个简单的项目。

项目类型

顺便说一句，PyCharm建议创建不同类型的项目：Django的，瓶，金字塔，web2py会等您可以探索可用自己的类型，创建一个新项目时 - 只需选择从下拉列表中选择新的项目类型：

正如你看到的，PyCharm支持所有主要的基于Python的框架。对于每一个所支持的项目类型，PyCharm创建相应的文件和目录结构，以及所有必要的工件。请参阅产品文档：

起动机

OK，你的项目已经准备就绪。在你开始使用它，只需按下Shift键两次。你会看到一个弹出窗口，使找到任何和跳跃无处不在：

正如你看到的，这种方法可以操作，设置，文件，IDE组件，多间搜索。需要注意的是它仅仅是众多的导航功能之一。我们将回到PyCharm的搜索和导航设施，一点点后。

定制一切为您的项目！

看主工具栏-有设置按钮

。单击此按钮打开设置/首选项对话框，在这里你可以改变你的项目结构，建立了版本控制和调整你的工作环境，使开发过程中真正的快乐。

一些设置涉及到一个特定的项目 - 例如，项目翻译，版本控制配置，或文件的颜色。别人 - 像编辑器设置，键盘映射，或现场模板 - 属于你的整个工作环境，因而即使不打开的项目进行配置。

项目解释

Python解释器是至关重要的 - 没有它，你将无法做任何事情...... PyCharm会警告你，如果你设法创建一个项目没有翻译：

在PyCharm，您可以定义多个Python解释 - 他们只是包括口译人员的名单，可你的机器上。从他们中间，你可以选择在你的项目中使用的之一。

你需要告诉PyCharm你想使用它，因为它可以Python解释器使用一个不同的解释为每个项目：

PyCharm将利用这些信息进行索引。

您可以使用以下类型的Python解释器：

本地翻译

这是使用一个解释器的最直接的方法。你下载一个Python解释器，你的机器上安装它，然后指定的Python可执行...请参阅教程或产品文档。

远程翻译

随着PyCharm，您可以使用位于远程口译，例如，一个可靠的服务器上。这样做时，PyCharm使得能够经由配置远程口译SSH连接，或经由流浪框。

请参阅教程与PyCharm配置口译。

虚拟环境

我们为什么需要它？假设，你正在一个项目，它使用的，比如说，Django的1.6，并在同一时间支持其他项目需要的Django 1.2。在这种情况下，你需要的东西，让您的环境安全和一致的-即允许创建一个Python解释器的一个孤立的工作副本的工具。了解如何创建一个虚拟环境中的文档和教程。

包和路径

无论解释型的，PyCharm帮助安装和更新必要的包和路径。例如，当PyCharm自动检测到一些需要的包丢失或过时，它建议您安装或升级他们：

同样的事情发生的路径。如果您已经安装或升级库，它要重新扫描Python安装一个好主意。点击齿轮按钮

位于项目现场口译的权利，并选择更多。然后，在项目口译对话框中，选择翻译要查看路径，单击

，然后，在解释路径对话框，刷新包

：

查找详细的产品资料。

VCS

当然，你把你的源代码版本控制之下，对不对？Git的？SVN？善变？随着PyCharm，很容易建立起来，并再次IDE做得很好的自动检测已用于现有项目的VCS。

但是你可以微调-只需点击版本控制节点中的设置/ Preferences对话框（项目设置→版本控制）。默认情况下，你会看到项目的根目录而已，但你可以下来打破你的应用程序成小块，并把几乎所有的目录中它自己的版本控制系统下。

在设置/首选项对话框中，你也可以定义一些行为，是所有版本控制系统：确认在创建或删除的文件，在后台执行任务，忽略版本控制的文件等等。

请参见教程：

另请参见：: 与PyCharm版本控制版本控制程序

文件的色彩

你的项目可能包含几个站点，每一个与它自己的一套具有相同的名称（文件init.py，models.py，tests.py，views.py）。当他们在编辑器中打开，这是相当混乱......一个人怎么能告诉他们属于哪个网站？PyCharm有助于使他们脱颖而出画的编辑器选项卡（设置/首选项→项目设置→文件颜色）。打破你的项目分成更小的块-范围（例如，每个站点的范围），并选择为每一个颜色。

请参阅网页配置范围和文件色彩的细节。

IDE和编辑器

工作在IDE实际上是指居住在里面，这是很自然的让你困扰的地方觉着你的眼睛，舒适的手指。这就是为什么PyCharm能够选择的外观和感觉的IDE和编辑器，配置首选的快捷键设置（键盘映射），微调滚动行为，突出，等等。

建议以熟悉的文档中的事：

所有这些设置（再次）配置的设置/ Preferences对话框：点击

，看的IDE设置标题下的页面列表。这里有三个页面，可能是为启动的兴趣：外观，编辑器和键盘映射。

出现

请记住，你已经初步选定的外观和感觉你的IDE上的第一次启动？如果你不满意的结果，现在是时候改变你的想法。在页面设置/首选项→IDE设置→外观，您可以选择“外观和感觉”你PyCharm安装。只需单击外观和感觉下拉，选择你更喜欢的方案。你并不需要关闭设置/ Preferences对话框对话框来观察你的实验结果：单击Apply（应用），看看会发生什么，并关闭该对话框时，你很高兴与你有什么。

请参阅教程如何选择外观和感觉我PyCharm？，并以产品文档。

编辑

在一大堆的下页编辑器节点（设置/首选项→IDE设置→编辑器）可以帮助你调整编辑器的行为的各个方面。需要注意的是PyCharm自带的预定义的配色方案，但如果你想弥补一些非常个性化的，欢迎您来做到这一点：保存默认方案使用新名称，并开始改变它的背景，字体，语法元素的颜色，错误高亮等，并立即观察结果在预览窗格中。

请参阅教程如何更改编辑器的配色方案，并在产品文档。

键盘布局

你一起工作的的快捷键设置，是您最贴心的习惯之一-你的手指“记住”某些键的组合，改变这种习惯是相当痛苦。考虑到这一点，PyCharm为你提供各种预先定义的键盘映射（设置/首选项→IDE设置→键盘映射），对于那些喜欢谁的Eclipse，或为那些谁已经有长期的经验与Visual Studio ...你可以创建你自己的键盘布局的现有的基础上。

最后，有一个神奇的快捷按Ctrl +反引号，可以帮助计划（所有的人-键盘映射，颜色，码样式和L＆F）之间切换，而不设置对话框（仅适用于Windows和Linux用户）。

请参见教程配置键盘方案，并以产品文档。

外部编辑器

虽然你可以选择与你喜欢的编辑器（Emacs的，Vim的，是TextMate等）的任何键盘布局，你可能还是要在您的首选编辑器打开文件。您可以通过配置外部工具很容易地做到这一点。例如，您可能要打开在Emacs当前文件作为外部工具。

请参见教程使用Emacs作为外部编辑器的详细信息。

后台任务

有时，当一项艰巨的任务正在进行中，PyCharm显示进度条。你可以把这样的任务的背景，但仍然可以看到它是如何去的。请参阅网页工作与后台任务的详细信息。

写代码巧妙！

是什么让PyCharm从众多的集成开发环境中脱颖而出，是其全功能的编辑器。不管你做什么开发的源代码，PyCharm总是在手，帮助您创建无差错的应用。这里是智能PyCharm的编码辅助的简要介绍：

在发展的每一个阶段，使用代码完成（Ctrl +空格键），其中考虑到当前上下文。例如，根据你在哪里调用代码完成的地方，就可以完成关键字或代码块，推断类型，或完整的方法和属性。
请参考教程代码完成，并在产品文档的详细信息。
使用实时模板/片段（按Ctrl + J）或环绕模板（按Ctrl + Alt键+ J），产生整个代码结构。PyCharm配备了一系列准备使用的活动模板，或片段，您可以在设置/ Preferences对话框探讨（IDE设置→ 现场模板）。
如果你看到你所缺乏的东西特别重要的发展目标，扩展这套片段与自己的。不要错过也包围与完整的代码结构（可能性的Ctrl + Alt + T）。请参阅教程创建和应用活动模板（代码段），并在产品文档的详细信息。
几乎像一对程序员，PyCharm保持于你正在做的眼睛，并配备了智能的建议，这是标有红色或黄色灯泡的迹象。如果你想知道究竟有什么根据灯泡，单击它，或者按Alt + Enter键。这样，您就可以，例如，自动创建一个你已经在代码中使用，但尚未宣布的新方法。
参见教程快速修复和意向再次行动和产品文档的详细信息。

使用宏

这将是很好有机会与编辑器简化您的工作。使用宏仅仅是可能的方式之一。请参见教程使用宏，并在文档的详细信息。

有多个文件工作

正如你可能已经注意到，PyCharm打开在编辑器中一个单独的标签的每个文件：

PyCharm提供了一个方便的方式来各个选项卡之间切换，让寄托和取消固定每个选项卡，将编辑器选项卡沿任意窗口的四个边框的，分裂的编辑器选项卡，等等。

请参阅教程和文档节总编标签的详细信息。

透明地分析代码

PyCharm给你无数的暗示和提示，以帮助您避免失误，或纠正他们，如果他们发生。
首先，在您键入，你马上拥有所有语法错误强调用红色波浪线。如果放置插入符的一个错误的位置，你会看到这个问题的简要说明在提示，并且也是在左侧状态栏。除此之外，你看到红色条纹沿着确认栏，或标记栏。如果你在这样的条纹将鼠标指针，你看在提示的错误描述：

当您输入我们的代码，PyCharm，简直就像一对程序员，看起来你的肩膀上，并提出解决您的错误或只是改善你的代码，以显示你的红色或黄色灯泡（我们已经在节中提到他们已经编写代码聪明的！）。了解如何使用他们的教程和在产品文档。

下一个级别是静态代码分析，或代码检查：你的代码是不实际执行它进行分析。事实上，PyCharm检查上飞在当前文件中的代码，并显示检查结果的标记栏的彩色条纹。如果您看到右侧的IDE框架是明亮的红色条纹，当心-这意味着你的代码中包含严重的错误。那么重要的事情，建议，以改善代码，或警告，显示为黄色的条纹。针对当前文件的信息归纳在标记栏，这可以作为交通信号灯顶部的彩色指示灯：绿色表示一切都很好; 中的至少一个问题接通指示器黄色或红色。

顺便说一句，这家伙在状态栏 - 赫克托 - 保持目前在编辑器中打开每个文件的眼球。默认情况下，赫克托不夜城：

如果您确定自己的，把他关闭，你会得到既不警告，也没有提出改进意见或错误消息。

但是，您可能想看看更深入到应用程序的代码。在这种情况下，你必须检查整个项目，或任何部分（代号→检查码），并探讨导致检验工具窗口：

PyCharm配备了各种预先定义的检查; 熟悉和配置他们在检查页面设置/首选项。

另请参阅本教程语法高亮和错误指示。

创建质量代码

随着PyCharm，这是相当容易地创建高品质的代码 - 的IDE是一个代码质量工具本身。它集成了PEP8，看台上的代码的完整性后卫和报告的代码风格违法行为。

请参阅教程代码质量协助技巧和窍门，或如何使你的代码看起来漂亮吗？

另请参阅产品文档配置代码风格和代码检查。

查看文档

PyCharm能够为在插入符号的符号，查看现有文档。有几种可能的方式来做到这一点：

快速的定义
快速文档
外部文档
参数信息
错误说明

所有这些命令都可以从查看菜单，并通过键盘快捷键（下面的快捷键属于默认方案如果您使用的是一些其他的键盘布局方案，这些键盘快捷方式会有所不同。）：

请参阅教程查看文档和产品文档查看参考信息。

通过找到自己的方式

源代码

让我们先从查找文本的碎片。其中一个源代码导航和搜索的最基本手段是我们的老按Ctrl + F命令：开始输入搜索字符串，并立即得到它出现在当前文件中：

但PyCharm更进一步，并帮助您寻找一个特定的目录中的字符串，或者任意范围，或整个项目（Ctrl + Shift + F）：

除此之外，PyCharm提出了一种更为复杂的方法，即寻找用途。例如，如果你想从一个符号导航到它的用法1在您的应用程序，按下Alt + F7，或选择查找用法它的上下文菜单：

其实，有几个命令，可帮助您找出某个符号使用：您可以从一个使用跳到另一个当前文件（在按Ctrl + F7），在当前文件视图用法颜色编码（按Ctrl + Shift + F7），或通过在弹出列表（整个项目的Ctrl + Alt + F7）。

如果你想从一个符号跳到它的声明，只是中间点击其名称，或按Ctrl + B键。

要快速找到一个元素的名字，并在编辑器中打开它，使用导航弹出：按Ctrl键+ N（一类），按Ctrl + Shift + N（一个文件），或者按Ctrl + Shift + Alt键+ N（一个符号），并开始输入你要查找的名称。当你键入的名字相匹配的列表缩小，但是这仅仅是方便的设施之一：您可以使用星号通配符，全部大写的CamelHumps，或空格为snake_case名称，斜线的嵌套的文件夹等等，等等。

快速搜索是找到一个文件最简单的方法：用具有焦点的任何工具窗口，你刚开始打字，看看匹配的节点是如何在树视图中突出显示。

IDE组件

如何跨越IDE导航有很多，我们将简要概述只是其中的一些。让我们先从切换：按Ctrl + Tab键显示切换，这是PyCharm的工具窗户和打开的文件，然后列表，保持按Ctrl键不放，用Tab键或箭头键滚动到你想要的组件请访问：

如果您选择在IDE的组件之一的文件，要查看它在另一个（编辑，项目视图，导航栏，或变更），然后使用选择目标（Alt + F1）：

最后，不要忘了，按Esc键将带给你回到编辑器，无论你在哪里！

找到一个行动

你不需要在主菜单中调用一个动作-你可以简单地通过名字调用它。按按Ctrl + Shift + A，并输入字符，这，你的意见，应该是存在于动作名称：

注意，你可以不包括在主菜单的操作中搜索-只需按下Ctrl + Shift + A一次。

导航和搜索无处不在

PyCharm显示导航和搜索的新途径。双按Shift键，或单击

主工具栏右端，并看到搜索无处不在对话框。使用这种方法，可以寻找的源代码，数据库，动作，用户界面等。在一个单一的动作元素的任何项目。

请参见教程下探索导航和搜索，并在产品文档：通过导航源代码，并通过源代码搜索。

重构你的源代码

PyCharm提供范围广泛的重构，从单纯的重命名这些复杂的事情变的方法签名。需要注意的是PyCharm建议根据当前的情况下可重构：

运行，调试和测试应用程序

同时与PyCharm工作，你会来到一个时刻，当你需要运行或调试应用程序，脚本或测试。在所有这些情况下，你需要一个特别的配置文件，或运行/调试配置，它定义脚本的名称，工作目录，环境变量和其他重要的事情。

运行

您可以轻松地从上下文菜单中启动一个Python脚本，或者一个方便的快捷键Ctrl + Shift + F10。但是，如果你想使用一些其他的运行/调试配置，你必须选择一个主菜单，然后按下Shift + F10。

请参见教程运行援助代码，并在产品文档运行。

需要注意的是，你可以启动你的应用程序在本地和远程：PyCharm允许使用远程主机，虚拟机与流浪箱。

REPL控制台

PyCharm也帮助那些谁爱完全控制一个互动的控制台：在上工具菜单中，你可以发现，启动交互式Python或Django的控制台命令。在这里，你可以输入命令并立即执行。此外，PyCharm的互动控制台采用语法高亮，代码完成，并允许通过命令行的历史记录（滚动按Ctrl +上/下）。

PyCharm也能够从编辑器控制台源代码运行-只要让你的选择，然后按Alt + Shift + I（执行选择在控制台中选择的上下文菜单）。此功能详细探讨教程REPL -运行交互式控制台。另请参见产品文档与控制台工作。

本地终端

生活中不可缺少的命令行？OK，PyCharm有助于这一点。选择工具→打开终端在主菜单上，并享受：

请参阅产品文档的详细信息。

调试

哎呀...您的应用程序或脚本运行到一个运行时错误？要找出它的起源，你将不得不做一些调试。它开始将断点（相当简单 - 只需点击要出现断点的行左侧装订线），在该程序执行将被暂停，这样你就可以探索程序数据。

启动调试会话非常简单：要么使用特定的脚本的上下文菜单，或者选择合适的运行/调试配置，然后按Shift + F9。

最后，一个非常方便的方式来选择运行/调试配置，并立即启动它是Alt + Shift + F10 / Alt + Shift + F9。

请参阅教程调试，断点和调试运行，以及产品文档调试。

测试

这是测试您的应用程序是个好主意，和PyCharm帮助做尽可能简单。随着PyCharm，您可以：

创建测试类
创建特殊的测试运行/调试配置
运行和调试测试从一IDE
发掘结果在测试运行窗口

PyCharm支持所有主要的Python测试框架：单元测试，文档测试，Nosetest，py.test和证明。对于每一个这些框架，PyCharm提供了自己的运行/调试配置。

请参阅教程创建并运行一个Python单元测试，单元测试，以及产品文档测试。

远程开发

除了使用位于远程口译（我们的导游已经讨论过）的能力，你还可以远程发展。
首先，PyCharm，您可以在本地应用程序部署到一些偏远的服务器。要了解有关部署服务器，请参阅产品文档部分与Web服务器配置的同步。已经部署的应用程序，可以运行，调试和远程测试。PyCharm还可以帮助你比较本地和远程文件夹，并与部署在服务器上同步本地副本。

数据源和SQL支持

正如你可能已经注意到，创建各类（Django的，瓶等）的项目需要一个数据源。这也很可能是你注入SQL语句到你的源代码。

PyCharm不会使您能够创建数据库，但提供的设施来管理和查询它们。一旦您被授予访问某个数据库，可以配置在PyCharm一个或多个数据源，反映了数据库结构和存储的数据库访问权限。基于该信息，PyCharm建立与数据库的连接，并提供检索或改变其中所含信息的能力。