直接用link标签引入CSS会404，因VS Code Webview禁用外部资源加载，相对路径被解析为vscode-webview://协议而非本地file://；须用vscode.Uri.file()和webview.asWebviewUri()转换为vscode-resource://URI才能正确加载。
为什么直接用 link 标签引入 CSS 会 404？
VS Code Webview 默认禁用外部资源加载，<link rel="stylesheet" href="style.css"> 中的相对路径会被解析为浏览器地址栏当前 URL（如 vscode-webview://...），而实际文件在本地磁盘上，协议不匹配导致 404。VS Code 不允许直接读取 file:// 或普通相对路径，必须显式声明资源位置。
怎么用 vscode-resource 协议正确加载本地 CSS？
核心是把本地文件路径转成 VS Code 可识别的资源 URI。需配合 vscode.Uri.file() 和 webview.asWebviewUri() 两步转换：
-
vscode.Uri.file()构造绝对路径的Uri对象（如Uri.file("/path/to/ext/css/main.css")） -
webview.asWebviewUri(uri)将其转为形如vscode-resource:/path/to/ext/css/main.css的安全 URI - 把这个 URI 字符串插入
<link href="...">的href属性中
示例代码片段：
const cssPath = vscode.Uri.file(
path.join(context.extensionPath, 'media', 'style.css')
);
const cssUri = webview.asWebviewUri(cssPath);
webview.html = `
<html>
<head>
<link href="${cssUri}" rel="stylesheet">
</head>
<body>...</body>
</html>
`;
常见错误：CSS 加载了但样式不生效？检查这三点
即使 URI 正确，样式仍可能失效：
立即学习“前端免费学习笔记（深入）”；
- Webview 默认启用 CSP（内容安全策略），若未在
<meta http-equiv="Content-Security-Policy">中允许style-src 'self' vscode-resource:，内联样式或@import会被拦截 - CSS 文件里用了相对路径引用字体、图片等资源（如
url(../fonts/icon.woff)），这些路径不会被自动重写，必须同样用asWebviewUri()处理并注入 HTML 中作为变量 - VS Code 1.84+ 对
vscode-resource:协议做了更严格校验——路径必须在扩展目录内，且不能含..跳转；建议统一用path.join(context.extensionPath, ...)构造路径，避免手动拼接
替代方案：要不要改用内联 CSS？
对简单样式或小项目，直接读取 CSS 文件内容并内联进 <style></style> 是更稳妥的选择，绕过所有路径和 CSP 限制：
- 用
fs.readFileSync(cssPath.fsPath, 'utf8')读取内容（注意：仅限 Node.js 环境，即 extension.ts 中） - 将字符串插进
<style>${cssContent}</style> - 缺点是无法利用浏览器缓存、调试困难、大文件影响首屏渲染；适合工具类插件或原型验证
真正需要热更新或复杂主题管理时，还是得回到 vscode-resource + 正确 CSP 配置的老路——路径处理和策略声明漏掉任何一环，样式就静默失败。
