使用VS Code打造Python編程與Markdown寫作利器,打破知乎、WordPress和微信公衆號的壁壘

1 前言

平時工作學習中常會在Windows系統上使用Python編程和使用Markdown寫作,並會將寫作內容同步到自己WordPress搭建的博客、知乎和公衆號上。在考察了多種工具後,最後選擇使用VS Code來作爲統一的編輯器,豐富的插件和社區基本能滿足我的所有需求,下面就介紹一下如何將VS Code打造成一個集Python編程、Markdown博客寫作爲一體的編輯器吧!下面的介紹將包含基本的環境搭建和一些有用的技巧、插件等。

2 安裝與環境搭建

2.1 VS Code安裝

這個沒啥好說的,直接去官網選擇合適自己系統的安裝包,下載安裝即可。下載地址:https://code.visualstudio.com/Download。
這裏提一下,安裝後是英文的界面,如果喜歡中文界面的朋友,可以去插件市場裏搜索“Chinese”,排名第一個的就是。安裝完提示你重啓VS Code,重啓之後就漢化了。如果沒有變,那就按快捷鍵Ctrl+Shift+P調出VS Code的命令行輸入欄,輸入Configure Display Language並選擇,在打開的json文件裏,把其中的 “locale”:"" 改成 “locale”:“zh-CN” ,再重啓vscode,界面語言就會是中文了。

2.2 VS Code常用快捷鍵

消化下面兩個就夠了,主要是基礎編輯導航的快捷鍵,能加快平時的編程速度。前期不熟練記不住的時候,可以買一個寫滿快捷鍵提示的大鼠標墊,時不時瞄一眼,哈哈哈。

21 個VSCode 快捷鍵,讓代碼更快,更有趣
VS Code折騰記 - (2) 快捷鍵大全,沒有更全

2.3 打造Python編輯器

  1. 安裝VS Code的Python插件:直接在插件市場裏搜索“Python”。
    Python插件
  2. 安裝Python解釋器:我常用的有兩種方法,一種是直接從官網下載,另一種,如果你經常涉及數據科學、機器學習等編程,可以直接下載Anaconda,裏面不僅包含Pyhton解釋器,還有常用庫和工具。安裝完成後注意檢查環境變量是否配置好了。
  3. 新建Python文件,Hello World測試
    方法一:使用命令行工具新建項目文件夾(workspace)
mkdir hello world
cd hello world
code .

方法二:直接新建文件夾,鼠標右鍵選中,使用VS Code打開。
方法三:打開VS Code,點擊文件->打開文件夾
 
打開我們的項目文件夾以後,新建一個以.py結尾的Python文件,然後在編輯器左下角選擇Python解釋器,這時,項目文件中就會出現一個.vscode/settings.json文件,它是這個工作空間的的設置文件。下面就可以編輯自己的Python文件,並運行了,演示如下:
演示

2.4 打造Markdown編輯器

Markdown是一種非常輕量、易學的標記語言,在很多博客、論壇等網站上都支持Markdown書寫,如果你需要給自己的代碼寫文檔,也是推薦用Markdown書寫。在本地使用Markdown編輯好文章,很輕鬆就可以分發到各個平臺。怎麼在VS Code上使用Markdown呢,也很方便,安裝幾個插件即可。

  1. Markdown All in One:一個組合包,一股腦把最常用的Markdown優化都給你裝好;
  2. Markdown Preview Enhanced:增強預覽的渲染效果;
  3. Markdown+Math:提供Markdown中Latex數學公式的支持。

安裝好這些插件之後,就可以新建項目,建立.md結尾的Markdown文件進行寫作了,點擊編輯框右上角的打開側邊欄預覽按鈕,就可以實時渲染出Markdown文件。安裝了Markdown Preview Enhanced後,會有兩個這樣的圖表,建議選擇對應Markdown Preview Enhanced的預覽圖標。

打開側邊欄預覽

  1. Markdown常用語法:看這篇就夠了:

    Markdown語法圖文全面詳解

3 一些技巧

