使用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”。
2. 「安装Python解释器」：我常用的有两种方法，一种是直接从官网下载，另一种，如果你经常涉及数据科学、机器学习等编程，可以直接下载Anaconda，里面不仅包含Pyhton解释器，还有常用库和工具。安装完成后注意检查环境变量是否配置好了。
   • 选择第一种方式的教程：python安装教程（Windows系统,python3.7为例）
   • 选择第二种方式的教程：https://docs.anaconda.com/anaconda/install/windows/
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的预览图标。

4. 「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": "你的包路径"

2. 「代码检查」：
   • 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，使用在线工具复制文章到公众号后台之后，再逐个编辑公式，略麻烦，如果您有更好的方案，也可以分享给我~

欢迎关注我的公众号“「野风同学」”，原创技术文章、干货推荐文章将第一时间推送。