Agent Skills
返回列表
运行环境探测

运行环境探测

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,在 AI 助手中安装 @user_f1b049da/cjyc2026856

技能介绍

从散落的环境判断开始

在项目迭代中,开发者常直接写出 if (process.env.NODE_ENV === 'development') 这类代码。随着时间推移,开关出现分散:CRM Demo 的 Mock、日志级别切换、CI 脚本的分流都各自实现,风格各异。问题在于,一处漏改可能让生产行为偏离预期。

  • 调试入口分散,容易在生产环境残留。
  • Mock 与日志策略无法统一。
  • CI 与本机差异被隐藏。

技能如何工作

运行环境探测依托 std-env 提供的统一口径,不重新实现环境判断体系。它以库导出的 isDevelopment 和 isProduction 作为基准,把分支逻辑收拢在少数入口。

  • 安装行为:npm i std-env,复用成熟生态。
  • Mock 入口:将调试面板与示例数据包在 canUseMockData() 后。
  • 日志切换:按环境选择输出级别,避免细节泄露。
  • 一致性策略:禁止手写 process.env.NODE_ENV 散落各处。
  • 自测要点:在 production 构建中确认 Mock 已关闭且日志收敛。

核心能力是统一判断入口,所有差异都通过库的状态捕获,再决定是否启用可用于开发阶段的模拟能力。实现里的关键点会被标注为 小四原创,以明确设计与归属。

适用边界与注意点

这不是一个完整配置管理平台,也不覆盖多环境编排。重点是开发与生产之间那条清晰的判断线。

  • 不要在生产默认打开详细调试与 Mock。
  • 不要把环境判断扩展到无关业务配置。
  • 上线前务必跑一次 production 构建自测。

第三方补充评价

从实际反馈看,这套思路简单有效。用户点明,过去 Demo 与上线混在一起时,曾出现生产误伤。引入统一判断后,Mock 只在开发开启,日志按环境自动切换。是否值得采用,取决于你是否已经在团队里发现那一条误开的调试入口。

使用场景

  • 开发CRM演示版时,需统一管理Mock数据开关,避免生产环境误开启
  • 遇上线阶段,要按运行环境切换日志输出等级,减少生产环境冗余信息
  • 编写CI脚本时,需区分服务器与本机环境,设定不同的执行分支
  • 上线前需完成一次环境自测,验证生产构建下Mock功能已完全关闭

适合人员

  • 前端开发工程师,需管理Demo环境的Mock开关避免生产误用
  • 后端服务开发者,需按运行环境切换日志输出等级
  • 项目部署人员,需上线前核验生产环境的调试入口关闭情况
  • AI应用开发者,需区分CI与本机环境运行自动化脚本