使用VS Code打造Python编程与Markdown写作利器,打破知乎、WordPress和微信公众号的壁垒

4,032 阅读7分钟

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


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