watermark插件不生效的典型表现是重启vscode后打开文件无水印，或仅在部分语言文件中显示；主因是默认仅作用于活动编辑器且受限于语言模式、position等配置格式错误、opacity过低、fontsize单位错误、color格式不合法、工作区设置覆盖、图像路径斜杠错误、与背景插件z-index冲突及字体不支持中文等。
Watermark 插件不生效的典型表现
装完插件重启 VSCode，打开任意文件却看不到水印；或者只在部分文件类型（如 .js）里出现，.py 或 .md 里完全没反应。这不是插件坏了，而是它默认只对「活动编辑器」生效，且不支持所有语言模式——比如它不会往 Markdown 预览或终端里加水印，只作用于当前聚焦的代码编辑区。
watermark.text 配置后文字不显示或位置错乱
常见原因是没配 watermark.position 或值写错。该字段必须是字符串，合法值只有："top-left"、"top-right"、"bottom-left"、"bottom-right"、"center"。漏掉引号、大小写写成 TopLeft 或拼成 centered 都会导致整个水印配置被忽略。
-
watermark.opacity默认是0.1，太淡容易误以为没生效，建议先调到0.3测试 -
watermark.fontsize单位是像素，但不接受"14px"这种带单位写法，只认纯数字，比如16 -
watermark.color必须是十六进制（"#666"）、RGB（"rgb(102,102,102)"）或英文色名（"gray"），"lightgray"可以，"light gray"就不行
多项目共存时水印只在部分工作区起作用
Watermark 插件读取的是用户级 settings.json，但如果你在某个项目根目录下有 .vscode/settings.json，且里面写了 "watermark.enabled": false 或覆盖了其他水印参数，就会优先采用工作区设置——这常被当成“插件抽风”。检查方式很简单：命令面板运行 Preferences: Open Settings (JSON)，分别看「User」和「Workspace」两个标签页里的配置是否冲突。
- 想让水印仅对特定项目启用？删掉用户级配置，在对应项目的
.vscode/settings.json里单独加"watermark.text"等字段 - 禁用某项目水印，不要删配置，设
"watermark.enabled": false更稳妥 - 图像水印路径用
file:///协议，Windows 路径中的反斜杠\必须全换成正斜杠/，否则加载失败
水印和背景图插件同时使用时互相遮挡
如果你还装了 background 类插件（比如 Background Cover），两者都靠 CSS z-index 控制层级，而 Watermark 默认 z-index 是 99999，Background 插件常用 99998 或更高——结果就是水印盖不住背景图，或者反过来。解决方法不是改 z-index，而是明确用途边界：Watermark 专用于文字/小图标水印，需要铺满全屏背景图请直接用 background 插件的 background.fullscreen 配置，别混用。
真正容易被忽略的是：Watermark 的文字渲染依赖编辑器当前字体栈，如果 editor.fontFamily 里第一个字体不支持中文（比如只写了 "Fira Code"），而你设的 watermark.text 是中文，就可能显示为方框或空白。测试时先用英文文本，确认位置和透明度正常后再换中文。
