Vue 3 初始化微信 JSSDK 的核心是“先加载 SDK、再获取签名、最后调用 wx.config”，必须在页面 URL 确定后立即执行，确保时机可控、错误可捕、重复可防；推荐静态引入官方 JS 文件、封装带状态控制的初始化逻辑、在 App.vue onMounted 中主动触发，并全局挂载仅作便利不替代权限检查。
Vue 3 项目初始化时配置微信 JSSDK，核心是“先加载 SDK、再获取签名、最后调用 wx.config”，且必须在页面 URL 确定后执行——不能在路由跳转前或 hash 变化后才配。关键不在“挂载到全局”，而在“时机可控、错误可捕、重复可防”。
一、JS-SDK 文件引入要稳，不依赖构建工具
微信官方 JS 文件不建议用 npm 安装（weixin-js-sdk 包已多年未维护，存在 Promise 兼容、TS 类型缺失等问题）。推荐直接在 public/index.html 的 <head> 中静态引入：
<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>- 为防 CDN 不可用，可加 fallback：
<script>window.wx || document.write('<script src="https://res2.wx.qq.com/open/js/jweixin-1.6.0.js"></script>')</script> - 确保该 script 在 Vue 应用实例创建前就加载完成（放在所有其他 script 之前）
二、封装初始化逻辑，避免重复执行
新建 src/utils/wxSdk.js，用 ref 控制状态，配合当前 URL（不含 hash）发起签名请求：
微信公众号 AI 一条龙运营（总控）
下载
公众号运营｜微信公众号｜公众号一条龙｜公众号全流程｜自媒体运营｜微信自动化｜内容流水线｜AIGC 工作流 — 公众号一条龙运营总控入口，覆盖选题→撰稿→审稿→排版→配图→发布等8个子技能，单条指令即可完成从零到上架的完整图文。面向公众号编辑、自媒体等用户。
- 用
const isReady = ref(false)标记是否已成功 config - 签名接口需传
window.location.href.split('#')[0]，后端据此生成 signature -
wx.config后必须监听wx.ready和wx.error，失败要明确抛出或记录 - 返回 Promise，方便在路由守卫或组件中 await 等待就绪
三、在应用启动时主动触发（推荐 App.vue onMounted）
不要等用户点分享才初始化——JSSDK 配置失败无法重试，必须尽早暴露问题：
立即学习“前端免费学习笔记（深入）”；
- 在
App.vue的onMounted中调用初始化函数 - 若项目用 Vue Router，可在
router.beforeEach中加 guard：检测!isReady.value时跳转 loading 页或弹 toast - 调试阶段保留
debug: true，上线前务必关掉 - 注意：iOS 微信 8.0.30+ 对
wx.config调用有更严校验，timestamp 必须与服务端时间误差 ≤ 5 分钟
四、全局挂载 wx 仅作便利，不替代权限检查
在 main.js 中可将 window.wx 挂到 app.config.globalProperties，但仅用于快捷访问：
app.config.globalProperties.$wx = window.wx- 实际调用如
updateAppMessageShareData前，仍需判断isReady.value === true - 禁止在 setup 中直接写
if (window.wx) { wx.xxx() }—— config 失败时wx对象仍在，但方法不可用 - 涉及
wx-open-launch-weapp等自定义标签，还需在main.js配置：app.config.compilerOptions.isCustomElement = tag => tag.startsWith('wx-')
