快速入门指南

欢迎PyCharm！这个简短的指南旨在帮助您在IDE中的抓地力。

在你开始之前

确保满足以下前提条件：

Python解释器下载并安装到电脑上。
如果没有，请按照下列下载和安装说明。

PyCharm从2.4版本支持Python到3.5版。
PyCharm下载并安装到电脑上。

介意PyCharm是两个版本：社区版和专业版。该版本之间的差异进行了探讨版本比较矩阵。

请注意下载页面中包含各种平台的安装说明; 这些指令可以在不同的操作系统而有所不同。

PyCharm是跨平台的，并适用于Windows的Mac OS X和Linux。

初始配置

当您启动PyCharm的第一次，系统会询问你是否有一个以前的版本并做什么用的设置。对于本教程的目的，假设没有以前的版本，然后单击OK：

接下来，你得到的PyCharm许可证激活对话框，在那里你必须指定特定的许可证：

您指定许可证后，PyCharm显示初始设置对话框。在这里，你可以选择键盘布局，并要使用IDE和编辑的主题。点击向下箭头

（点击显示预览）来评估你的选择将是什么样子：

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

如果以后你决定你的键盘映射表的最初的选择是错误的，你可以随时更改设置。要了解更多关于配置的键盘映射，请参考配置键盘快捷键。

您还可以更改IDE主题和编辑的主题后。

还有一个IdeaVim插件为PyCharm提供VI / vim的/ gvim的仿真。请按照以下说明进行安装，并学习如何使用它在这里。

从欢迎屏幕设置默认值

同样，如果这是你的第一个启动（或者如果你没有打开的项目），你看到欢迎屏幕：

如果你点击配置，PyCharm显示，建议您配置设置/首选项，插件，进口和出口的设置，并检查更新下拉列表中。选择设置/首选项，并查看设置/首选项对话框。看看这个对话框-它的头默认设置/首。

这是什么意思？这些设置将用于每次创建一个新的项目时间。

例如，你想你新创建的项目使用相同的解释一切- OK，你可以定义这样一个解释器中默认的项目设置：

需要注意的是解释设置涉及到一个默认的项目，都标有图标

。

编辑器设置涉及到你的工作环境。

例如，要始终在编辑器中显示的行号。在设置/ Preferences对话框中，展开节点编辑，并在外观页面，选中该复选框显示行号：

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

还可以设置您的首选字体大小编辑器-这是在字体页面下进行颜色和字体的设置/ Preferences对话框节点。同样，你必须首先创建计划的副本，如果你还没有这么做过，然后指定为编辑器所需的字体大小。这种字体大小将适用于当前编辑器选项卡和所有新开的编辑器。然而，它不影响IDE组件的字体大小。

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

更改设置/首选项后

要更改IDE的项目中的外观和感觉，并且编辑器配色方案，你必须打开设置/首选项（按 ⌘，或点击

该图标上主工具栏）。

例如，你想改变IDE的外观（主题）。需要注意的是PyCharm带有一些预先定义的主题。一组可用的主题取决于您的平台。您可以找到您所选择的主题外观的页面设置/首选项对话框。

这是你如何更改IDE主题：

在主工具栏上单击，或按⌘，。
展开外观和行为节点，然后单击外观。
在外观页上，选择从下拉列表中喜欢的主题主题：
注意链接复位出现在对话框顶部-如果你改变了主意，点击滚动更改回。另外要注意的按钮应用，当你将鼠标指针悬停在它认为将启用：

您还可以更改定义PyCharm的外观和感觉的其他设置，例如，Windows的行为。
应用更改。你可能会建议重新启动IDE（例如，当您更改主题，或Darcula）。

OK，PyCharm的主题已经改变，但你仍然不满意自己的代码编辑器中的外观。例如，你想为当前行的另一个高亮颜色。我们开始做吧。

