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)圖標運行測試