Sublime Text 默认不识别 .env 文件，需手动绑定：打开 .env 文件 → View → Syntax → Open all with current extension as… → 选 ShellScript 或 INI，即可永久生效并自动生成正确配置。
如何让 Sublime Text 正确识别 .env 文件为 ShellScript 或 INI 类型
Sublime Text 默认不把 .env 当作任何语法高亮类型，打开后是纯文本。这不是 bug，而是它没在内置映射里注册该扩展名。解决方法是手动绑定——但别直接改默认配置，否则升级会丢失。
实操建议：
- 用菜单栏 View → Syntax → Open all with current extension as…，选目标语法（比如
ShellScript），这会立刻生效并写入用户语法映射文件 - 更稳妥的方式：打开
Preferences → Settings – Syntax Specific，在右侧粘贴：{"extensions": ["env"]}，保存后当前文件类型即生效（注意：这是针对当前已设为某语法的文件，不是全局绑定） - 真正全局绑定要编辑
Packages/User/ShellScript.sublime-settings（或对应语法名），加一行："extensions": ["env", "dotenv"]
；但推荐优先用第一种菜单方式，它自动生成正确路径且不依赖你猜语法包名
sublime-syntax 文件里怎么声明扩展名映射
如果你自己写了自定义语法（.sublime-syntax），必须显式声明支持哪些扩展名，否则即使文件存在也不会被自动匹配。
关键点：
- 在 YAML 格式的
.sublime-syntax文件顶部添加file_extensions键，值为字符串数组，例如：file_extensions: [toml, TOML]
- 大小写敏感：写
["json"]不会匹配JSON，如需兼容请同时列出 - 不要写点号：
[".json"]是错的，应为["json"] - 如果已有同名内置语法（如
JSON.sublime-syntax），你的自定义版本必须放在Packages/User/下，且文件名不能和内置冲突（Sublime 会按加载顺序覆盖）
为什么改了 Preferences → Settings – Syntax Specific 没反应
这个设置只对「当前已指定语法的文件」起作用，不是扩展名绑定机制。常见误解是以为在这里加 "extensions" 就能全局生效——其实不能。
典型错误现象：
- 新建一个
foo.xyz，没做任何语法设置，直接打开Preferences → Settings – Syntax Specific，编辑并保存，毫无效果 - 误把
extensions写进全局Preferences.sublime-settings，Sublime 完全忽略该字段 - 路径写错：想绑定
.ts到 TypeScript，却去改了JavaScript.sublime-settings，结果当然不生效
正确做法：先用菜单临时设一次语法（哪怕只是点一下 View → Syntax → TypeScript），再打开 Settings – Syntax Specific 编辑，此时它才代表该语法的专属配置。
Windows 下路径空格和 Unicode 导致 Package Control 安装失败怎么办
当 Sublime Text 安装目录含空格（如 C:\Program Files\Sublime Text）或用户名是中文时，某些语法包（尤其是带编译步骤的）可能因路径解析失败而无法激活扩展名映射。
验证与绕过方式：
- 打开
Console（Ctrl+`），输入sublime.installed_packages()，看是否返回空列表或报错 - 临时将 Sublime 移到无空格路径（如
C:\st\）测试，若正常则确认是路径问题 - 避免使用需要本地构建的语法包（如部分 Rust/Go 高亮），优先选纯
.sublime-syntax实现的包 - 不重装、不改注册表——Sublime 本身不读取系统编码策略，问题出在第三方包的 Python 脚本调用逻辑上
扩展名映射本身不依赖外部工具链，但如果你装的是“带自动注册功能”的插件（比如某些老版 EditorConfig 插件），它们可能在初始化阶段崩掉，导致后续语法绑定失效。这种情况下，禁用可疑插件再试。