再次，主工具栏上单击打开设置/首选项对话框中，展开节点编辑器，然后单击颜色和字体。
需要注意的是，你不能改变你预先定义的配色方案 - 你必须先创建一个副本：
点击按钮另存为...，然后输入你的新的配色方案的名称：
这种新的配色方案是可编辑的，你可以用它来改变自己的口味进行。
根据颜色和字体节点，单击常规，在组件列表，展开编辑节点，并找到该项目插入符行。
点击背景颜色片段打开拾色器：
在此对话框中，挑选所需的新颜色，然后单击选择。

顺便说一句，你已经注意到，一些节点都标有

。这意味着，在这些网页上所定义的设置涉及到当前项目。没有该图标的页包含属于整个工作环境设置。

在L＆F主题和编辑的配色方案之间的差异

介意的区别IDE主题（外观和感觉）和编辑器的配色方案。前者涉及整个IDE中，而后者只涉及编辑器。这是完全有可能的IDE（例如，默认或合金）以及编辑器的深色方案之一（例如，黄昏或Monokai）光的主题。这样做时，所有的PyCharm组件将一种颜色方案来呈现，而在不同的一个编辑器窗格：

与项目工作

你PyCharm所做的一切，你的范围内做项目。

在PyCharm，一个项目是包含源代码的目录，和与名称嵌套目录 .idea。该目录.idea就是PyCharm存储所有必要的信息的地方-它不是在可见的项目视图（请参考项目，IDE设置为详细信息）。但从用户的角度来看，一个项目只是包含一些Python代码的目录。

什么是最有趣的PyCharm项目管理，是其开放的能力的多个项目在一帧。当你创建一个新的项目（文件|新建项目），或打开一个现有的（文件|打开），PyCharm建议你选择你想要的项目要打开这道：在新窗口中，在同一个窗口关闭后，先前打开的项目，或添加到先前打开的项目。

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

详细内容请参照创建和管理项目的详细信息。

作为练习，创建一个新的空项目，在这里你可以开发一些纯Python代码。这种情况下，在详细的教程中讨论创建并运行你的第一个Python项目。

顺便说一句，PyCharm建议创建不同类型的项目：Python和Django的，瓶，金字塔，web2py中，Twitter的引导，HTML5样板等，您可以自己探索可用的类型，创建一个新的项目时：

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

定制一切为您的项目！

看主工具栏-有一个设置按钮

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

一些的设置涉及到一个特定的项目-例如，项目翻译，版本控制配置，或文件的颜色。它们被标记

。其他人-如编辑器设置，键盘映射，或实时模板-属于你的整个工作环境，因此即使不打开的项目进行配置。

项目解释

Python解释器是至关重要的 - 没有它，你将无法做任何事情...

PyCharm会警告你，如果你管理没有翻译创建一个项目：

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

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

py_project_interpreters_for_different_projects

PyCharm将利用这些信息建立索引。

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

本地解释

这是使用一个解释器的最直接的方法。你下载一个Python解释器，你的机器上安装它，然后指定Python可执行程序...查看配置的Python SDK的详细信息。

远程口译

随着PyCharm，您可以使用位于远程口译，例如，一个可靠的服务器上。这样算下来，PyCharm使得它可以配置通过远程口译 SSH连接，通过配置通过远程泊坞窗口译或放浪箱。

请参考配置远程Python解释详情。

虚拟环境

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

包和路径

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

。

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

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

，然后在翻译的路径列表，刷新

：

发现在部分细节安装，卸载和重装解释路径和安装，卸载和升级软件包。

VCS

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

但是你可以微调-只需单击版本控制在设置/ Preferences对话框节点。默认情况下，你只会看到项目的根目录下，但您可以向下打破你的应用程序分成小块，和每个目录几乎把自己的版本控制系统之下。

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

请参考下部分版本控制与PyCharm了解详细信息。

当地历史

除了传统的版本控制系统，你可以使用当地的历史。随着地方史，PyCharm自动跟踪您的源代码基于一组预定义的事件（测试，部署，提交或更新）的变化，重构的结果，和源代码的状态。当地历史始终启用。

