vscode的python snippets需匹配语言id而非文件后缀，必须配置在python.json中并确保状态栏显示“python”；合理使用$1、$2、$0和$tm_selected_text等变量可提升函数定义、断言生成等高频场景效率。
VSCode 的 Python Snippets 不是装完插件就自动好用的，关键在于触发词、语言模式和变量用法是否匹配真实编码场景。直接配错 scope 或忽略 TM_SELECTED_TEXT 这类变量，写出来的 snippet 很容易变成摆设。
为什么你配的 Python snippet 总不触发？
根本原因不是插件没装好，而是 VSCode 只认编辑器右下角显示的语言 ID，不看文件后缀。哪怕你打开的是 main.py，如果状态栏显示的是 Plain Text 或 Python (Jupyter)，你为 python 语言配的 snippet 就不会加载。
- 点击右下角语言标签，手动选成
Python（注意不是Python (Jupyter)或Py） - 确认插件已启用：在扩展面板搜
Python Snippets，检查是否已安装且未被禁用 - 自定义 snippet 必须放在
python.json文件里，而不是global.code-snippets—— 后者在 .py 文件中默认不生效 - 修改后关掉当前 .py 文件再重开，避免缓存旧配置
如何让 def 片段真正适配你的函数签名习惯？
官方插件的 def 片段只生成空壳，但实际开发中你常要带类型注解、文档字符串或装饰器。直接改 python.json 的 body 更可控：
{
"Function with Type Hints": {
"prefix": "defh",
"body": [
"def ${1:function_name}(${2:args}) -> ${3:None}:",
" \"\"\"${4:Docstring}\"\"\"",
" $0"
],
"description": "Function with type hints and docstring"
}
}
-
$1是函数名，$2是参数列表（支持写a: int, b: str） -
$3是返回类型，默认填None，Tab 后可快速改成str或List[dict] -
$0放在函数体末尾，光标停这儿，立刻开始写逻辑，不用再按多次 Tab - 别用 Tab 缩进，全用空格——混用会导致 Prettier 或 Black 格式化时破坏结构
怎么用 $TM_SELECTED_TEXT 把一行代码快速转成测试断言？
写单元测试时，经常要把表达式 user.is_active 转成 assert user.is_active == True。靠手敲效率低，用 snippet + 变量就能秒出：
{
"Assert Equal": {
"prefix": "aseq",
"body": ["assert ${TM_SELECTED_TEXT} == ${1:True}"],
"description": "Wrap selected text in assert == statement"
}
}
- 先选中
user.is_active，再输入aseq+ Tab，自动展开为assert user.is_active == True -
${TM_SELECTED_TEXT:default}可设默认值，避免没选中时输出空 assert - 这个技巧对日志包装、
print()封装、SQL 字段提取都适用，比写正则更轻量
哪些 Python 场景最值得配 snippet？
不是所有代码都适合做 snippet，优先覆盖「结构固定 + 手动易错 + 频次高」的组合：
-
if __name__ == "__main__":—— 每个脚本都要写，少个引号就报错 -
from typing import *—— 类型导入常漏Optional或Union，配成typ片段一键补全 -
@dataclass模板 —— 字段声明格式固定，但手写易忘init=True或repr=True - 异常处理块：
try/except ValueError as e:—— 错误类型每次都要切键盘找括号和冒号
真正卡住效率的，从来不是写不出代码，而是反复校验语法细节和格式一致性。snippet 的价值不在“省几秒钟”，而在把注意力从机械校验拉回逻辑本身——这点在调试复杂数据流时尤其明显。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
