问题现象
WebStorm 默认能识别 .env、.env.production,但可能无法识别 .env.development。
这个问题一般不影响框架读取环境变量配置,但会影响 IDE 中的文件图标、文件类型识别和编辑体验。

解决步骤
打开 File Types 设置
进入设置页面:
Settings / Preferences → Editor → File Types
新建 env 文件类型
在 Recognized File Types 区域点击 + 新建文件类型。
建议填写:
Name:envDescription:配置文件
填写后点击 OK。

添加 .env.development 匹配规则
选中新建的 env / 配置文件 文件类型,在 File name patterns 区域点击 +。
在弹窗中输入:
.env.development
然后点击 OK。

保存设置
确认 File name patterns 中已经出现 .env.development,点击 OK 或 Apply 保存设置。

验证效果
回到项目文件树,确认 .env.development 不再显示为未知文件,并且和其他 env 配置文件保持一致。
注意事项
- 这个设置只影响 IDE 的文件类型识别,不影响项目运行时读取环境变量。
- 如果项目还有
.env.local、.env.test、.env.staging等文件,也可以按同样方式添加到File name patterns。 - 不要在截图或文档中暴露真实密钥、Token、数据库密码等敏感配置。
