关于WXT浏览器扩展已列与未列脚本的规则及文档理解疑问

1. 脚本命名与“已列/未列”的理解是否正确？ #

你的原理解不正确。WXT 定义的“未列脚本”特指 entrypoints/{name}/index.[jt]sx? 结构的文件——即每个入口子目录下以 index 开头的脚本。而 entrypoints/sidepanel/sidepanel.ts 这类非 index 命名的脚本，既不是“已列脚本”，也不属于官方定义的“未列脚本”范畴，它只是入口目录下的普通模块文件，不会被当作独立入口处理。

2. 已列脚本的影响与 manifest 疑问 #

已列脚本（比如直接放在 entrypoints 根目录下的 content.ts、background.ts 等）会被 WXT 自动识别为扩展的核心入口，自动添加到 manifest.json 对应字段中（比如 content 脚本会出现在 content_scripts，background 脚本对应 background.service_worker）。

你实验中 entrypoints/sidepanel/sidepanel.ts 没出现在 manifest 里，是因为它根本不是“已列脚本”——已列脚本的定义是直接放在 entrypoints 根目录下、符合特定类型命名的文件，而非子目录下的文件。

3. 哪些脚本属于未列脚本？ #

• entrypoints/sidepanel/ 下的脚本：只有 index.ts/index.jsx 这类符合 entrypoints/{name}/index.[jt]sx? 模式的文件才是未列脚本，该目录下其他命名的脚本只是普通模块，不属于未列脚本。
• components/foo/ 下的脚本：这类属于项目普通组件/模块文件，和“未列脚本”完全无关，未列脚本的定义仅针对 entrypoints 子目录下的 index 开头文件。
• 并非所有脚本都是未列脚本：只有严格符合 entrypoints/{name}/index.[jt]sx? 模式的文件才是，其他要么是已列入口（entrypoints 根目录下的特定命名文件），要么是普通模块。

4. 关于文档模式的疑问 #

你的推测不准确。WXT 官方定义的未列脚本模式就是 entrypoints/{name}/index.[jt]sx?，设计意图是：允许你在 entrypoints 下创建子目录，用 index 文件作为该子目录的入口，但这个入口不会被自动添加到 manifest 中——你需要手动在 wxt.config.ts 里配置它的使用场景（比如作为 sidepanel 的入口、或注入到特定页面的脚本）。

而 entrypoints/{name}/*.[jt]sx? 模式下的其他文件，只是该子目录下的依赖模块，并非未列脚本。

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