能跳转到小程序需同时满足三个条件：运行在微信环境、已引入微信JS-SDK、跳转由用户主动触发；最可靠判断小程序web-view环境的方式是检查window.__wxjs_environment === 'miniprogram'。
在微信内打开的 h5 页面，能跳转到小程序，但必须满足三个硬性条件：页面运行在微信环境、已引入微信 js-sdk、跳转由用户主动触发。缺一不可，否则 wx.miniprogram 一定为 undefined 或调用直接静默失败。
如何判断当前是否处于微信小程序 web-view 环境
不能只靠 ua 字符串匹配，微信浏览器和小程序 web-view 的 JS 运行环境完全不同。前者没有 wx.miniProgram，后者才有。
-
window.__wxjs_environment === 'miniprogram'是最可靠的判断依据，官方明确支持 -
typeof wx !== 'undefined' && typeof wx.miniProgram !== 'undefined'可作为二级校验 - 避免只检查
window.wx—— 微信浏览器里wx存在但wx.miniProgram不存在，会误判 - 不要在
mounted钩子立即调用，SDK 加载有延迟；建议封装成带重试或定时检测的工具函数
为什么引入 jweixin-1.6.0.js 后仍报 wx.miniProgram undefined
常见原因不是 SDK 引入错了，而是加载时机或作用域被破坏：
- CDN 引入方式（如
<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>）必须放在中，且早于任何业务 JS 执行 - 使用
npm install weixin-js-sdk+import wx from 'weixin-js-sdk'时，wx是模块导出对象，不会自动挂载到window，所以window.wx.miniProgram依然不存在 -
uni-app 的构建流程（尤其 Vue CLI 模式）可能把
wx对象打包进模块作用域，需显式赋值：window.wx = wx - 若用
vue.config.js配置了 externals，要确认wx未被排除
跳转代码必须写成对象形式，且路径不能带域名
wx.miniProgram.navigateTo 接收的是对象参数，不是字符串路径。传错格式会导致无反应、无报错、无日志 —— 最难排查的一类问题。
- 正确写法：
wx.miniProgram.navigateTo({ url: '/pages/index/index' }) - 错误写法：
wx.miniProgram.navigateTo('/pages/index/index')（直接报TypeError） -
url必须是小程序内部路径，不能含协议、域名、http://或https:// - 如需传参，用 query 形式：
{ url: '/pages/detail/detail?id=123&from=h5' }，注意中文需encodeURIComponent - 路径需已在目标小程序的
app.json或pages.json中注册，否则白屏
URL Scheme 方案为什么常失效
直接拼 weixin://dl/business/?t=... 看似简单，但实际落地极不稳定：
- 仅安卓微信支持较好，iOS 微信从 8.0.33 起基本屏蔽该 Scheme，点击后大概率跳转失败或弹“无法打开”提示
- 微信版本迭代频繁，Scheme 格式未公开、无文档保障，属于灰度能力，随时可能调整
- 即使生效，也无法携带复杂参数、无法监听跳转结果、无法做 fallback 处理
- 若小程序未与公众号/开放平台关联，或 H5 域名未在公众号「业务域名」中备案，Scheme 会被微信直接拦截
- 真要尝试，必须确保
t参数是经过 URL 编码的完整路径，例如t=pages%2Findex%2Findex
真正健壮的方案永远是：先确保 window.__wxjs_environment === 'miniprogram' 成立，再用 wx.miniProgram.navigateTo 对象调用。所有绕过 JS-SDK 的“快捷方式”，最终都会卡在 iOS 兼容性或微信策略更新上。