文件的色彩

您的项目可能包含几个站点，每一个与它自己的一套具有相同的名称（init.py，models.py，tests.py，views.py）文件。当他们都在编辑器中打开，这是相当混乱......一个人怎么能告诉他们属于哪个网站？PyCharm有助于使他们通过绘画的编辑器选项卡中脱颖而出（设置/首选项|外观和行为|文件颜色）。

你的项目分解成更小的块- 范围（例如，每个站点范围），并选择每一个颜色。

请参阅网页配置范围和文件颜色的详细信息。

IDE和编辑器

在IDE工作实际上是指生活在其中，这是很自然，让您的闹鬼地方觉着你的眼睛和舒适你的手指。这就是为什么PyCharm使得可以选择的外观和感觉，IDE和编辑器，配置首选的快捷键设置（键盘布局），微调滚动行为，突出，等等。

建议以熟悉的路段此事项目和IDE设置和配置设置。

所有这些设置都（再次）配置在设置/ Preferences对话框：单击

以打开此对话框，并查看页面列表。这里有三个页面，可能是为启动兴趣：外观，编辑器和键盘映射。

出现

记住，你最初所选择的外观和感觉上的第一次启动你的IDE？如果你不满意的结果，现在是时候改变你的想法。在页面外观页（设置/首选项|外观和行为|外观），您可以选择“外观和感觉”你PyCharm安装。只要按一下外观和感觉下拉，并选择适合你更好的方案。你并不需要关闭设置/ Preferences对话框来观察你的实验结果：点击应用，看看会发生什么，并关闭该对话框，当你与你有什么非常高兴。

编辑

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

请参阅部分配置项目，IDE设置和 PyCharm编辑器。导游了解详情。

键盘映射

你一起工作的的快捷键设置是您最贴心的一个习惯-你的手指“记忆”键的某些组合，并改变这种习惯是相当痛苦的。考虑到这一点，PyCharm具有广泛的预先定义的键盘映射（耗材您键盘映射），为那些喜欢谁的Eclipse，或为那些谁已经与Visual Studio的长期经验...你可以创建你自己的键盘映射现有的基础。

