python vscode 入门级保姆配置

python vscode 入门配置

本套课程，大喵将带着大家使用vscode这款轻量级编辑器神器，配置python开发配置

参考资料：

• 《VSCode配置Python开发环境》 https://blog.csdn.net/vinkim/article/details/81546333

什么是 vscode 编辑器？

Visual Studio Code（以下简称vscode）是一个轻量且强大的跨平台开源代码编辑器（IDE），支持Windows，Mac OS X和Linux。内置JavaScript、TypeScript和Node.js支持，而且拥有丰富的插件生态系统，可通过插件面板来方便快捷的安装插件来支持javascript、C++、C#、Python、PHP等其他语言。

为什么使用 vscode 编辑器？

• 免费：这是大多数开发者所希望的遇到的, vscode 使用的是 MIT Lisense, 大家可随意下载, 分发, 甚至商用等
• 开源: 我们可以在 github 直接看到源码, 开源可以让更多开发者参与进来, 集思广益, 推动这款优秀的 IDE的继续蓬勃发展.
• 多平台支持: 支持windows、linux、mac os 三个主流常用系统
• 帮助文档全面: 如果使用中遇到问题, 我们可以直接在 github 上提问, 也可以请求新功能开发。一般提问后几小时就会有人来处理该问题, 态度也非常友好。这里建议使用英文提问，英文不太好的小伙伴，可以谷歌翻译一下，再提问。
• 使用简单: 纵观目前市场上的IDE，找不到比这个使用更简单的 IDE 了, 基本上符合程序员的使用习惯, 90% 程序员小哥哥或者小姐姐都会爱上 ta, 当然还有 10% 是后来转行不写代码了。 当然他还有超多的快捷键，各种方便的快捷键呼啦啦的满天飞, 自定义快捷键, 自定义功能, 爽到大家只想安安静静的写代码。一杯清茶，一个键盘，一张屏幕，一个Vs Code编辑器，直接打开沉浸舒适模式的大门。
• 占用系统资源少: 下载 vscode 1.29.0, 只有 44 MB 大小；安装完约 189 MB；内存上, 相对于 eclipse等其他编辑器, vscode 占用内存更少. eclipse 约占用 478 MB(1 个进程), vscode 约共占用 200 MB(6 个进程);
• 提供丰富的插件: 对于插件，大家可以随心所欲, 在vscode提供的插件面板中，下载你想要的插件, 安装和卸载只需要轻轻点击一下鼠标即可；
• 功能强大: 你想要的功能, 这里都有；如果没有, 那应该说明是小伙伴们你还不会用它哟；
• 界面很赞：界面非常适合程序员审美, 非常专业, 简洁美观大方, 长时间集中注意力编程也不累，愉悦程序员的开发心情，侧面减少开发的Bug；

什么是 python ?

