很多人在 Tauri v2（尤其是 Linux 系统）中使用 convertFileSrc() 或 asset://localhost 协议加载本地图片、视频、音频等资源时，经常遇到 403 Forbidden 错误。Windows/macOS 可能正常，Linux 却直接翻车。

本文把整个坑的来龙去脉、根本原因、glob 匹配规则彻底讲清楚，并给出最稳的配置方案，帮助大家一次性避坑。

一、问题现象

• 使用 convertFileSrc(fullPath) 生成的 URL 在 <img>、<video>、<audio> 等标签中加载失败
• 浏览器控制台报 403
• 终端（Rust 侧）日志提示类似：

  asset protocol not configured to allow the path: /home/user/.local/share/xxx/xxx.png
  

• 尤其容易出现在 隐藏目录（以 . 开头的目录）下：.local/share、.cache、.config 等

二、根本原因：Tauri 的 Glob Scope + Linux 隐藏目录规则

Tauri v2 的 assetProtocol.scope 使用的是 Rust globset 库实现的 glob 模式来做安全校验。只有路径匹配 scope 里的 glob，才允许浏览器通过 asset 协议访问。

最坑的一点在于，Linux（Unix-like 系统）下：

通配符 *、?、** 等 默认不会匹配以 . 开头的路径（dotfiles / dotdirs），除非你在 glob 模式里字面写出 .。

所以即使你写了最宽松的 "**/*"，它也进不了 .local、.cache 等隐藏目录，导致 403。

这不是 bug，而是 Tauri 为了安全故意设计的（和 Linux shell 的 ls * 默认不显示隐藏文件一样）。

三、Glob 模式最容易搞混的两个写法：**/ vs **/*

glob 写法	含义	能匹配什么	在 assetProtocol.scope 里的实际效果	推荐程度
**/*	递归匹配所有文件	文件（如 a.png、sub/b.mp4）	✅ 强烈推荐	★★★★★
**/	递归匹配所有目录	纯目录路径（如 images/、sub/）	❌ 几乎没用（scope 要的是文件路径）	★☆☆☆☆

一句话总结：

• **/* = “递归所有文件”（你 99% 的情况都需要这个）
• **/ = “递归所有目录”（基本不要单独写在 scope 里）

正确写法是 你的路径/**/* 或直接 **/*

四、正确配置（一步到位）

1. 主配置（推荐同时加 Linux 专属配置）

src-tauri/tauri.conf.json（全局）：

{
  "app": {
    "security": {
      "csp": "default-src 'self' ipc: http://ipc.localhost; img-src 'self' asset: http://asset.localhost; video-src 'self' asset: http://asset.localhost; audio-src 'self' asset: http://asset.localhost; style-src 'self' 'unsafe-inline';",
      "assetProtocol": {
        "enable": true,
        "scope": [
          "**/*",
          "**/.local/share/**/*",
          "**/.cache/**/*",
          "$CACHE/**",
          "$CONFIG/**",
          "$HOME/**"
        ]
      }
    }
  }
}

src-tauri/tauri.linux.conf.json（Linux 专属，强烈建议）：

{
  "app": {
    "security": {
      "assetProtocol": {
        "enable": true,
        "scope": [
          "**/*",
          "**/.local/share/**/*",
          "**/.cache/**/*",
          "$CACHE/**",
          "$CONFIG/**"
        ]
      }
    }
  }
}

这样 Windows/macOS 不会被多余的 scope 影响。

2. 代码侧使用（不变）

import { convertFileSrc } from '@tauri-apps/api/core';

const assetUrl = convertFileSrc(absoluteFilePath);

五、操作流程

1. 按上面修改配置文件
2. （推荐）cargo clean
3. pnpm tauri dev（或 npm run tauri dev）测试
4. 还是 403？看终端日志，把报错里提示的路径对应的 glob 补进去

六、额外避坑小贴士

