vscode 不自动补全三引号闭合，因 python 无多行注释语法，'''和"""仅为字符串字面量；pylance 将其视为普通字符串而非注释，避免误插闭合符，符合语义规范。
VSCode 默认不支持 Python 多行注释的自动补全（比如输入 ''' 或 """ 后自动闭合），它把三引号当成普通字符串起始符处理，而非注释语法块。Python 本身也没有“多行注释”语法——'''... 和 """... 是多行字符串字面量，仅当未赋值给变量、未作为 docstring 出现在函数/类定义头部时，才被当作无作用的“伪注释”。真要实现“按需插入带闭合的多行字符串模板”，得靠用户代码片段（snippets）或扩展干预。
为什么 VSCode 不自动补全三引号闭合？
因为 Pylance 和 Python 扩展默认将 ''' 和 """ 视为字符串字面量的开始，不是注释结构。语言服务器不会对字符串内部做配对补全，这是设计使然：避免在真实字符串中误插闭合引号（比如写日志模板时 """Hello {name}"""），也符合 Python 的语义规范。
- Python 没有
//或/* */风格的原生多行注释语法 -
"""在函数/类顶部是 docstring，编辑器会高亮并索引，但不会自动补全闭合 - 在任意位置敲
"""，VSCode 只触发基础字符串行为（如引号配对、语法着色），不启动“注释模板”逻辑
用代码片段（snippets）手动注入三引号模板
这是最轻量、最可控的方式。VSCode 允许你定义自定义快捷键，插入预设的多行字符串结构，还能光标定位到中间位置。
- 按下
Ctrl+Shift+P，输入Preferences: Configure User Snippets，回车 - 选择
Python（会打开python.json） - 添加如下 snippet：
{
"Triple double-quoted string": {
"prefix": "tdoc",
"body": ["\"\"\"$1\"\"\""],
"description": "Insert triple double-quoted string"
},
"Triple single-quoted string": {
"prefix": "tsoc",
"body": ["\'\'\'$1\'\'\'"],
"description": "Insert triple single-quoted string"
}
}
- 保存后，在
.py文件中输入tdoc+Tab，即可插入"""|"""（|表示光标位置） - 若想快速生成 docstring 模板（含参数说明），可用更复杂的 snippet，例如匹配
def行后自动展开，但这需要正则匹配逻辑，已超出 snippets 原生能力，需配合其他扩展（如 Auto Docstring）
用 Auto Docstring 扩展生成函数/类级 docstring
如果你真正需要的是函数或类的文档字符串模板（即标准 docstring），而不是任意位置的“多行注释”，那么 Auto Docstring 是目前最稳定的选择。它不修改编辑器底层行为，而是基于 AST 分析当前光标所在上下文，生成符合 Google/Numpy/Sphinx 格式的 docstring 框架。
- 安装扩展：在扩展市场搜索
Auto Docstring（作者：Nils Werner） - 配置可选：在
settings.json中加"autoDocstring.docstringFormat": "google" - 用法：光标放在
def或class行，按Ctrl+Alt+D（Windows/Linux）或Cmd+Alt+D（macOS），自动生成带参数、返回值占位符的"""..."""块 - 注意：它只在函数/类定义处生效，不会响应
if块或裸"""输入
别踩坑：Ruff / Black / Pylance 都不处理三引号补全
有人误以为装了 Ruff 或启用 Black 格式化就能“修复”三引号不闭合问题——不会。这些工具只在保存或手动触发时检查/重写代码风格，它们：
- 不监听实时输入，无法在敲下第一个
"时就插入第二个和第三个 - Ruff 的
ruff.toml中没有控制字符串闭合的规则项 - Black 对 docstring 的格式化仅限缩进、换行、引号风格（如统一转
"""），不负责补全 - Pylance 的
python.analysis.autoImportCompletions等设置与字符串字面量无关
真正容易被忽略的一点是：很多人花时间调 editor.autoClosingBrackets 或改 python.languageServer，却没意识到问题根源不在语言服务，而在 Python 语法本身就不支持“注释闭合”这个概念——你不是配置错了，是你想错了对象。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
