Chrome.downloads.download接口文件名非法字符处理问题咨询

1. 覆盖Chrome非法文件名字符的正则表达式 #

Chrome对文件名的限制包含操作系统通用非法字符+自身额外校验规则，以下正则可覆盖绝大多数场景，将首尾的空格/点、所有控制字符、系统非法字符、常见Unicode不可打印字符替换为_：

const invalidCharsRegex = /(^[\s.]|[\s.]$)|[\x00-\x1F\\/:*?"<>|\r\n\u200B\u200C\u200D\uFEFF]/g;
const sanitizedFilename = filename.replaceAll(invalidCharsRegex, '_');

说明：

• (^[\s.]|[\s.]$)：匹配文件名首尾的空格或点，避免出现filename.、filename这类Chrome拦截的格式；若需要支持隐藏文件（如.gitignore），可移除开头的[\s.]匹配
• [\x00-\x1F]：ASCII控制字符，几乎所有文件系统都禁止
• \\/:*?"<>|：Windows、macOS、Linux通用的文件系统非法字符
• \r\n：换行、回车字符，会导致文件名解析异常
• \u200B\u200C\u200D\uFEFF：常见的Unicode不可打印/零宽字符，Chrome会将其判定为非法

如果需要更严格的处理，还可补充过滤\u2028\u2029（行分隔符/段落分隔符）等其他Unicode控制字符。

2. Chrome文件名规则的官方说明 #

Chrome的chrome.downloads.download()接口对filename的限制结合了操作系统文件系统规则和Chrome自身的安全校验，官方明确的规则包括：

• 禁止包含ASCII控制字符（\x00-\x1F）
• 禁止包含文件系统通用非法字符：\ / : * ? " < > |
• 文件名不能以点或空格结尾（部分系统允许，但Chrome会统一拦截）
• 禁止包含Unicode不可打印字符（如零宽字符、行分隔符等）
• 文件名不能为空或仅由空白字符组成

Chrome会根据运行的操作系统做额外适配，但核心非法字符规则跨平台统一。官方文档在chrome.downloads API的参数说明中对filename合法性有简要提及，但未完全列出所有Unicode非法字符，实际校验逻辑由Chrome内部实现，会拦截任何可能导致文件系统错误或安全风险的字符。

3. 能否让Chrome自动替换非法字符？ #

不能。chrome.downloads.download()接口会对文件名做严格的合法性校验，一旦检测到非法字符就直接抛出Error: Invalid filename错误，接口没有提供自动替换非法字符的参数或配置项，必须在调用接口前自行完成文件名预处理。

另外你提到的<a>标签下载法确实无法支持创建子目录，因此只能通过预处理文件名的方式解决问题。

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