最后，还有一个神奇的捷径^`，帮助您计划（所有的人-的键盘布局，颜色，码样式和L＆F）之间切换，而不会设置对话框（仅适用于Windows和Linux用户）。

请参考配置的键盘快捷键的详细信息。

外部编辑器

虽然你可以选择与你喜欢的编辑器（Emacs的，Vim的，TextMate的，等等）的任何键盘布局，您可能仍希望在您的首选编辑器打开文件。您可以轻松地通过配置外部工具做到这一点。例如，您可能想用Emacs打开当前文件为外部工具。

请参阅配置第三方工具和教程：使用捆绑的TextMate详情。

后台任务

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

使用宏

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

使用多个文件

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

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

请参阅文档部分管理编辑器标签的详细信息。

找到你的方式通过

现在，当你知道如何下手PyCharm工作，它的时间来看看它的导航功能。他们会帮助你不会迷失方向，也将提高您的工作效率。

搜索无处不在

搜索是肯定的是用于快速导航最熟悉的和必要的选项。随着PyCharm您可以搜索任何类，文件，动作，甚至一个IDE中设置只有一个动作。双按Shift键或点击放大镜图标玻璃

在PyCharm窗口的右上角：

搜索项目元素

项目概述要素的基本工具是Project工具窗口（查看|工具的Windows | Project工具窗口）。它显示了你的项目文件和目录树。要访问它，点击工具栏的窗口图标或按 ⌘1：

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

搜索代码元素

导航和搜索源代码的基本方法是⌘F。开始键入搜索字符串，并获得它的出现在当前文件：

导航围绕当前文件的最终办法是使用文件结构视图（⌘7或 ⌘F12），并通过它搜索：

除此之外，PyCharm建议一个更复杂的方法，即寻找用途。例如，如果你想从一个符号的应用程序，请在浏览到它的用途之一⌥F7，或选择查找使用实例它的上下文菜单上，并观察结果查找工具窗口：

使用“转到”行动导航到一个声明（⌘B），实现（⌥⌘B），类型声明（⇧⌘B），或超法（⌘U）。

请参阅部分搜索通过源代码，并通过对源代码导航的详细信息。

IDE组件

有很多方法在整个IDE导航。你可能不记得所有的动作和菜单命令周围的第一次，这是确定。别担心！你需要的任何IDE行动的任何时候，你可以找到它帮助| 查找动作... （⇧⌘A），或使用无处不在的搜索。所以，让我们简单介绍一下一些主要的命令。

让我们先从切换：按^⇥显示切换，这是PyCharm的工具窗口和打开文件，然后列表，保持 按Ctrl键按下，使用Tab键或箭头键滚动到你想去的组件至：

按⌘E看到最近的文件列表。按 ⇧⌘E看到最近编辑过的人的名单。

如果您有多个IDE窗口打开，使用⇧⌘`和 ⌘`快捷键在它们之间切换。

如果您在IDE组件之一选择一个文件，并希望在另一个（编辑器，项目视图，导航栏，或变更）进行查看，然后使用选择目标（⌥F1）：

最后，按⎋将带您回到编辑器，无论你在哪里。 ⇧⌘F12将隐藏所有的工具窗口，只留下编辑器。

智能辅助码

PyCharm是著名的智能代码分析功能。不管你做什么开发的源代码，它总是在手，帮助您创建没有浪费时间无差错的应用程序。

编辑并编写代码

在发展的每一个阶段，任何文件，尝试使用代码完成（^Space），其中考虑到目前的情况下。根据你调用这个动作，就可以完成关键字或代码块，推断类型，以及更多：

享受实时模板/代码片段（⌘J）或环绕模板（⌥⌘T）产生整个代码结构：

PyCharm配备了一系列准备使用的活动模板，或片段，您可以在探索动态模板的页面设置/首选项对话框。如果你看到你少了点什么特别重要，你的发展目标，扩展这套片段与自己的。

不要错过也完全代码结构环绕的可能性（选择代码|环绕有了或按⌥⌘T）。

PyCharm帮助你按照代码风格指南。所有的新代码是根据代码风格设置自动格式化（设置/首选项|编辑|代码样式）。然而，您可能需要格式化的部分代码或应用在代码风格设置所做的更改。要做到这一点，使用代码| 重新格式化代码... （⌥⌘L）。

分析代码

我们是开发商，只花20％的时间我们编写新的代码，但高达80％，改善现有的代码。为了帮助您避免错误和更快的纠正，PyCharm给你以最好的开发实践无数的暗示和提示。

首先，当你键入，你马上有一个红色波浪下划线标出所有的语法错误。如果放置插入符的一个错误的位置，你会看到问题的简短描述的工具提示，并也在左侧状态栏。除此之外，你看到沿着红色条纹验证栏或标记栏。如果你将鼠标指针悬停在这样的条纹，你看到工具提示错误描述。

当你输入你的代码，PyCharm，像一双勤劳的程序员，不断目前你在做什么密切关注。此外，IDE提供了智能的建议，也被称为意向的行动，这是标有

或

图标。点击这样的图标，或按⌥⏎ 自动创建您尚未宣布的新方法，解决一个if / else语句，以及更多：

下一个层次是静态代码分析或代码检查：你的代码，而无需实际执行它进行了分析。实际上，PyCharm检查在上即时当前文件代码，并示出了在标记栏作为彩色条纹的检测结果。如果你看到你的IDE框架的右侧是明亮的红色条纹，请注意-这意味着你的代码中包含严重的错误。不太重要的事情，建议，以改进代码，或警告，显示为黄色条纹。当前文件信息汇总在标记栏，它的工作原理交通灯顶部的彩色指示灯：绿色表示一切都很好; 至少一个问题接通指示器黄色或红色。

有时候你需要更深入了解你的代码。在这种情况下，你必须检查整个项目或任何部件（代码|检查代码），并探讨在成果检验工具窗口：

PyCharm配备了多种预定义的检查。所有这些都说明，并可以在打开或关闭，或配置为需要检查的设置/首选项对话框的页面：

为了帮助你做出你的源代码少纠结，更具可读性，PyCharm提供搜索重复整个项目或它的一部分（代码|找到重复...）。看看在检测到重复片段重复工具窗口，并决定与他们做什么。

更多的部分代码审查，意向操作和分析应用。

创建高质量的代码

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

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

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

查看文档

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

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

重构安全

检查你的代码后，你可能有兴趣在由PyCharm提供的代码重构。该IDE可帮助您安全地重命名，提取方法，超类和模块，引入变量，常量，参数，等等。使用重构| 重构这个... （^T）查看可用于当前的代码片段都重构。

运行和调试应用程序

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

运行

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

具体请参考运行的详细信息。

REPL控制台

PyCharm还可以帮助那些谁爱一个交互式控制台的完全控制：在上工具菜单中，可以发现，启动交互式Python或Django的控制台命令。在这里，你可以输入命令并立即执行。此外，PyCharm的交互式控制台采用语法高亮，代码完成，并允许查看命令的历史记录（⌥⌘E或向上/向下箭头，而在编辑器中）。

PyCharm也使得人们有可能从编辑器控制台源代码运行-只要做出选择，然后按⌥⇧E （执行控制台中选择该选项的上下文菜单）。

见与控制台工作的详细信息。

本地终端

生活不能没有命令行？OK，PyCharm有帮助了。点击终端工具窗口按钮或按⌥F12并享受：

见与嵌入式本地终端工作。

调试

抱歉...您的应用程序或脚本运行到一个运行时错误？要了解它的起源，你将不得不做一些调试。它以设置断点（相当简单 - 只需单击您希望断点出现线的左侧装订线），在该程序执行将被中止，所以你可以探索的程序数据。

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

请参考调试。

测试应用程序

这是测试你的应用程序是一个好主意，和PyCharm帮助做尽可能简单。

随着PyCharm，您可以：

创建测试类
创建特殊的测试运行/调试配置
运行并从IDE调试测试权
探索测试运行窗口结果

PyCharm支持所有主要的Python测试框架：

对于每个框架，PyCharm提供它自己的运行/调试配置。

参见测试和测试框架。

远程开发

除了能够使用位于远程口译（这是我们的指南中已经讨论过）的能力，你还可以远程发展。

首先，PyCharm，您可以部署本地应用程序到某些远程服务器。要了解有关部署服务器，请参考配置同步与Web服务器。

已经部署的应用程序，可以运行，调试和远程测试。PyCharm还可以帮助您比较本地和远程文件夹，并与部署在服务器上同步本地副本。

数据来源和SQL支持

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

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

见数据库和SQL查询。

多语种IDE

PyCharm功能全面的多语言支持。您可以开发不仅纯Python代码，而且JavaScript的，CoffeeScript中， HTML，XML等。这样算下来，多数强大PyCharm的编码援助（代码完成，语法和错误高亮，代码分析，意向行动和快速修复，更多）可用于支持的语言。请参阅相应语言的PyCharm文档页，详细了解支持的范围。

随着PyCharm，你不仅可以创建JavaScript代码，但调试它了。查找细节的JavaScript特定准则，并在教程教程：使用PyCharm调试JavaScript 。

这就是它！

在这里，我们给出了一些重要的PyCharm设施非常简洁的概述，只是给你一个快速启动。有迹象表明，可以使您的生活更轻松，你的源代码更好和更清洁的许多重要功能。

享受PyCharm发展！