3.1 更舒適的Python編程環境

  1. 代碼補全:VS Code 中的代碼補全插件是 Visual Studio IntelliCode。IntelliCode 通過使用經過數千個公共代碼庫培訓的機器學習模型生成建議,而且會隨着你編寫代碼的增長,從而變得更加準確。它會根據上下文給出編程建議,而不是簡單根據字母排序推薦 API。
    每次進入一個Python工作空間的時候,IntelliCode使用的引擎有兩種,默認使用Microsoft Python Analysis Engine,每次進入一個Python工作空間的時候,就會看見下面顯示正在加載,一般還會加載很久,受不了的朋友可以在.vscode/settings.json中設置
"python.jediEnabled": true,

意思就是使用Jedi來作爲IntelliCode的引擎。
另外,如果你有一些額外的包需要加入到自動補全中,可以通過如下設置來實現。

"python.autoComplete.extraPaths": "你的包路徑"
  1. 代碼檢查
    • pylint: 它是Python 代碼檢查工具。需要通過 pip 安裝。對於不符合規範的代碼,就會有波浪線提示。通過如下設置打開
"python.linting.enabled": true,
"python.linting.pylintEnabled": true,
  • flake8 和 yapf:我平時用的這兩個組合,flake8 是由 Python 官方發佈的一款輔助檢測 Python 代碼是否規範的工具,相對於目前熱度比較高的 Pylint 來說,flake8 檢查規則靈活,支持集成額外插件,擴展性強。yapf 是一個代碼格式化的工具。通過 pip 安裝好 Flake8 和 Yapf 後,進行如下配置。
"python.linting.enabled": true,
"python.linting.pylintEnabled": false,
"python.linting.flake8Enabled": true,
"python.formatting.provider": "yapf",

安裝好之後,我們在Python代碼文件空白處中右鍵,選擇格式化文檔,就可以自動的進行代碼格式化了。

但在使用中,有一條規則我覺得不舒適, flake8 默認一行的最大字符數是 79 個,超過就會顯示波浪線提示你代碼太長了。我們可以把它改長一點,增加如下配置,把最大長度設爲 128 個字符。

"python.linting.flake8Args": ["--max-line-length=128"],
  1. 幾款插件推薦
    • Settings Sync:將VSCode 的配置及我們所下載的插件上傳到 GitHub 上,方便我們在另外一臺電腦上配置出我們熟悉的 VSCode。

    • Better Comments:這款插件可以讓VS Code註釋信息更加人性化。它可以根據告警、查詢、TODO、高亮等標記對註釋進行不同的展示。此外,還可以對註釋掉的代碼進行樣式設置。另外,你想要的任何其他註釋樣式都可以在設置中指定。

    • Bracket Pair Colorizer:這款插件可以給()、[]、{}這些常用括號顯示不同顏色,當點擊對應括號時能夠用線段直接鏈接到一起,讓層次結構一目瞭然。除此之外,它還支持用戶自定義符號。

    • Better Align :它主要用於代碼的上下對齊。它能夠用冒號(:)、賦值(=,+=,-=,*=,/=)和箭頭(=>)對齊代碼。

    • LeetCode: 刷LeetCode的神器。

3.2 Markdown到知乎文章發佈

在本地用Markdown寫了文章,可以使用插件Zhihu On VSCode一鍵發佈到知乎上,具體操作見:知乎 on VSCode 來臨 - 重新定義內容創作!

3.3 Markdown到WordPress文章發佈

在WordPress上安裝插件:WP Editor.md,即可將寫好的Markdown文章複製上去,再做一點圖片等微調基本就沒問題了。

3.4 Markdown到微信公衆文章發佈

我用的這個在線工具:https://doocs.gitee.io/md/?hao.su
用着感覺還挺好的,頁面簡潔漂亮。涉及到外鏈時,可以使用工具的微信外鏈自動轉爲文末引用功能。
另外,如果涉及到數學公式,直接複製過去不太好使,我目前使用的方案是安裝一個Chrome插件:mpMath,使用在線工具複製文章到公衆號後臺之後,再逐個編輯公式,略麻煩,如果您有更好的方案,也可以分享給我~


歡迎關注我的公衆號“野風同學”,原創技術文章、乾貨推薦文章將第一時間推送。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章