.d.ts声明文件的文件名除可读性外，是否还有其他特殊实际作用？

文件名对普通全局声明类 .d.ts 无直接功能影响 #

你遇到的重命名后依然生效的情况是符合 TypeScript 设计逻辑的：你写的declare module '*.vue'属于全局模块声明，只要该.d.ts文件被tsconfig.json中的include配置覆盖，TS 就会自动扫描并把内部的全局类型、模块声明合并到全局类型空间，此时文件名仅起到可读性作用，不影响功能。

以下场景下 .d.ts 文件名有实际约束作用 #

• 第三方包类型入口场景
  如果你开发对外发布的 npm 包，需要在package.json的types/typings字段指定类型声明入口，此处必须和实际的声明文件名完全匹配，业内默认的入口声明文件名为index.d.ts，如果文件名写错，下游安装包后会无法读取到类型定义。
• 模块化声明文件的导入场景
  如果你的.d.ts是模块化文件（内部有import/export语句，不属于全局声明），当你需要手动导入该文件内的类型时，必须按文件名引用，比如文件命名为user.d.ts，导入时就要写import type { User } from './user'，文件名错误会直接报模块不存在。
• 工具链适配场景
  不少前端工具链会对特定命名的.d.ts做优先级处理，比如 Vite 会优先读取vite-env.d.ts内的环境变量类型，Vue 官方脚手架默认生成shims-vue.d.ts识别单文件组件类型，统一的命名约定既可以避免不同依赖的声明冲突，也能让工具做针对性的类型优化。
• 声明文件批量管控场景
  当你需要在tsconfig.json的exclude字段过滤特定声明文件时，按文件名前缀匹配是最高效的方式，比如可以直接排除所有test-*.d.ts格式的测试类声明文件，不需要逐个配置完整路径。

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