3步查看小程序链接名,快速定位推广路径
很多开发者在小程序后台翻来覆去找不到“链接名”这个字段,其实微信官方压根没给“链接名”这个直观的称呼。你真正需要找的,是小程序被外部引用时的唯一标识——小程序原始ID,以及生成URL Scheme或URL Link时用到的路径参数。搞混了这几个概念,就容易陷入“我明明复制了链接,为什么打不开”的困境。
先解决最直接的问题:找到小程序在微信生态里的“身份证”。登录微信公众平台(mp.weixin.qq.com),用小程序管理员账号扫码进入后台。左侧菜单栏找到“开发”->“开发设置”,页面往下拉,你会看到AppID和AppSecret。注意,这里显示的AppID就是小程序的唯一标识,类似你的身份证号。但这不是你要的“链接名”——它更像一个账号,而“链接名”通常指代的是小程序页面路径,比如 pages/index/index 这种格式。
举个例子:你开发了一个点餐小程序,首页路径是 pages/home/home,商品详情页路径是 pages/goods/detail?id=1001。当你需要把某个商品页面分享给好友时,实际生成的链接结构是:小程序原始ID + 页面路径 + 参数。比如 gh_abcdefg@app/pages/goods/detail?id=1001,这里的 gh_abcdefg 就是你的小程序原始ID(在后台“设置-基本设置”里能看到),而 pages/goods/detail 才是你真正需要关注的“链接名”核心部分。
很多新手会犯一个错误:把公众号的“链接名”逻辑套用到小程序上。公众号的链接名是固定的URL,比如 mp.weixin.qq.com/s/xxxx,但小程序的链接是动态生成的。你每次通过微信公众平台-工具-URL Scheme生成的链接,有效期只有30天(未到期可续),而且每个链接都绑定死了具体的页面路径。如果你把生成好的链接发给用户,对方打开后直接跳转到商品详情页,这比让用户先进入首页再翻找商品要高效得多。
实际操作中,获取“链接名”分三步走:
第一步:打开微信开发者工具,在项目根目录找到 app.json 文件,里面 pages 数组下的每个路径,就是你的页面“链接名”候选。比如 "pages/index/index",去掉开头的 / 后,就是这个页面的标准路径。
第二步:如果需要带参数,直接在路径后加 ?key=value 格式,比如 pages/user/profile?userId=123。注意参数名和值不要用中文,微信会做URL编码,容易导致解析错误。
第三步:在微信公众平台后台,进入“工具-URL Scheme”,选择“生成加密URL Scheme”,输入你的页面路径(比如 pages/index/index),系统会自动生成一个以 https://wxaurl.cn/ 开头的短链接。这个短链接就是你可以直接发到微信群、公众号文章或短信里的“链接名”。
还有一个被忽略的细节:测试版和正式版的链接名不同。如果你的小程序还在开发阶段,用开发者工具预览时,生成的二维码或链接会在7天内失效,而且只能由体验者打开。而发布到线上版本后,通过后台生成的URL Scheme才是长期有效的(前提是每年续期)。很多开发者踩过坑:把测试链接直接发到用户群里,结果第二天就打不开了。
对比一下两种常见场景:
场景A:你想在公众号文章里插入小程序卡片。这时候不需要“链接名”,而是需要小程序路径和小程序原始ID。在公众号后台编辑文章时,点击“小程序”按钮,输入AppID和页面路径即可。
场景B:你想在短信或邮件里放一个可直接点击跳转的链接。这时候必须用URL Scheme或URL Link。前者适合在微信内打开,后者可以在系统浏览器中先提示“是否打开微信”再跳转。选择哪种取决于你的用户场景:如果用户大概率在微信里点链接,用URL Scheme;如果用户可能在短信App里直接点,用URL Link更稳妥。
最后分享一个进阶技巧:动态链接名。如果你的小程序需要根据用户身份生成不同的页面,比如每个用户都有一个专属的个人主页,路径可能是 pages/user/home?uid=openid。这时候千万不要手动拼接每个用户的链接,而是用云调用接口,在服务器端生成带参数的URL Scheme。微信官方提供了 generateUrlScheme 接口,传入 path 和 query 参数,返回一个加密链接。这样你只需要维护一套逻辑,就能给每个用户生成独一无二的“链接名”。
记住一个检查点:无论你怎么生成链接,最后一定要在微信开发者工具的“真机调试”里测试。在手机微信中打开链接,看页面是否正常加载,参数是否传递成功。很多问题只有真机才能暴露——比如路径大小写写错、参数名拼错、页面不存在(跳转后白屏)。

