VSCode 默认仅识别 .env 文件，.env.development 等变体被识别为 Plain Text，需在 settings.json 中配置 "files.associations": {"*.env*": "dotenv", ".env.*": "dotenv"} 并重启文件。

DotENV 插件装了但 .env.development 还是灰色？根本不是插件没装好，而是 VSCode 根本没把它当 dotenv 文件处理。

为什么 .env.* 文件不自动高亮

VSCode 默认只识别 .env，对 .env.local、.env.production、docker.env 等统统视为 Plain Text。右下角显示“Plain Text”就是铁证——插件连加载机会都没有。

• 语言模式未激活，语法高亮、注释识别、引号配对全部失效
• 插件注册的语言 ID 是 dotenv，不是 env 或 environment（可在 Change Language Mode 弹窗里确认）
• 已打开的文件不会因 settings 修改而自动刷新语言模式，必须重新打开
• 某些项目用 .env.example 或 secrets.env.bak，需显式覆盖

在 settings.json 中正确配置 files.associations

仅靠手动切换单个文件的语言模式治标不治本。全局/工作区级配置才是稳定解法，且必须写对 glob 规则。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 加这两行（注意逗号、引号、键名格式）：

  "*.env*": "dotenv",<br>".env.*": "dotenv"

• *.env* 匹配 docker.env、.env.bak、secrets.env.json 等 —— env 出现在任意位置
• .env.* 匹配标准变体：.env.development、.env.test、.env.staging
• 别用 *env*：会误匹配 package.json 里的 "env" 字段，导致语法解析错乱
• 改完保存，关闭再重开文件才生效；工作区配置优先级高于用户级

变量补全和跨文件感知为什么还是不工作

mikestead.dotenv 插件本身不解析变量引用关系，它只做静态语法染色。你在 .env 里敲 API_URL，不会从 .env.development 里自动补全值。

• 原生 DotENV 不读取、不合并、不跳转，纯前端渲染
• 如需多环境变量上下文感知，必须额外装 dotenv-flow（同作者），它依赖 files.associations 配置才能识别所有 .env.* 文件
• dotenv-flow 要求项目根目录存在 .env + 至少一个变体（如 .env.development），否则不触发合并逻辑
• 补全提示仍限于当前文件内；跨文件变量定义跳转需 LSP 支持，目前无主流插件提供

敏感内容防护不能只靠高亮

高亮只是视觉提示，不阻止误提交或泄露。真正起作用的是三层隔离：

• .gitignore 必须显式包含：.env、.env.*、*.env（防止 config.env 漏网）
• 用 dotenv-linter 检查硬编码密钥：dotenv-linter .env .env.development
• VSCode 任务集成：在 .vscode/tasks.json 里定义 lint 任务，配合 editor.codeActionsOnSave 实现保存即校验
• 文件编码必须是 UTF-8 无 BOM，否则 require('dotenv').config() 会静默失败，process.env 全为空