Pycharm学习教程(2) 代码风格

如何创建一个Python工程并使其具有Pycharm的代码风格,具体如下

1、主题

  这部分教程主要介绍如何创建一个Python工程并使其具有Pycharm的代码风格。你将会看到Pycharm使你的源码变得非常简洁美观,带有合适的缩进、空格等等,因此Pycharm也是一款代码质量管理的利器。

  这部分教程并不会介绍如何使用Python进行编程,更多有关Python编程的知识请参照:Python编程

2、准备工作

  在开始之前,请确认一下情况:

  (1)安装了Pycharm2.7或更高版本的软件

  (2)已经新建了一个Python工程(File→New Project),详情参照:Pycharm新建工程文件

  (3)已经在工程下添加了两个目录:src和test_dir(File→New or Alt+Insert),详情参照:Pycharm新建工程文件

  (4)已经向工程目录下添加了对应的Python文件(File→New or Alt+Insert),详情参照:Pycharm新建工程文件

3、代码报错的高亮模式

  打开一个新建的Python文件进行编辑(F4),这个文件中默认有两行代码:作者姓名和工程名称。之所以会出现这两行代码,是因为Python文件在创建时是基于文件模板进行创建的,因此会预定义这两个变量。

  接下来输入关键字class,当你开始输入时,Pycharm的拼写提示机制会立即列出候选项来帮助你完成代码:

  (参照Pycharm拼写提示来了解Pycharm更多关于拼写提示的信息)

  这个红色波浪线标记了下次代码输入的期望位置,在这种情况下,它是一个预输入定义符。键入类名Solver,红色波浪线将会移动到类名之后。如果你将术鼠标指针悬停在波浪线上,将会看到所提示的错误信息("Colon expected"),当然,此时位于右侧滚动栏的红色标志也会给出相同的错误信息。

  OK,输入冒号,回车。根据Python代码风格标准,需要定义下一个类声明,当然此时我们可以通过输入空格来取消它。

4、聚焦PEP8代码风格检查

  然而,在默认情况下这些警告提醒是不可见的,所以首先需要做的就是提升它们的优先级以进行显示。单击设置按钮,然后在Settings/Preferences对话框中的 Inspections页面,键入PEP8来找到所有相关选项,在对应的下拉菜单中选中warning选项:

  单击应用,关闭对话框,返回源码编辑界面。

5、详解PEP8代码风格

  现在Ptcharm已经能够正常显示它的代码规范,确保你编写的代码格式的完整性。接下来当我们输入下一条语句(例如def demo(self,a,b,c):),Pycharm将根据PEP8的代码规范机制来报告当前存在的格式问题。

  正如你所见到的那样,Pycharm将其所支持的PEP8规范设置为默认的正规Python代码格式标准。如果你打开inspections的列表,(Ctrl+Alt+S→Inspections),可以看到Pycharm在你的代码中加载了pep8.py工具,用来精确定位你的代码风格问题。

6、代码检查以及相关设置

  顺便说一下,如果你仔细观察Inspections page页面中inspection profile的缺省设置(如果你是第一次进行设置的话)会发现,Pycharm已经将所有的代码规则用于当前的工程中了。

  接下来我们对代码检查机制做两方面的改动:

  (1)在测试脚本中,将拼写错误标记为绿色

  (2)在说明文档(注释)中,将拼写错误改为红色提示

  接下来我们一一进行介绍

7、创建一个作用域

  首先我们需要创建两个作用域用来进行两个不同应用范围的设置。单击设置按钮进入 Settings/Preferences对话框,打开Scopes页面,单击上方绿色的加号来创建一个局部类型的作用域:

  在Add New Scope对话框中,键入作用域名称,然后在工程管理器(树型结构)中选择需要包含到当前作用域中的目录:test_dir,注意此时的Pattern栏已经自动显示加载路径:

  重复上述步骤再新建一个Production作用域。

