沉梦听雨的编程指南
  • 项目笔记
  • 壁纸小程序项目
沉梦听雨
2025-04-03
目录

开发笔记

# 壁纸小程序项目

# 前言

介绍 -> 教程 -> 组件 -> API

利用好 控制台打印 的方法调试，查看函数方法接收到的参数会是什么

# 推荐高质量开源小程序脚手架合集

名称 技术栈 类型 Star 特点简述
ColorUI 微信原生 / uni-app UI 框架 ⭐️ 9.2k+ 炫酷 UI，适合视觉展示类项目
ThorUI uni-app UI 框架 ⭐️ 2.4k+ 高度组件化，适合后台、商城等
uView UI uni-app + Vue3 UI 框架 ⭐️ 16k+ Vue3 + uni 最强 UI 框架之一
uni-starter uni-app + uniCloud 通用脚手架 ⭐️ 2.2k+ DCloud 官方，内置登录/管理后台
taro-taroify-starter Taro + React + VantUI 跨平台小程序 ⭐️ 1.3k+ 结构清晰，适合 React 开发者
mpvue-quickstart（老） Vue2 + mpvue 微信小程序 ⭐️ 5.8k+ Vue 转小程序早期方案，已停更
mpx 微信小程序 + Mpx 自研框架 ⭐️ 5.6k+ 美团团队出品，类 Vue 写法

# uniapp 相关

# 目录简介

# 全局文件

page.json 文件

涉及到启动页的设置

  • 可设置 condition 属性
  • 或者 pages 数组中第一项表示应用启动页

# 条件编译

# 用户授权

# Vue 相关

Vue3 官方文档：简介 | Vue.js (opens new window)

  • vue2 - 选项式，vue3 - 组合式

生命周期图示

含接收页面参数 API

// 接收页面url参数
onLoad((e) => {
	console.log(e);
})
1
2
3
4

# css 相关

scoped 属性

uni.scss 文件说明

  • 这里是 uni-app 内置的常用样式变量
  • 是 预编译 文件
  • 可引入其他目录下的文件：@import "@/common/scss/self.scss";

使用示例：

<!-- xxx.vue 文件 -->

<!-- scoped：约束只有组件自己可以用这个 css 样式 -->
<style lang="scss" scoped>
.box{
	// width: 60%;
	// width: 40vw;
	// width: 400px;
	width: 130rpx; // rpx响应式px（根据750宽的图纸定义比例，可利用工具等比例缩放)
	height: 130rpx;
	background: orange;
	font-size: 28rpx;
}
.text{
	font-size: 52rpx;	
	color:$custom-color-1; // 引用属性
}
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

尺寸单位 rpx 说明

# 插件

# 写法技巧

... 展开符的使用

示例：

const pets = ref([1,2,3]);
const res = ref([4,5,6]);

// 利用展开符合并数组元素
pets.value = [...pets.value, ...res.value]
console.log(pets.value); // 1,2,3,4,5,6
1
2
3
4
5
6

当轮播图中文字过长时，显示省略符 ...

<template>
		<view class="notice">
			<view class="left">
				<uni-icons type="sound-filled" size="20"></uni-icons>
				<text class="text">公告</text>
			</view>
			<view class="center">
				<swiper vertical autoplay interval="1500" duration="300" circular>
					<swiper-item v-for="item in noticeList" :key="item._id">
						<navigator :url="'/pages/notice/detail?id='+item._id">
							{{item.title}}
						</navigator>
					</swiper-item>
				</swiper>
			</view>
</template>

<style lang="scss" scoped>
		.center{
			flex:1;
			swiper{
				height: 100%;
				&-item{
					height: 100%;
					font-size: 30rpx;
					color:#666;
          			 // 当轮播图中文字过长时，显示省略符...
					overflow: hidden;
					white-space: nowrap;
					text-overflow: ellipsis;
				}
			}
		}
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

# 问题解析

# 为什么 Vue3 写响应式编程多用 const 而不是 let 定义呢？

  • 通常情况下，let 定义变量，const 定义常量。

原因：在 Vue3 中，响应式变量 建议用 const 是因为你不会重新赋值它本身，而只是修改它内部的值（如 .value）。

举个例子：

import { ref } from 'vue'

const count = ref(0)
count.value++  // 修改的是 count 内部的值
1
2
3
4

你可能会疑惑：count 不是变量吗？我还要改它的值，为什么用 const？

其实这里：

  • const count = ref(0)：count 是一个引用（Ref）对象，它不会变。
  • 改的是 count.value，不是 count 本身。

换句话说：我们只要不去 count = ref(100) 重新赋值，就不违反 const 的语义。

为什么推荐用 const 而不是 let：

语法层面 Vue 编码习惯
const 只声明一次，不能被重新赋值，更安全 避免误操作（如不小心 xxx = yyy）
const 定义的变量在编译时更容易被优化 Tree-shaking、性能更好
语义更明确，告诉团队“这个变量的引用不会变” 更易读、更清晰

用 let 会导致误解或误操作：

let count = ref(0)
// 后面不小心写：
count = ref(100)  // 不一定有 bug，但容易逻辑错乱
1
2
3

# 文件上传失败问题

