遇到Uniapp配置meta不生效怎么解决

Uniapp是一种基于 Vue.js 的跨平台应用开发框架，其开发简单、易上手，可以快速构建出 iOS、Android 和 H5 页面，成为现在移动应用开发的重要工具之一。然而，跨平台应用的开发也带来了一些问题，比如本文即是解决 uniapp 页面配置 meta 不生效的问题，希望对读者有所帮助。

问题描述

近期有开发者反馈在使用 uniapp 构建的 H5 页面中，配置 meta 标签没有生效，即在浏览器中查看网站源代码，找不到相应的 meta 标签。但在开发工具的预览中和手机端查看页面均能够正常显示。

问题解决

1、确认 meta 内容是否正确

首先需要确保 meta 标签的内容是否正确，在 uniapp 的 page.json 中配置：

"meta": {"viewport": "width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no","keywords": "uniapp, meta, 问题, 解决","description": "uniapp 配置 meta 不生效的解决方法","apple-mobile-web-app-capable": "yes","apple-mobile-web-app-status-bar-style": "black","format-detection": "telephone=no,email=no,address=no"
}

其中，viewport、keywords、description 是必要的 meta 标签，可添加其他的 meta 标签进行个性化配置。

2、在 index.html 中添加 meta 标签

如果在 page.json 配置 meta 后在页面源代码中不存在相应的标签，需要在 uniapp 项目的 index.html 中将 meta 标签手动添加进去。例如，在 head 标签中添加 viewport 的 meta 标签：

<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />

如果需要添加其他的 meta 标签，可参考第 1 步中的配置。

3、确认 uniapp 打包配置

如果在前两步中均未能解决问题，需要确认 uniapp 打包的配置，主要包括以下两个方面：

是否在 uniapp 的 manifest.json 中配置了打包的路径

manifest.json 是 uniapp 构建的配置文件，需要在其中设置打包的路径。具体而言，需要在 manifest.json 中的 weex > appboard > src 属性或 h5 > router > pages 属性中添加需要打包的页面路径。

// weex > appboard > src 示例
"weex": {"appName": "UniApp","appBoard": "/index.vue","pages": ["pages/tabbar/index/index","pages/tabbar/quick-work/quick-work","pages/tabbar/find/find","pages/tabbar/mine/mine"]
}// h5 > router > pages 示例
"h5": {"custom": {"titleNView": true,"scrollIndicator": "none"},"router": {"mode": "hash","pages": [{"path": "/","style": {"navigationBarTitleText": "首页"},"query": "","meta": {"viewport": "width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no","keywords": "uniapp, h5, 打包配置, manifest.json","description": "uniapp 配置 meta 不生效的解决方法","apple-mobile-web-app-capable": "yes","apple-mobile-web-app-status-bar-style": "black","format-detection": "telephone=no,email=no,address=no"}}]}
}

是否在 uniapp 的 vue.config.js 中配置了打包的路径

除了在 manifest.json 中配置打包路径，也可以在 uniapp 项目的根目录中的 vue.config.js 文件中进行配置，主要是在 outputDir 和 pages 属性中进行设置：

module.exports = {outputDir: 'dist/h5',pages: {index: {entry: 'src/main.js',template: 'public/index.html',filename: 'index.html',title: 'Index Page',chunks: ['chunk-vendors', 'chunk-common', 'index']}}
}

以上为部分示例代码，具体请查阅官方文档或在开发过程中进行调试。

结论

在 uniapp 中配置 meta 标签后，如果在页面源代码中不存在相应的标签，需要手动在 index.html 中添加；如果打包后仍未生效，需要确认 manifest.json 和 vue.config.js 中的配置是否正确。希望本文解决了您的问题，也希望 uniapp 能够越来越完善，成为更加稳定、易用的开发工具。