如何使用ImgApp Google Sheet库从图片链接提取宽高尺寸

第一步：安装ImgApp库 #

• 打开目标Google Sheet文件，点击顶部菜单栏「扩展程序」-「Apps 脚本」，打开内置脚本编辑器
• 在脚本编辑器左侧导航栏找到「库」模块，点击模块旁的+号触发添加库弹窗
• 在弹窗的脚本ID输入框中填入1T03nYHRho6XMWYcaumClcWr6ble65mAT8OLJqRFJ5lukPVogAN2NDl-y，点击「查找」
• 版本选择列表里最新的正式发布版本，默认标识符保持ImgApp不变，点击「添加」完成库安装

第二步：写入功能代码 #

将以下代码完整粘贴到脚本编辑器默认打开的Code.gs文件中，点击顶部的保存按钮，按提示给项目命名即可

/**
 * 提取图片直链对应的宽高尺寸
 * @param {string} url 公开可访问的图片直链地址
 * @return {array} 依次返回图片宽度、高度，单位为像素
 * @customfunction
 */
function GET_IMG_SIZE(url) {
  if (!url || typeof url !== "string") return ["请输入有效图片地址", ""];
  try {
    const sizeInfo = ImgApp.getSize(url.trim());
    return [sizeInfo.width, sizeInfo.height];
  } catch (err) {
    return ["提取失败", "请检查链接是否为公开图片直链"];
  }
}

第三步：表格内调用方法 #

• 回到Google Sheet界面，如果你的图片URL存在A列（比如A2单元格是第一条图片链接），直接在B2单元格输入公式=GET_IMG_SIZE(A2)
• 公式回车生效后，B2会自动填入对应图片的宽度，C2会自动填入对应图片的高度
• 需要批量处理时，选中B2、C2单元格，按住单元格右下角的蓝色填充柄向下拖动，即可批量计算所有行对应图片的尺寸

常见报错排查 #

• 提示授权失败：第一次调用公式/运行脚本时会弹出Google授权验证，不要选返回首页，点击弹窗右下角「高级」，再点击「转到[你命名的脚本项目]」，按提示完成授权即可正常使用
• 提示提取失败：检查传入的URL是否为图片直链——要求链接打开后直接展示图片内容，不支持网页跳转链接、需要登录权限的私有链接、配置了防盗链的图片链接
• 提示找不到ImgApp对象：回到脚本编辑器的库设置页，检查ImgApp库的版本是否选择了最新正式版，重新选择后保存脚本即可
• 批量处理时部分行报错：Google Apps Script有短时间请求限额，单次批量处理不要超过100条链接，分批次操作即可避免触发限制

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