原生微信小程序研发,如何对图片进行统一管理?

目标: 统一在配置文件中管理图片,用变量存储,换图标时只需修改链接即可,无需更改业务代码,且方便查找。

tips: 不建议在 asset 中存储大量图片,原因是官方要求小程序内存要限制在2M以内,图片放多了占资源,会扩大包体积。若仅放几个代表性小图标则影响不大。

1. 创建 config/img 文件,放置图片链接,方便统一管理

管理图片的cdn链接(或其他链接,只要能加载出图片即可)

js 复制代码
// config/image.js 统一管理图片链接
const IMG_BASE_URL = 'https://cdn.example.com/'; // 云存储基础 URL

export default {
  // 静态图片(直接使用完整 URL)
  IELTSImg: 'https://cdn.example.com/2025/07/07/5c238a94de137ee6bcabefbe1e1fd37a.png',
  defaultLogo:`https://cdn.example.com/2025/07/07/2f32b9151953f0e8caee46b57ac1b3da.png`, // 默认兜底logo
  // 用IMG_BASE_URL 拼接
  logos:{
	  logo: `${IMG_BASE_URL}logo.png`,
	  defaultAvatar: `${IMG_BASE_URL}default-avatar.png`,
	  // 动态图片(封装生成逻辑)
	  userAvatar: (userId, size = '100x100') => {
	    return `${IMG_BASE_URL}avatars/${userId}_${size}.jpg?timestamp=${Date.now()}`;
	  },
  },
  // 小图标
  icons: {
  },
};
2. 在 app.js 中 定义全局变量。

这里全局变量用的 globalData

js 复制代码
// app.js
import imgConfig from './config/img.js'
App({
  onLaunch: function(options) {
    this.autoUpdate();
  },
  globalData: {
    userInfo: null,
    imgs: imgConfig, // 图片配置
  }
})
3. 在页面中引用

方式 1:直接在页面的js文件下引入。需要在每一个要引入的页面加如下代码:

const app = getApp();
const images = app.globalData.imgs;

js 复制代码
// pages/home/index.js
// 这两句是核心
const app = getApp();
const images = app.globalData.imgs;
Page({
  data: {
    logo: imgs.logo,
    userAvatar: imgs.userAvatar('user123'),
  },
});

方式 2:在 WXML 中直接调用(需通过 JS 传递)

如果不想在 JS 中定义 data,可以封装一个工具函数:

js 复制代码
// utils/image.js
const getAppImages = () => {
  const app = getApp();
  return app.globalData.images;
};
 
export { getAppImages };

这个工具函数可以全局引用。

页面 js 中,引入刚才定义好的工具方法:

js 复制代码
// pages/home/index.js
import { getAppImages } from '../../utils/image';
Page({
  onLoad() {
    this.images = getAppImages();
  },
});

页面 wxml 中,使用images变量:

html 复制代码
<!-- pages/home/index.wxml -->
<image src="{{images.logo}}" mode="aspectFit" />
相关推荐
WangHappy8 小时前
不写 Canvas 也能搞定!小程序图片导出的 WebView 通信方案
前端·微信小程序
小时前端13 小时前
微信小程序选不了本地文件?用 web-view + H5 一招搞定
前端·微信小程序·uni-app
icebreaker1 天前
Weapp-vite:原生模式之外,多一种 Vue SFC 选择
前端·vue.js·微信小程序
icebreaker1 天前
重走 Vue 长征路 Weapp-vite:编译链路与 Wevu 运行时原理拆解
前端·vue.js·微信小程序
大米饭消灭者4 天前
Taro是怎么实现一码多端的【底层原理】
微信小程序·taro
FliPPeDround5 天前
Vitest Environment UniApp:让 uni-app E2E 测试变得前所未有的简单
微信小程序·e2e·前端工程化
FliPPeDround5 天前
微信小程序自动化的 AI 新时代:wechat-devtools-mcp 智能方案
微信小程序·ai编程·mcp
吴声子夜歌5 天前
小程序——布局示例
小程序
码云数智-大飞5 天前
如何创建自己的小程序,码云数智与有赞平台对比
微信小程序
luffy54595 天前
微信小程序页面使用类似filter函数的wxs语法
微信小程序·小程序