stless/stful 不触发是因文件未被识别为 dart 语言，需点击右下角语言标识改为“dart”，并确保 dart 和 flutter 插件已安装启用；自定义模板须建全局 snippets 文件，命名含 .code-snippets 后缀，json 无注释、无语法错误，且需重载窗口生效。
stless/stful 触发不了？检查 Dart 插件和语言模式
输入 stless 或 stful 按 Tab 没反应，大概率不是片段本身失效，而是当前文件没被识别为 Dart 文件。VS Code 的代码片段严格按 languageId 匹配，哪怕文件后缀是 .dart，右下角语言标签若显示 “Plain Text” 或 “Flutter”，stless 也不会触发。
解决方法：
- 点击编辑器右下角语言标识（如 “Plain Text”），手动选 “Dart”
- 确认已安装并启用
Dart和Flutter官方插件（二者缺一不可） - 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行 “Developer: Inspect Editor Tokens and Scopes”，看顶部languageId是否为dart
想加自定义 Widget 模板（比如 Column + Padding + Text）？用全局 snippets
官方插件只提供 stless、stful 等基础骨架，不包含业务常用布局组合。这类模板必须自己写全局代码片段，且不能依赖语言专属文件（如 dart.json），否则在 .dart 外的文件里会失效。
正确做法：
- 按
Ctrl+Shift+P→ 输入 “Configure User Snippets” → 选 “New Global Snippets file”，命名为flutter-layout.code-snippets - 填入类似下面的结构（注意：无
scope字段，prefix全小写）：
{
"column with padding and text": {
"prefix": "colpt",
"body": [
"Column(",
" children: [",
" Padding(",
" padding: const EdgeInsets.all(16.0),",
" child: ${1:Text('${2:Hello}')} ,",
" ),",
" ],",
")"
],
"description": "Column + Padding + Text boilerplate"
}
}
保存后必须执行 “Developer: Reload Window” 才生效——仅保存文件不加载新片段。
为什么写了 snippets 还是没提示？路径和 JSON 格式是硬门槛
VS Code 对 snippets 的加载极其严格：路径错一级、JSON 多个逗号、用了注释（JSONC 不支持）、文件名没带 .code-snippets 后缀，都会导致整个文件静默失败。
常见踩坑点：
- Windows 路径应为
%USERPROFILE%\AppData\Roaming\Code\User\snippets\，macOS 是$HOME/Library/Application Support/Code/User/snippets/，Linux 是$HOME/.config/Code/User/snippets/ - 文件必须放在
snippets/目录下，不能嵌套子文件夹 - JSON 中不能出现单行注释
//或多行注释/* */，否则整个文件被忽略 -
prefix里不能含空格、大写字母或连字符，col-pt或ColPt都无效，只能是colpt
多个占位符怎么跳转？$1 $2 $0 的行为和默认值写法
写布局模板时，你通常希望光标先停在 widget 名、再跳到文本内容、最后停在末尾。这靠 $1、$2、$0 控制顺序，不是靠位置先后。
关键规则：
-
$1是第一次 Tab 停留位置，$2是第二次，$0是最终停留点（不参与编号循环） - 同个数字重复出现会同步更新，比如两个
$1，改一个另一个自动变 - 要预填默认值，写成
${1:Text}或${2:'Hello'}，括号内是光标首次停留时的初始文本 - 别用
\n换行，body是字符串数组，每项一行，缩进用\t表示
复杂点在于：一旦片段里有多个 $1，它就不再是“第一个参数”的语义，而变成“所有同编号占位符的联动锚点”。这点容易被忽略，改着改着发现几处名字不同步了。