使用 uni-file-picker 插件：

  • 检查配置文件 appid 配置是否正确，解决 图片上传 的跨域问题
  • 服务空间中【跨域配置】，新增域名：localhost:5173，解决图片上传成功之后，显示失败的问题

# 新增记录无默认值的问题

例如创建时间的默认值配置（表结构）：

		"createTime":{
			"title": "创建时间",
			"bsonType": "timestamp",
			"forceDefaultValue":{
				"$env": "now"
			}
		}
1
2
3
4
5
6
7
  • 这个配置 仅在通过 JQL 查询或 uniCloud DB Schema 控制器插入数据时生效
// 云对象文件

// 这个写法，新增的记录会没有默认值
const db = uniCloud.database();
const wallpaperCollection = db.collection('t-wallpaper');

// 这个写法有
const dbJQL = uniCloud.databaseForJQL()
const wallpaperCollection = dbJQL.collection('t-wallpaper');
1
2
3
4
5
6
7
8
9

# 云对象 url 化访问失败

需要先在服务空间的云对象中，设置一下 URL 的 PATH 部分，在默认域名的基础上加多个路径

# uniCloud 相关

官方文档：uniCloud概述 | uniCloud (opens new window)

# 云数据库

# 数据初始化

# JQL 语法

获取云端环境变量

# uni-id 用户体系

  • 下载 uni-id-pages 插件
  • 支持设置钩子函数，做一些初始化操作（比如设置默认用户名）

小程序进行 微信登录时，如果报 appid 的异常

  • 检查 uni-id 的云端配置文件（在 uniCloud/cloudfunctions/common/uni-config-center/uni-id/config.json 中）

云端配置文件

  • 可设置密码强度（需同步修改 /uni_modules/uni-id-pages/config.json 中的配置）
  • 设置密码加密密钥
  • 可配置小程序
  • 可配置短信服务
  • 用户注册时设置默认角色
  • ...

界面上的内容和样式，在 /uni_modules/uni-id-pages 目录下修改

# 配置未登录时自动跳转登录页

在 pages.json 文件中添加属性：

	"uniIdRouter": {
		// #ifdef MP-WEIXIN 
		"loginPage": "uni_modules/uni-id-pages/pages/login/login-withoutpwd",
		// #endif 
		// #ifndef MP-WEIXIN 
		"loginPage": "uni_modules/uni-id-pages/pages/login/login-withpwd",
		// #endif 
        
		"needLogin": [
			"pages/blog/edit"
		]
	}
1
2
3
4
5
6
7
8
9
10
11
12

# 页面通信

发送事件

		setTimeout(()=>{
             // 页面通信
			uni.$emit("editEvent")
			uni.navigateBack();			
		},1000)
1
2
3
4
5

接收事件

uni.$on("editEvent",()=>{
    // 刷新列表数据
	getData();
})
1
2
3
4

# uni-admin 框架

官方文档：https://doc.dcloud.net.cn/uniCloud/admin.html (opens new window)

# 发行部署相关

# 微信小程序部署

1、内部使用到的接口，域名需要配置

  • 微信公众平台，开发管理界面
  • 配置域名

2、在 HBuilder X 中 配置好 appid 和 微信开发者工具包路径 然后 发行打包

3、微信开发者工具进行版本上传

# Web 部署

路由模式选择

  • hash：无后端支撑时选择
  • history：有后端支撑时选择

核心区别：

特性 hash 模式 history 模式
URL 结构 https://example.com/#/about https://example.com/about
实现原理 依赖浏览器的 location.hash（# 后的部分不会被发送到服务器） 使用 HTML5 的 History API（pushState / replaceState）
刷新行为 刷新时不会请求后端，直接由前端路由解析 刷新时会请求服务器对应路径，若未配置则会 404
SEO 友好度 差（搜索引擎识别 # 有限制） 好（URL 更干净，更利于 SEO）
部署难度 低，几乎不需要服务器额外配置 高，需要服务器配置将所有路由都重定向到 index.html
兼容性 老旧浏览器也支持 需要支持 HTML5 History API 的浏览器

使用上的区别：

hash 模式

  • 优点：
    • 不依赖后端配置，随便放到任何服务器/OSS/CDN 都能跑
    • 刷新、直接访问子路由不会 404
  • 缺点：
    • URL 有 #，不美观
    • 对 SEO 不友好（搜索引擎可能不收录或权重低）

history 模式

  • 优点：
    • URL 更干净，类似后端路由
    • 更利于 SEO
  • 缺点：
    • 刷新或直接访问非根路径 /about 时，服务器会去找 /about 这个物理文件，如果没找到就 404
    • 需要在 Nginx/Apache/宝塔 做 URL 重写，把所有前端路由都指向 index.html

运行的基础路径

  • 如果设置了 运行的基础路径（/cm-gallery）
    • 打包之后的文件夹也需要更改成对应的名称
    • pages.json 文件如果有用到 static 目录下的图片，也需要改成绝对路径（/cm-gallery/static/...），相对路径可能会加载不了图片
  • 然后再上传到云服务空间
  • 【跨境配置】需要加上域名
上次更新: 2025/8/13 18:51:18
知识梳理
若依学习笔记

← 若依学习笔记→

Theme by Vdoing | Copyright © 2023-2025 沉梦听雨 | MIT License