一 必备插件
通过快捷键Ctrl+Shift+X打开扩展安装界面,安装需要的插件。
1 Python
安装完插件后,打开python文件会自动提示选择Python解析器。 也可以通过Ctrl+Shift+P打开命令面板输入Select Interpreter来选择需要的解析器。
安装完Python插件后,也会提示安装一些它所依赖的packages,可以按需都安装上。
2 Pylance
强烈建议使用Pylance替代默认的Python语言服务器,它支持一些很棒的功能,比如:
Docstrings
自动导入
类型检查
Code Lens
IntelliCode 兼容性
设置如下:
{
“python.languageServer”: “Pylance”
}
二 推荐设置
1 设置code formatter为yapf
它和默认使用的autopep8的不同之处在于它不仅会指出代码中违反PEP8规范的地方,还会对没有违反PEP8但代码风格不一致的地方重新格式化,可以让令代码的可读性更强。
设置步骤:
打开设置(Ctrl+ ,):搜索"formatting.provider"
选择yapf,如果没有安装,vscode会发出提示,按提示安装即可
也可以直接打开设置文件添加一行:“python.formatting.provider”: “yapf”,
使用方法:选中需要格式化的代码,右键选择格式化选定内容,快捷键:Ctrl + K, Ctrl + F或者Alt+Shift+F(ubuntu为Ctrl+Shift+I)
可以通过设置"python.formatting.yapfArgs"添加自定义的格式化参数
2 设置自动格式化
可以打开保存时和键入一行后立即进行代码格式化,设置选项为:
{
“editor.formatOnSave”: true,
“editor.formatOnType”: true
}
3 设置静态代码linter为flake8
Flake8是由Python官方发布的一款辅助检测Python代码是否规范的工具,它包含PEP8编码风格检查,代码静态检查则是依托PyFlakes,相对于Pylint,其检查规则灵活,扩展性更强一些。
设置步骤:
通过Ctrl+Shift+P打开命名面板,搜索Python: Select Linter选择flake8即可
或者打开设置文件添加:“python.linting.flake8Enabled”: true,
同时最好关闭Pylint,json设置如下:
{
“python.linting.flake8Enabled”: true,
“python.linting.pylintEnabled”: false,
}
4 自动补全设置
打开自动添加括号,在自动补全函数时,可以自动加上括号,提高效率:
{
“python.autoComplete.addBrackets”: true,
}
5 添加自动补全库路径
为额外的Python库支持自动补全,设置路径:
{
“python.autoComplete.extraPaths”: []
}
6 添加分析路径
添加额外导入路径,设置:
{
“python.analysis.extraPaths”: []
}
这对于导入项目中一些自己实现的python文件很有帮助。
7 添加垂直参考线
Python的代码风格要求代码一行不超过79字符,所以我们可以给代码编辑器设置一条垂直参考线,直观判断代码是否太长,并且可以自定义参考线的颜色:
{
“editor.rulers”: [
80,
],
“workbench.colorCustomizations”: {
“editorRuler.foreground”: “#ff4081”
}
}
效果如下:
三 常用操作
1 自动导入
在使用到某个库的时候,可以使用自动导入,并且导入的时候会选择import语句插入的位置,保持import语句有序,如下演示:
动图
2 排序import
在Python源文件中直接右键,选择排序Import语句,vscode将会通过isort自动将import语句分组并排序,非常nice。
3 重构代码
光标放到在函数名、参数名上按F2重构变量名。 如果没有安装重构工具rope,按提示安装即可。
4 提取变量或方法
选择一段代码,将会出现一个小灯泡(Quick fix),点击小灯泡即可选择将所选代码提取为变量或者函数。 如下图:
笔者目前在macos实测功能还有些不完美,期待后续能够修复。
5 触发参数提示
在调用函数的时候,vscode会自动弹出参数提示,可以通过ESC关闭,关闭后可以通过快捷键Ctrl+Shift+Space唤出。 但是这个快捷键可能会被输入法占用,可以修改绑定快捷键,通过快捷键Ctrl+K Ctrl+S打开快捷键设置窗口,搜索editor.action.triggerParameterHints,修改快捷键即可。
6 在终端运行选中代码
运行脚本可以通过右键选择在终端中运行Python文件,而如果要运行文件中的一小段代码,可以通过选中需要运行的代码,按快捷键Shift+Enter就可以了。