VSCode用户自定义代码片段无法在.md与.tex文件生效如何解决

修复步骤 #

1. 修正片段文件匹配规则 #

VSCode中LaTeX文件对应的语言ID是latex，你当前的片段放在tex.json中无法匹配到LaTeX文件，是不生效的核心原因：

• LaTeX自定义片段需要放到latex.json中，Markdown片段放到markdown.json中。可以通过VSCode左下角设置按钮 > 用户代码片段 > 分别搜索latex和markdown打开对应配置文件，把你的片段内容粘贴进去即可。
• 如果需要同一片段在多语言下生效，推荐使用全局代码片段：新建后缀为.code-snippets的全局片段文件，添加scope字段指定生效语言，示例如下：

{
    "dummy": {
        // 逗号分隔要生效的语言ID，可自定义添加其他语言
        "scope": "c,cpp,markdown,latex",
        "prefix": "dummy",
        "body": [
            "some random text for demonstration"
        ],
        "description": "A dummy snippet"
    }
}

2. 开启对应语言的自动补全触发 #

默认情况下Markdown、LaTeX这类标记语言不会在普通文本区域自动触发补全建议，需要在settings.json中添加以下配置：

// Markdown文件补全配置
"[markdown]": {
    // 把自定义片段放在补全列表最顶部
    "editor.snippetSuggestions": "top",
    // 开启全场景快速补全，不用手动按Ctrl + Space触发
    "editor.quickSuggestions": {
        "other": true,
        "comments": true,
        "strings": true
    }
},
// LaTeX文件补全配置
"[latex]": {
    "editor.snippetSuggestions": "top",
    "editor.quickSuggestions": {
        "other": true,
        "comments": true,
        "strings": true
    }
}

配置完成后重启VSCode即可，输入前缀会自动弹出片段建议。

3. 第三方插件冲突排查 #

如果你安装了LaTeX Workshop这类LaTeX扩展，确认扩展设置中没有禁用原生代码片段功能，目前主流LaTeX扩展默认都支持原生用户片段，不需要额外配置。如果出现片段不显示的情况，可以把editor.snippetSuggestions设为top，让自定义片段优先级高于扩展自带的补全项。

内容的提问来源于stack exchange，提问作者Aditya Harikrish