Vscode for python ide配置
Posted testerh2o
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Vscode for python ide配置相关的知识,希望对你有一定的参考价值。
1.文件头添加
- 自定义代码片段
- 文件>首选项>用户代码片段
- 搜索python
- 添加代码
"HEADER":
"prefix": "header",
"body": [
"# -*- encoding: utf-8 -*-",
"",
"# @File : $TM_FILENAME",
"# @Time : $CURRENT_YEAR/$CURRENT_MONTH/$CURRENT_DATE $CURRENT_HOUR:$CURRENT_MINUTE:$CURRENT_SECOND",
"# @Author : H2o ",
"# @Version : 1.0",
"# @Contact : 515430193@qq.com",
"",
"",
""
],
- 添加文件头
- 新建文件
- 输入header
- 选择header
2.进入设置界面
- 在vscode中打开一个文件
- 点击左下角"齿轮"图标
- 选中设置
3.为不同的项目配置python虚拟环境
- 设置界面, 切换tab到工作区
- 设置搜索框输入:python.pythonPath
- 将新建的虚拟环境地址添加即可, 如: D:\ENV\Testtools\Scripts\python.exe
4.自动函数生成注释模板
- 下载插件: autoDocstring
快捷键: ctrl+shift+2, 或在函数定义后输入: """
4.1.切换注释生成模板
- 设置界面, 搜索autoDocstring
修改autoDocstring.docstringFormat栏即可
4.2.自定义模板样式
- 新建.mustache文件
- 修改autoDocstring.docstringFormat栏为default
修改autoDocstring.customTemplatePath为你新建的.mustache文件的地址
(详细关键字配置请查看插件介绍)
个人使用google注释模板,.mustache文件内容如下:
! Google Docstring Template
summaryPlaceholder
extendedSummaryPlaceholder
#parametersExist
Args:
#args
var (typePlaceholder): descriptionPlaceholder
/args
#kwargs
var (typePlaceholder, optional): descriptionPlaceholder. Defaults to &default.
/kwargs
/parametersExist
#exceptionsExist
Raises:
#exceptions
type: descriptionPlaceholder
/exceptions
/exceptionsExist
#returnsExist
Returns:
#returns
typePlaceholder: descriptionPlaceholder
/returns
/returnsExist
5.配置代码格式化工具
(以black为例)
- pip install black
- 设置界面, 搜索python.formatting.provider, 选择black
- 设置界面, 搜索python.formatting.blackPath, 输入你的black安装路径
例如: C:\Program Files\Python36\Scripts\black.exe - (选配)配置black运行参数, 设置界面, 搜索python.formatting.blackArgs, 添加: --line-length=80
(black每行允许的字符长度为88)
6.配置代码静态检查工具
(以pylint为例)
- pip install pylint (若是虚拟环境, 建议切换到虚拟环境后, 再pip安装)
- 设置界面, 搜索python.linting.pylintPath, 输入你的pylint安装的路径
- 设置界面, 搜索python.linting.enabled, 选中即可
- 设置界面, 搜索python.linting.pylintEnabled, 选中即可
7.插件安装
项目 | 说明 | 是否必需安装 |
---|---|---|
Python | 是 | |
vscode-icons | 美化文件图标 | 否 |
Better Comments | 美化行注释 | 否 |
Chinese (Simplified) Language Pack for Visual Studio Code |
中文汉化包 | 否 |
autoDocstring | 函数注释模板生成 | 否 |
8.json文件内容
8.1 用户json文件
"files.autoSave": "afterDelay",
"editor.renderWhitespace": "all",
"editor.wordWrap": "wordWrapColumn",
"workbench.startupEditor": "newUntitledFile",
"workbench.iconTheme": "vscode-icons",
"workbench.colorTheme": "Bluloco Light",
"editor.fontFamily": "InputMono, Consolas, 'Courier New', monospace",
"editor.fontSize": 15,
"editor.lineHeight": 27,
"python.formatting.provider": "black",
"python.formatting.blackPath": "C:\\Program Files\\Python36\\Scripts\\black.exe",
"python.formatting.blackArgs": [
"--line-length=80"
],
"editor.renderControlCharacters": false,
"autoDocstring.customTemplatePath": "C:\\Program Files\\Microsoft VS Code\\data\\google.mustache"
8.2 工作区json文件
"python.pythonPath": "D:\\ENV\\Testtools\\Scripts\\python.exe",
"python.linting.pylintEnabled": true,
"python.linting.enabled": true,
以上是关于Vscode for python ide配置的主要内容,如果未能解决你的问题,请参考以下文章