feat: 配置 wordcloudwechat OSS 资源桶地址

This commit is contained in:
2026-08-06 22:50:11 +08:00
parent 2f5e12d252
commit 8de00e6614
3 changed files with 17 additions and 7 deletions
+15 -5
View File
@@ -226,17 +226,27 @@ npm run dev:h5
- 小程序包体积长期保持 < 500KB;
- 后续更换产品图只需在图床后台操作,无需重新发版。
### 阿里云 OSS 实际操作
### 阿里云 OSS 实际操作(当前桶:wordcloudwechat
1. 在阿里云 OSS 创建 Bucket,建议区域选择离用户近的国内地域(如 `oss-cn-hangzhou`,读写权限选择**公共读**;如果后续要用于用户上传,再配置单独 Bucket 或后端预签名
2. 把 `src/img/` 上传到 Bucket 根目录 `img/``src/icon/` 上传到 Bucket 根目录 `icon/`(保持路径一致,前端无需改文件名)
1. 当前 Bucket `wordcloudwechat` 已创建:地域 `华东1(杭州)`,读写权限**公共读**,可直接使用
2. 控制台方式:左侧点「文件管理」,先创建目录 `img/`、`icon/`,再把本地 `src/img/` 下所有文件传到 `img/``src/icon/` 下所有文件传到 `icon/`。目录层级必须和本地一致
3. 打开 `src/utils/asset.ts`,将 `ASSET_BASE_URL` 填成桶地址:
```ts
export const ASSET_BASE_URL = 'https://your-bucket.oss-cn-hangzhou.aliyuncs.com'
export const ASSET_BASE_URL = 'https://wordcloudwechat.oss-cn-hangzhou.aliyuncs.com'
```
`src/utils/asset.ts` 已默认填成上面的 OSS 地址;如果用 CNAME 域名,可改成 `https://wordcloudwechat.cn-hangzhou.taihangtop.cn`。
4. 项目中商品图、首页成品图、商品 icon、设计清单/订单里已存的 icon 会自动拼接成远程 URL;本地路径作为兜底,后端没就绪时不裂图。
5. 等 OSS 图片稳定后,可把 `config/index.js` 中 `src/img` 的 copy 规则移除,进一步压缩 dist 体积;`src/icon` 按需保留或也迁到 OSS。
6. 微信小程序后台需要在「开发管理 - 服务器域名」配置 `downloadFile` 合法域名,且必须是 HTTPS。
6. 微信小程序后台需要在「开发管理 - 服务器域名」配置 `downloadFile` 合法域名`https://wordcloudwechat.oss-cn-hangzhou.aliyuncs.com`;如果改用了 CNAME,则填对应 HTTPS 域名
如果用 `ossutil64` 命令行一次传完,在项目根目录执行:
```bash
ossutil64 config
ossutil64 cp -r -f img oss://wordcloudwechat/img
ossutil64 cp -r -f icon oss://wordcloudwechat/icon
```
---
+1 -1
View File
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -4,7 +4,7 @@
* 留空表示继续使用小程序包内本地资源(/icon、/img);
* 配置阿里云 OSS / CDN 后,所有经 assetUrl 处理的资源会自动拼接远程地址。
*/
export const ASSET_BASE_URL = ''
export const ASSET_BASE_URL = 'https://wordcloudwechat.oss-cn-hangzhou.aliyuncs.com'
/** 把本地资源路径转成远程 URL;已经是 http(s) 或 wxfile/data 的保持不变 */
export function assetUrl(path?: string | null): string {