运行环境探测
将以下提示词粘贴到你的 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与本机环境运行自动化脚本