8、在新建的作用域中创建代码检查控制文件

  接下来,创建一份缺省代码控制文件的拷贝文件(处于安全考虑):

  然后在对它进行命名,例如我们这里命名为MyProjectProfile。这个新的配置文件是之前默认缺省配置文件的复制版,两者的设置内容完全相同。

  接下来选中我们拷贝的代码控制文件,定位到Spelling项进行相应改动。为了快速找到Spelling选项叶,只需在搜索栏中输入Spel即可。

  然后通过单击绿色的加号来添加我们之前新建的Test作用域,然后再次单击添加Production作用域:

  在Test作用域中,代码检查的严格等级如图中左侧所示,Production作用域中有类似设置,不过所选择的下拉列表中的安全等级不同:

  留意对话框中作用域名称的字体颜色,如果为灰色则说明未做改动,若是蓝色则说明已经更改了相关设置。

  应用更改设置然后关闭对话框。

  此时,按照要求修改后的配置文件已经完成,名为MyProjectProfile,其在Test作用域和Production作用域中有不同的拼写检查设置。接下来我们将这个配置应用于对应代码区域,在主程序菜单中选择Code→Inspect Code,在对话框中指定已经定义好的作用域和配置文件:

  当然我们需要操作两次,因为有两个定义域需要进行相关配置的更改,并且可以将相关的配置清单导出

  比较一下这两个作用域的拼写检查结果:

  正如你所见,在Production作用域为红色波浪线,在Test作用域为绿色波浪线。

9、错误提示的高亮代码显示

  除此之外,Pycharm还会根据配置文件控制,对当前的一些错误进行高亮显示处理。

  举个例子,如果你的拼写检查配置文件中包含"Unresolved references"这条检查规则,同时你又使用了一条尚未进行import的符号,Pycharm就会用下划线标出无法解释的符号来提示你导入相关模块:

  参考auto-import tutorial来完成相关模块的导入工作

10、快速成型以及多次提示

  你是否已经注意到在代码左端经常出现一个亮起的黄色或者红色的灯泡然而你却并不希望看到它?

11、源码自动生成

  Pycharm提供了很多代码自动生成机制,你可以参照product documentation中有关自动生成代码的介绍:Auto-generating code,接下来我们探讨一下Pycharm的主代码生成机制。当然我们需要先将 Solver.py中已有的内容删除,重新开始。

  首先,创建一个类实例:

  OK,Pycharm成功创建出了一个类:

  接下来我们向类中添加一个成员方法,为了达到这个目的,首先需要在类实例后面输入一个点号,然后键入成员函数名称。此时这个成员函数是未定义的,因此Pycharm会提示我们来创建一个:

  然后在函数体中手动输入源码,例如我们输入一段计算二次方程判别式的程序,其中有一个函数sqrt()来自math模块,但目前尚未被包含,我们继续输入,看Pycharm如何解决这个问题:

  因此,我们源码最终如下:

  然而,代码缺少一些重要的逻辑分析。我们需要分析判别式结果d,如果它是零或者正数,则正常求解方程的根;如果其为负数,我们需要抛出一个异常,Pycharm会如何帮助我们完成这个任务?

  让我们用if语句来包含一块代码,即选中当d为非负数时需要执行的语句:

  然后按下Ctrl+Alt+T,或者单击主菜单中的Code→Surround With选项,Pycharm将会弹出一个下拉菜单,显示当前情况下可用的范围控制结构:

  选择if选项,Pycharm会自动添加if True:语句到选中的行:

  这里我们并不对布尔表达式做过多解释,根据需要我们直接将True替换成d >= 0,接下里将光标定位到最后一行,回车,光标将会出现在下一行,和if保持相同的缩进,输入else:,然后观察Pycharm给出的预输入提示:

  再次回车,移动光标,这里我们在Pycharm强大的拼写提示下输入抛出异常的代码:

12、代码格式修改

  再次观察Solver.py文件会发现,右边滚动槽中显示了很多黄色标记,将鼠标悬停在上边,Pycharm将会显示对应的代码格式问题:

  好在这些信息都是警告信息,并不会影响到代码的运行结果,但是格式问题实在是太多了,那么如何把代码格式调整得更为美观规范呢?

  这里所用到的就是code reformatting了,不妨尝试一下。

  为了调用格式化操作,只需按下Ctrl+Alt+L快捷键,或者在主菜单中单击Code→Reformat Code,此时我们惊奇发现所有的PEP8类格式问题都已经消除。

  当然我们可以自定义格式化标准,打开 code style settings对话框,选择指定语言(Python),进行必要的更改即可:

13、添加注释文档

  代码格式调整完之后,左侧仍然留有一些黄色的标志位,鼠标悬停后提示类似于"Missing docstring"的警告信息,代码前方亮着的小黄灯泡也提示同样的信息:

  解决方法也很简单,在弹出的下拉菜单中选择Insert docstringPycharm就会自动添加一段带格式的文本作为注释文档:

  注意这里有若干中注释文档的格式,你可以在Python Integrated Tools页面中设置当前需要插入哪种格式的注释文档,例如Epytext、plain text等

14、输入注释

  注释文档用以解释函数的参数、返回值、变量的类型及含义。举个例子,我们需要控制demo()的输入参数类型,我们就需要在注释文档中添加相应的注释信息:

  至此,主函数的注释文档完成。

  接下来在函数调用的过程中,若出现参数类型不匹配的情况,Pycharm会依据注释文档来给出响应的错误提示信息:

  更多有关Pycharm注释文档的信息参见: type hinting

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持我们。

(0)

