Quick Start With PyCharm（翻译）

欢迎来到 PyCharm 的世界，接下来这篇文章一定会让你掌握一些使用 PyCharm 的小技巧。

开始学习前

准备工作：

• 下载 Python 解释器并且进行安装，PyCharm 支持从 2.4 到 3.5 的所有 Python 版本

• PyCharm 总共有两个版本：社区版（Community ）和专业版（Professional）， 二者之间有一些 区别。

  注： 下载页面 包含了不同操作系统的软件安装说明， 大家可以根据个人情况自行选择。PyCharm 是一款跨平台的软件， 在 OS X、Windows、Linux 等系统上都可以完美运行。

---

初始化安装

• 当你第一次打开 PyCharm 时， 界面显示让你判断电脑上是否存在老旧版本的 PyCharm， 这里我们假设第一次使用， 没有旧版本的 PyCharm， 选择后点击 OK

• 下一步， 进入激活页面， 你需要填写自己的有效 注册码。

• 填写了注册码后， PyCharm 进入了初始化会话，这里你可以选择自己喜欢的快捷键套餐（keymap）、主题（theme）和基本配置（editor）， 点击下拉箭头 完成喜好选择。

注： PyCharm 有多种快捷键套餐以供选择，比如 Eclipse、Visual Studio、Emacs、 GNOME、 KDE等等， 可以在 Settings/Preferences 自行设置

• 如果初始化的时候你选择的快捷键套餐不合心意， 完全可以再次进行设置，想要了解更多关于 PyCharm 快捷键套餐的设置， 点击这里

  同样，你也可以随时根据喜好修改软件的 主题 和 基本配置

  PyCharm 还提供了针对 vi/vim/gvim 的一些插件 IdeaVim plugin， 这里是 说明文档 和 使用方法

---

在欢迎界面做基本配置

• 如果这是你首次使用 PyCharm， 你会以下看到 欢迎界面

• 点击 配置（Configure）， PyCharm 会显示下拉列表提供 settings/preferences, plugins, import and export settings 等设置选项。

  这个有什么用处呢？ 事实上当你每次要创建一个新的工程的时候都需要用到上述配置。

  举个例子： 你想要创建一个新的工程， 并且使用之前配置的 Python 解释器，那么你可以在 Default Project Settings 选项处进行 指定

• 提示：解释器被指定为一个默认选项， 在 PyCharm 中与默认选项都会用 图表标识（每个工程可以个性化选择）。

  举个例子: 设置编辑器代码行号显示，Settings/Preferences –> Editor –> Appearance –> Show line numbers:

• 如果你不满意现在的配色方案， 想要更改默认的配置， 很简单， 你需要先对默认配置做一个 备份， 然后对 备份配置 进行修改（PyCharm 不支持直接修改默认配置）

  当然你也可以设置文本字体的大小， Settings/Preferences –> Colors and Fonts –> Font 。同样， 要想设置先做 备份 （默认 Schema 不支持修改），设置好选择 OK 或者 Apply 就可以生效了， 之后创建的所有文本都会使用这个配置。

  你所有的设置都可以在预览板（Preview pane）上提前看到效果，设置满意后再选择 OK 或者 Apply 。

---

修改配置 Settings/Preferences

• 如果你想修改 IDE 的各种配置， 需要打开 Settings/Preferences 会话框（Ctrl+Alt+S）， 或者点击 main toolbar 上的 图标。

  举个例子，如果你想修改 IDE 的主题样式，Settings/Preferences –> Appearance , PyCharm 根据你的电脑提供了许多预定义的主题（IntelliJ、Darcula、Windows）

  主题修改：

  1. 在 main toolbar 上点击图标 或者快捷键：Ctrl+Alt+S
  2. Appearance and Behavior –> Appearance
  3. Theme 选项下拉列表选择喜爱的主题
  4. Apply 确认修改（有时要让修改生效需要 重启 PyCharm）

• 提示： 会话右上角的 Reset 链接可以回滚修改， 下端的 Apply 按钮可以确认修改。

  至此， 我们就完成了对 PyCharm 主题的配置修改，但是你还是对编辑器中代码的样式显示不够满意， 举个例子，可能你还想修改当前代码的高亮配置：

• 高亮配置

  1. 在 main toolbar 上点击图标 或者快捷键（Ctrl+Alt+S）
  2. Colors and Fonts –> General –> Editor –> Caret row 可以设置个性化高亮颜色
  3. 点击按钮 Save As…，并且输入新配色方案的名称。现在这个新的配色方案是可编辑的，你可以根据自己的偏好进行设置。
  4. 点击 Backgound 后面的小块可以打开具体的配色表。（color picker）， 配色方案非常丰富。

