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,
}