相关推荐

  • Pycharm技巧之代码跳转该如何回退

    背景 最近玩Python已经有段时间了, 一般都是通过vim和Pycharm来开发, 真心觉得这两个是神器. Vim神器暂且不说, 今天来分享Pycharm的一个小技巧,下面话不多说,一起来看看详细介绍吧. 用Pycharm的童鞋都知道, 它有个跳转的功能, 可以让我们在想深入了解某个函数/库的时候, 可以快速跳转到具体的定义去, 方法就是: 按住ctrl, 再用鼠标左击函数名/库名. 当我们跳转过去, 看到想要看到具体实现时, 问题来了, 怎样跳回去? 于是我采取的办法是按ctr+F然后输入上

  • Pycharm学习教程(3) 代码运行调试

    Pycharm代码运行调试,具体内容如下 1.准备工作 (1)Python版本为2.7或者更高版本 (2)已经创建了一个Python工程并且添加了内容,具体参考:Getting Started tutorial 2.第一步--运行代码 打开之前编写的Solver.py文件,在编辑框中右键,选择快捷菜单中的"Run 'Solver'"选项. 此时脚本文件正常运行并在调试工具窗口中显示程序的输出值: 接下来我们对这两步操作的具体内容做详细的解释. 3.什么是Run/Debug模式 每个需要

  • Pycharm学习教程(2) 代码风格

    如何创建一个Python工程并使其具有Pycharm的代码风格,具体如下 1.主题 这部分教程主要介绍如何创建一个Python工程并使其具有Pycharm的代码风格.你将会看到Pycharm使你的源码变得非常简洁美观,带有合适的缩进.空格等等,因此Pycharm也是一款代码质量管理的利器. 这部分教程并不会介绍如何使用Python进行编程,更多有关Python编程的知识请参照:Python编程 2.准备工作 在开始之前,请确认一下情况: (1)安装了Pycharm2.7或更高版本的软件 (2)已

  • Pycharm学习教程(5) Python快捷键相关设置

    Python快捷键相关设置,具体内容如下 1.主题 毫无疑问Pycharm是一个具有强大快捷键系统的IDE,这就意味着你在Pycharm中的任何操作,例如打开一个文件.切换编辑区域等,都可以通过快捷键来实现.使用快捷键不仅能提高操作速度,看起来也会非常酷.然和,如果你已经习惯使用一些快捷键方案,你的手指就会习以为常,改变起来就比较困难.这部分教程即是介绍如何根据你的习惯来量身定制Pycharm快捷键设置,使你用起来得心应手. 对于基本的快捷键的组合.用法这里不再赘述,详情可参考Configuri

  • Pycharm学习教程(6) Pycharm作为Vim编辑器使用

    Pycharm作为Vim编辑器使用,具体内容如下 1.主题 如果你是Vim的粉丝,并且不打算使用其他类型的编辑器,那么这篇教程将会比较适合你.这里将会详细介绍如何在Pycharm IdeaVim插件的帮助下下载.安装.使用Vim.至于有关Python编程以及Vim的用法,详见official website,Vim documentation. 2.准备工作 安装2.7或者更高版本的Pycharm 3.下载安装IdeaVim插件 在Pycharm的主工具栏中单击设置按钮,在IDE Setting

  • Pycharm学习教程(1) 定制外观

    Pycharm作为一款强力的Python IDE,在使用过程中感觉一直找不到全面完整的参考手册,因此决定对官网的Pycharm教程进行简要翻译,与大家分享. 1.准备工作 首先确定你安装了2.7或者更高版本的Pycharm(下载地址),下载时请根据你的系统平台下载对应版本即可. 2.如何选择Pycharm的外观 Pycharm预定义了几种主题模式,可用主题的数量与操作系统类型有关,你可以参照外观说明(参照说明)在"Settings/Preferences"对话框中进行相关设置. 背景主

  • Pycharm学习教程(7)虚拟机VM的配置教程

    设想这样一种情况,你在一个平台上操作你的工程,但你希望在另外一个平台上完善并运行它,这就是为什么Pycharm做了很多工作来支持远程调试. 在虚拟机上运行一个工程主要包含以下步骤: (1)定义一个虚拟框架define a virtual box (2)需要在虚拟框架下配置一个远程的解释器configure a remote interpreter (3)在远程控制台加载当前工程launch your script in the remote console 1.准备工作 确定你的Pycharm已

  • Pycharm学习教程(4) Python解释器的相关配置

    Python解释器的相关配置,供大家参考,具体内容如下 1.准备工作 (1)Pycharm版本为3.4或者更高. (2)电脑上至少已经安装了一个Python解释器. (3)如果你希望配置一个远程解释器,则需要服务器的相关支持. 2.本地解释器配置 配置本地解释器的步骤相对简洁直观: (1)单击工具栏中的设置按钮. (2)在Settings/Preferences对话框中选中 Project Interpreter页面,在Project Interpreter对应的下拉列表中选择对应的解释器版本,

  • Pycharm使用之设置代码字体大小和颜色主题的教程

    1. File->Setting  打开如下所示的对话框,可以在Editor->General->Font下设置字体大小(Size).行距(Line spacing) 2. Editor->Color Scheme  展开如下所示内容,可以选择自己喜欢的主题样式,设置颜色等属性. 以上这篇Pycharm使用之设置代码字体大小和颜色主题的教程就是小编分享给大家的全部内容了,希望能给大家一个参考,也希望大家多多支持我们.

  • Python学习之路安装pycharm的教程详解

    简介:pycharm 是一款功能强大的 Python 编辑器,具有跨平台性.下载地址 第一步:下载pycharm 软件 下载时会有两个版本供选择.Professional版(专业版)和Community版(社区版).建议安装Community版本,因为免费使用. 第二步:安装pycharm软件 1.找到下载的 .exe文件,双击运行安装.建议修改安装位置,软件不要总是安装在默认C盘,如下,我选择E盘. 2.接下来 3.接下来 4.Install 然后就是静静的等待安装了.如果我们之前没有下载有P

  • 使用pycharm将自己项目代码上传github(小白教程)

    目录 1.梳理一下Git.github和gitee这三个之间的关系: 1.1.Github 1.2.Gitee 1.3.Git 2.如何安装Git 基于Pycharm将代码上传到github或者gitee上 1.首先安装一个插件: 2.注册github账号: 1.梳理一下Git.github和gitee这三个之间的关系: 1.1.Github 首先从我们最熟悉的github来说,他其实是一个代码托管平台,我们可以在他的里面新建很多的仓库,有强迫症的我理解就是一个仓库是一个自己的项目代码,这些仓库

随机推荐