• 注：默认的配色方案不可以修改， 需要先创建一个备份：

• 配色表

• 另外你可能已经注意到一些选项后面有图标， 这意味着这些配置只是针对当前工程的， 没有上面图标的配置是针对整个工作空间所有工程的。

---

Appearance and Behavior 与 Editor 区别

• 前者是针对整个 IDE（IDE theme L&F）， 而后者只是针对编辑器（editor）的配置， 我们可以为整个 IDE 选一个比较暗的主题（比如 Darcula）， 而为编辑器单独选一个比较明亮的主题（比如 Default）， 这样整个 IDE 除了 Editor 之外的其它模块都呈现一个比较暗的样式， 而 Editor 是比较明亮的一个样式。

---

PyCharm 中的工程（Projects）

• 在 PyCharm 中， 一个工程就是包含源代码的一个文件夹，PyCharm 中有一个一个内置的目录叫做 .idea, .idea 目录中存放了 PyCharm 所需要的所有必要信息， 在软件的工程视图（Project view）是看不到这个目录的。其实从用户的角度来看， 一个工程就是一个存放源代码的文件夹。

  在 PyCharm 中创建一个新工程（File –> New Project）或者打开一个工程（File –>Open） 的时候， 都会让用户自己选择，是在一个新窗口打开， 或者是在一个单独的窗口打开， PyCharm 中多个窗口的工程互相独立、可以并行开发。

  你可以在同一个窗口中创建多个工程， 这样做的话， 第一个工程就被当作主工程（primary project），其它工程的图标都会显示在当前窗口的工程视图里， 用户可以随意切换。

  另外，PyCharm 支持创建许多不同类型的工程： Python, Django, Flask, Pyramid, web2py, Twitter Bootstrap, HTML5 Boilerplate 等等， 创建的时候你可以自行选择你需要的工程类型。

• 如上图所示， PyCharm 支持几乎所有基于 Python 的框架， 当创建一个指定类型的工程时， PyCharm 会为你生成对应的文件和工程目录结构。

---

个性化配置

• 点击最上方工具栏， 打开配置会话栏， File –> Settings/Preferences ， 或者快捷键（Ctrl+Alt+S）， 在这里你可以改变工程的结构， 设置版本控制， 调整工作环境，配置出适合自己的工作空间。

• 解释器

  Python 的解释器对于开发是至关重要的， 没有它你什么都没法做。。。

  如果你想要创建工程但是没有指定解释器的时候， PyCharm 会做出以下提示。

• 在 PyCharm 中，可以定义 多个解释器， 当创建工程的时候可以从中选择一个合适的使用。

  当然， 你必须告诉 PyCharm 你想要使用的解释器， 因为在 PyCharm 中多个工程可以使用不同的解释器：

• PyCharm 会根据你的配置为当前工程分配指定的解释器。

• 使用 Python 的解释器

  1. Local
  2. Remote
  3. Virtual environments

• 本地解释器

  这是最直接的一种使用方式，下载一个 Python 解释器，在本地机器上进行安装，并且在配置中进行指定就完成了。

• 远程解释器

  使用 PyCharm，可以使用远程服务器上的解释器，这样的话，可以远程通过 SSH connection、Docker、Vagrant box对解释器进行配置。
  查看详情

• 虚拟环境

  为什么我们需要这种配置方式呢？举个例子， 假设你现在正在开发一个项目需要使用 Django 1.6， 与此同时，另一个项目需要使用 Django 1.2， 这个例子中，你需要保证当前项目的运行环境安全、稳定，这时虚拟机可以帮你另外单独创建一个 Python 解释器的备份。
  查看详情

• Packages and paths

  除了解释器的类型，PyCharm 还会帮我们安装和更新必要的 包 和 环境变量， 举例来说，PyCharm会自动进行检查，一旦发现有工具包丢失了或者不是最新版本的，就会提示安装升级，显示出一个向右的箭头

  关于环境变量，如果你安装或者升级过工具包，那么很有必要重新扫描一下看看有没有丢失或者过时，点击右边的齿轮按钮， 并且选择 More，然后在工程解释器会话框（Project Interpreters）选择一个你想要设置环境变量的解释器版本，点击环境变量设置按钮 ，然后点击更新按钮完成配置。

• 版本控制（VCS）

  团队开发中我们常常会使用到版本控制软件，比如 Git,SVN,Mercurial（一种轻量级分布式版本控制系统），使用 PyCharm 我们可以很容易的进行配置，并且 IDE 会自动识别当前工程已经使用的版本控制系统。

  但是你也可以自行调整，Settings/Preferences –> Version Control