• 用 Tauri 内置变量 $CACHE、$CONFIG 最香，自动处理平台差异
• 如果是用户通过 dialog.open() 选择的路径，Tauri 会自动扩展 scope，但持久化路径仍需写进配置
• 打包进 bundle 的资源不需要 assetProtocol，走 frontendDist 即可
• Rust 版本建议 ≥ 1.77，Tauri CLI 保持最新

---

总结：
Tauri 2 的 asset 403 坑，99% 是因为 Linux 下 glob 默认不匹配 . 开头的隐藏目录。只要把 **/* + **/.local/share/**/* + $CACHE/** 写全，问题基本秒解。

把这篇配置直接复制到你的项目里，基本不会再踩这个坑了。

希望这篇文章能帮到更多 Tauri 开发者少走弯路！
如果你还有其他 Tauri v2 的奇葩问题，欢迎继续留言～

在 TypeScript 的高级玩法里，infer 经常让初学者感到头大。它长得像关键字，用起来像正则表达式的“捕获组”，还必须寄生在 extends 条件语句里。

要把这东西彻底搞清楚，我们得先拆解它的核心逻辑，再看看它在实战中到底解决了什么问题。

一、 核心概念：infer 到底是什么？

简单来说，infer 就是 “类型系统里的临时变量” 。

在常规的泛型中，是你告诉 TypeScript 具体的类型；而在使用 infer 的场景下，是 TypeScript 自动推断出某个位置的类型，并把它存到一个变量里供你后续使用。

语法规则：

1. 只能在 extends 条件类型的“真”分支中使用。
2. 配合模式匹配使用。 你给出一个“模版”（比如函数结构、数组结构），让 TS 去匹配并提取其中的零件。

二、 语义纠偏：extends 的“变脸”

很多人的困惑源于 extends 这个词。在 Class 里它是“继承”，但在类型定义（尤其是配合 infer）时，它其实是 “模式匹配（Pattern Matching）” 。

• Class 中的 extends：我是你的后代，我继承你的基因。
• 类型中的 extends：我能不能塞进你这个形状的盒子里？

当你在写 T extends (infer R)[] ? R : never 时，你实际上是在对 TS 说：

“帮我看看 T 是不是一个数组。如果是，顺便把数组里装的那个东西的类型抠出来，起个临时名字叫 R。如果匹配成功，我就要这个 R。”

---

三、 实战场景：它能解决什么痛苦？

如果没有 infer，类型系统就是静态的、死板的。有了它，类型系统就具备了“解剖”和“重组”的能力。

1. 经典的“解包” (Unpacking)

这是最常见的用途。比如从 Promise、Array 或 Map 中提取内部类型。

// 提取 Promise 内部的类型
type Unbox<T> = T extends Promise<infer U> ? U : T;

type Str = Unbox<Promise<string>>; // 得到 string

2. 函数全家桶 (Function Extraction)

你可以轻松拿到一个函数的返回类型、参数类型，甚至是构造函数的参数。

// 提取函数第一个参数的类型
type FirstParam<T> = T extends (arg1: infer P, ...args: any[]) => any ? P : never;

function saveUser(id: number, name: string) {}
type IDType = FirstParam<typeof saveUser>; // number

3. 字符串模板的“手术刀”

这是 TS 4.1 之后的黑科技。你可以用它来拆分字符串，做一些像“驼峰转下划线”之类的类型转换。

type GetExtension<T> = T extends `${string}.${infer Ext}` ? Ext : never;

type FileExt = GetExtension<"config.json">; // "json"

---

四、 总结：什么时候该用它？

你不需要在每一处代码都写 infer，但在以下场景，它是无可替代的神器：

• 处理第三方库：当你拿不到某个库内部定义的具体接口，但你能拿到它的函数或实例时，可以用 infer 反向推导出它的类型。
• 减少重复定义：不想为了一个返回值再去手动写一遍复杂的 interface。
• 编写通用工具库：它是构建自动化、高适配性类型系统的基石。

虽然 infer 很好用，但它会显著增加类型的理解成本。对于团队协作项目，建议只在底层工具类型（Utils）中使用它，业务代码中还是尽量保持类型声明的直观和显式。