uni-app ：uni.openDocument 一键打开 Word/Excel/PPT/PDF，全端兼容实战指南

在 uni-app 开发中，文档预览是高频需求（合同、报表、使用手册、发票等），官方提供的 uni.openDocument(OBJECT) API 可以直接新开页面打开文档，完美支持：doc, xls, ppt, pdf, docx, xlsx, pptx 主流格式，一套代码兼容 App、微信小程序 等多端。

本文基于 uni-app 官方文档（https://uniapp.dcloud.net.cn/api/file/file.html#opendocument）直接复用。

一、什么是 uni.openDocument？

uni.openDocument(OBJECT) 是 uni-app 官方提供的文档预览 API，作用：
** 自动打开预览 → 支持下载/分享/打印**
支持格式：
✅ doc, xls, ppt, pdf, docx, xlsx, pptx。

支持平台：
✅ App（iOS/Android）
✅ 微信小程序
✅ 支付宝/百度/抖音小程序（部分平台）

二、完整代码（直接复制可用）

1. 页面结构

<!-- #ifndef H5 -->
	<view class="other-item" @click="previewFile">
		<text>使用文档</text>
		<text class="arrow-right"></text>
	</view>
	<!-- #endif -->

2. JS 逻辑

<script setup>
const previewFile = () =>{
		uni.downloadFile({
		  url: 'XXXXXX文档地址',
		  success: function (res) {
		    var filePath = res.tempFilePath;
		    uni.openDocument({
		      filePath: filePath,
		      showMenu: true,
		      success: function (res) {
		        console.log('打开文档成功');
		      }
		    });
		  }
		});
	}
</script>

三、总结

uni.openDocument 是 uni-app 最简单、最稳定、官方原生的文档预览方案，不用插件、不用第三方 SDK、不用后端转格式，直接支持 Word/Excel/PPT/PDF，一套代码跑全端。