• Local history

  除了传统的版本控制外，还可以使用 Local history，PyCharm会自动的记录你对源代码的修改，测试，编译，提交，更新。

• File colors

  工程里面可能会包含多个站点（sites），多个站点可能存在许多名字相同的文件（init.py,models.py,tests.py, views.py），当它们都在编辑器中打开的时候，会让人感到困惑，怎样才能很好的识别出文件所属的站点呢，PyCharm会给每个站点文件的标签栏设置不同的颜色，根据标签栏颜色就可以识别出文件所属站点。

  （Settings/Preferences –> Appearance&Behavior –> File Colors）

• IDE and Editor

  选择一款 IDE 就好像选择一个居住环境一样，舒适自然对于一个想要专心于工作的程序员来说非常重要，工欲善其事，必先利其器，这就是为什么 PyCharm 提供了这么多个性化的设置：软件界面风格选择、编辑器风格选择、快捷键选择、滚动栏、高亮调整等等。

• Appearance

  Settings/Preferences –> Appearance&Behavior –> Appearance，之前第一次打开 IDE 的时候我们设置了软件的界面风格，如果当初设置的不满意，这个地方可以进行调整。设置的时候不需要关闭会话框才能看到效果，只需要点击Apply就可以预览效果，如果感觉满意，点击OK，完成设置。

• Editor

  在这里你可以设置有关编辑器页面的所有方面，虽然 PyCharm 缺省了编辑器的样式风格，但是它依然支持个性化的设置，可以根据自己的喜好选择喜欢的字体、颜色、高亮显示等等

• Keymap（快捷键）

  PyCharm 支持自由度非常高的快捷键设置，因为快捷键操作是程序员长期使用 IDE 开发中养成的非常难以改变的习惯，每个人都有自己的喜好，PyCharm提供了多种快捷键方案供用户选择，无论你是 Eclipse 或者是VisualStudio 的死忠粉，都可以找到属于自己的个性化快捷键配置。

• External editor

  虽然你选择了你喜欢的编辑器对应的快捷键配置方案，但是你可能仍然希望直接使用自己喜欢的编辑器中打开文件，没关系，PyCharm完全可以满足你的需求，但需要配置第三方的工具。
  查看详情：Configuring Third-Party Tools ，Using TextMate Bundles

---

Background tasks（进度条）

• 任务进度条，当一个任务执行的过程中，PyCharm提供了一个 进度条 方便查看 。

---

Work with multiple files（多文件展示）

• 在编辑器界面展示多个文件时，PyCharm支持文件间随意切换，而且可以锁定解锁文件（打开文件达到一定数量会自动关闭，可以配置），或者将多个文件并排显示。

Find your way through（搜索查找）

• 如果你已经知道如何使用 PyCharm 开始工作了，那么现在你需要了解一下 PyCharm的导航栏元素， 这样你就不会因为找不到一些必要的东西而影响效率。

• Search everywhere

  在导航栏中查找功能是大家最熟悉也是最常使用的功能，我们经常需要查找 class, file, action 或者一个 IDE setting，双击 Shift 键或者点击软件右上角放大镜图标可以开始查找。

• Search for project elements

  View –> Tool Window –> Project tool window
  工程窗口是最重要的一个窗口，我们通过上述方式可以打开工程窗口，窗口中有源代码的文件和目录树，当然也可以直接使用快捷键（Alt+1）

  Alt+7： 打开文件内容结构（Structure）
  Alt+F12：打开控制台（Console）

• 搜索类，文件（可以使用通配符）

• Search for code elements

  Ctrl + F： 在文件中搜索相关内容
  Alt+7：文件结构

• 注：上述许多快捷键都是根据自己的 keymap 来说明的，每个人的可能有所不同，需要自己去配置中查看， 本机使用 Eclipse 快捷键

• IDE components

  PyCharm 提供了 很多方式 可以操作导航元素，你可能一下子记不住这么多快捷键操作， 没关系，不用担心，你需要的时候你可以在 Help –> Find Action（Ctrl+Shift+A）中搜索。现在，我们给出一些常用的快捷键操作：

  Ctrl+Tab： 导航元素切换器， 可以在各个元素之间任意切换（功能强大）
  Ctrl+E ：查看当前文件的整体结构
  Ctrl+Shift+E ：查看最近修改的文件
  Alt + F1 ： 可以查看当前选中代码行对应的各种导航元素
  Ctrl+Shift+F12： 相当于最大化编辑器，关闭其它导航元素

---

Code with smart assistance

• PyCharm 最厉害的功能是它的代码智能分析，你编写代码的时候，它会随时处于监督状态，一旦发现错误马上给出提示，可以保证我们编写的代码不存在不必要的语法错误。