如何检测Office.js Excel插件代码的最高要求集并集成至CI/CD

1. 基于Office.js类型定义的静态分析 #

Office.js的@types/office-js包中，每个API都带有@requires注释标注对应的要求集版本。你可以借助这个特性做自动化扫描：

• 先确保项目安装了最新版@types/office-js：npm install @types/office-js --save-dev
• 编写Node.js脚本遍历所有代码文件（.ts/.js），提取调用的Office.js API（比如Excel.Range.getColumnCount），然后去类型定义文件中匹配对应的要求集版本
• 脚本统计所有API对应的要求集，自动筛选出最高版本。比如如果代码同时用到了ExcelApi 1.1和1.9的API，最终会返回1.9作为最高要求集

2. 利用官方兼容性检查工具 #

微软提供的Office插件开发工具链里包含兼容性扫描能力：

• 安装office-addin-compatibility-checker工具：npm install office-addin-compatibility-checker --save-dev
• 运行命令扫描代码目录：npx office-addin-compatibility-checker scan ./src
• 工具会输出所有用到的API及其要求集，自动汇总最高版本，还能列出哪些API超出了你指定的兼容基线

3. CI/CD管道集成方案 #

把检测流程自动化到你的CI/CD（比如GitHub Actions、Azure DevOps）中：

• 在CI步骤里先安装依赖：npm ci
• 运行自定义扫描脚本或官方检查工具，生成兼容性报告
• 预设兼容基线（比如你需要支持到ExcelApi 1.8），如果检测到的最高要求集高于基线，直接让管道失败，强制开发者调整代码
• 将检测结果作为CI artifact保存，方便回溯历史兼容性变化

4. 代码注释辅助跟踪（适合大型项目） #

对于庞大的代码库，可以约定开发者在使用高版本要求集API时添加注释，比如// Requires ExcelApi 1.10：

• 编写简单的正则扫描脚本，提取所有这类注释中的版本号
• 结合静态分析结果交叉验证，避免漏扫或误判，确保兼容性跟踪的准确性

内容的提问来源于stack exchange，提问作者Claudio