Python，它是一门编程语言，截止到目前python已经广泛应用在：无人驾驶、个人助理、金融、电商、医疗、教育等各大领域。尤其是在``Web开发、自动化运维与测试、游戏服务器开发方面有着先天的优势。目前许多大型网站就是用Python开发的，例如YouTube、Instagram，还有国内的豆瓣。很多大公司，包括Google、Yahoo等，甚至NASA（美国航空航天局）都大量地使用Python`。

为什么要学习 python ?

• 简单
• 开源
• 免费
• 解释性高级语言，跨平台
• 面向对象
• 功能强大
• 可扩展性强

详细地址，可以参考：http://c.biancheng.net/view/4129.html

vscode + python

vscode毫无疑问是一款非常优秀的IDE，而python则无疑是一门使用领域相当广泛，非常强大的高级语言；那我们如何把这两者结合起来，用最优美的IDE编写最棒的语言，优雅与完美，强强结合，气冲入虹，势不可挡。

课程前提

• 安装好python // 如果没有安装也不要慌，百度一下，比比皆是
• 安装好vscode //

课程知识点

• 引入python语法模块提示包，插件python，根据文档来介绍它的作用

  • 支持Python2.7和Python3.4+的Pyhon版本
  • 使用IntelliSense进行代码补全
  • 代码检查器
  • 对调试的支持
  • 代码段功能
  • 对单元测试的支持
  • 自动应用虚拟环境
  • 可在Jupyter环境和Jupyter Notebook中编辑代码

• 引入AREPL

  • 当我们编辑好python文件的时候，自动实时的打印编译输出便签工具
  • 首先，确保安装了Python3.5版本或更高版本。
  • 打开一个python文件，也就是.py文件，右键单击AREPL launch的编辑器标题选项。
  • 或者通过命令search运行AREPL:control-shift-p
  • 或者使用快捷方式：control-shift-a（当前文档）/control-shift-q（新文档）
  • 特点：
    • 实时评估：不需要运行 -AREPL，自动编译运行代码打印信息。当然我们可以在设置中控制它（甚至关闭它）
    • 变量显示：局部变量的最终状态以可折叠的JSON格式显示
    • 错误显示：出错的瞬间，会显示堆栈跟踪错误
    • 设置：AREPL提供了许多设置来适应您的用户体验。定制外观和手感、脱泡时间、python选项等等！
  • 如果要在程序中的特定点转储记录局部变量或转储变量，可以使用dump函数：

      from arepl_dump import dump
  
      def func(miles):
          kilometers = miles*1.60934
          dump() # dumps all the vars in your function
  
          # or dump when function is called for a second time
          dump(None,1)
  
      func(2*2)
      func(3*3)
  
      for char in ['a','b','c']:
          dump(char,2) # dump a var at a specific iteration
  
      a=1
      dump(a) # dump specific vars at any point in your program
      a=2
  

  • 如果我们想要避免实时执行一段代码，可以使用#$save，因为实时执行，可能会影响代码编辑的舒适度，因为可能会卡顿，如果我们的代码逻辑中存在远程资源调用的话，编辑器的响应速度就比较慢了

      print('12123212132343');
      print('aaassssssxxxxghgh');
      #$save
      print('savesx');
  

  • 使用#$end注释指示实时代码的结尾。 #$end之后的代码将不会实时执行。 如果您要运行某些特定的东西而不同时运行整个文件，这将很有用。 例如：

      import math;
  
      x = 123.123125423
  
      #$end
  
      # I can inspect variables without rerunning calculate_all_digits_of_pi
      # the shortcut is control-enter - the code block should flash yellow.
      print(x) # 3.14......
  
      # I can also temporarily change the state of variables
      # note that control-enter will run all adjacent lines of code
      x = math.floor(x)
      print(x) # 3
  
      # i only want to do this once I've determined that x is correct
      print('1232131')
  

• 引入autoDocstring

  • 简介：是一款Visual Studio Code扩展，它可以快速为python function生成注释文档。
  • 案例展示: (输入"""，然后按住回车Enter)

      def func(num, tar=3):
      """[summary]
      
      Arguments:
          num {[type]} -- [description]
      
      Keyword Arguments:
          tar {int} -- [description] (default: {3})
      """
  

  • 快速上手介绍（作用）：
    • 快速生成一个docstring 函数注释文档代码段。
    • 选择几种不同类型的文档字符串格式。
    • 通过pep484类型提示，默认值和变量名来推断函数参数类型。
    • 支持args，kwargs，decorator，错误和参数类型
    • 什么是args，kwargs？：这两个属于魔法变量，主要用于函数定义。我们可以将不定数量的参数传递给某个函数；
    • args：是用来发送一个非键值对的可变数量的参数列表给一个函数
    • kwargs：允许我们将不定长度的键值对作为参数传递给一个函数。如果你想要在一个函数里处理带名字的参数，你应该使用**kwargs。
    • decorator: 装饰器本质上是一个Python函数，它可以让其他函数在不修改任何代码的前提下增加额外功能。类似于React里面的高阶函数
  • 使用方法介绍：
    • 注意：鼠标的光标必须在定义函数的正下方的一行，才能生成完整的自动填充的文档函数注释
    • 在打开带三引号的文档字符串后按Enter（"""）
    • 键盘快捷键：ctrl + shift + 2 或 cmd + shift + 2（适用于Mac）
      • 可以在首选项 -> 键盘快捷键 -> extension.generateDocstring 中更改
    • 命令：生成文档字符串
    • 右键菜单：生成文档字符串

• 引入Python Test Explorer for Visual Studio Code

  • 这个插件主要用于调试，在Visual Studio Code打开一个新的的侧边栏中执行Python测试
  • 特点：
    • 在VS Code的侧边栏的debugger视图中显示调试资源管理器，其中包含所有检测到的测试和套件及其状态
    • 在资源管理器中选择调试后，显示失败的测试日志
    • 支持多个根目录工作区
    • 支持Unittest和Pytest测试框架
  • 快速上手入门：
    • 安装扩展
    • 为Visual Studio Code配置Python扩展以发现您的测试（请参阅“配置”部分和所选测试框架的文档（Unittest文档，Pytest）
    • 重新加载VS Code并打开’测试’视图
    • 使用测试资源管理器中的运行(run)图标运行测试