2025年飞书小程序开发经验

大家好，我是讯享网，很高兴认识大家。

飞书小程序开发经验总结

前序

最近一段时间，由于工作需要，我先在微信小程序开发平台上开发了一套程序，但是由于微信小程序不能保证整体的数据流都封闭在内网里，因而决定转战飞书小程序，将整体的功能都迁移至飞书小程序里。但是飞书小程序的开源博客比较少，所以在最开始上手的过程中还是比较痛苦的，现在小程序整体开发已经接近尾声，特此总结一下最近开发飞书小程序积累下的经验与流程。

开放文档与平台

飞书小程序提供了很多原生的API与服务端支持功能，都可以极大的丰富小程序的能力，因此多参考文档，对于程序的设计与开发都会有很大的帮助（主要还是因为飞书小程序的开源社区不太丰富，很多功能没有什么博客介绍用法）

飞书小程序开发文档：
https://open.feishu.cn/document/uYjL24iN/uUDNzUjL1QzM14SN0MTN
飞书开发者工具：

windows-64-bit
MacOS

微信小程序 vs 飞书小程序

微信小程序在很多的场景下与飞书小程序的语法格式都是一致的，如果遇到不确定的语法，可以直接参考微信小程序的语法，如果实在不行再去看飞书开发者文档。

一键迁移微信小程序

小程序迁移
讯享网
打开飞书开发者工具，可见右上角部分存在按钮搬家工具，点击搬家工具即可将微信小程序直接迁移至飞书小程序中，该工具可以自动将大部分的微信小程序语法替换为飞书小程序语法，但是不能保证转换结果 绝对正确 ，还是有可能会存在一些语法不正确的情况存在，此时还是需要我们自行调试程序，保证程序的可用性。
更多详细的搬家工具使用方式还请参考：
搬家工具介绍文档

搬家工具使用后遗症

使用完搬家工具后不意味着可以立即进入开发调试阶段，此时我们还需要面对另外一个问题——微信小程序与飞书小程序技术支持的差异。
首先，我们需要注意修改project.config.json文件中的appid，我们迁移程序后，appid并不会直接帮我们改好。
// 开发者后台中创建应用后即可看到appid ：开发者后台链接
之后，如果我们曾经在微信小程序中使用了云函数与云数据库的话，那么我们可能就会遇到麻烦了，因为飞书小程序更加的轻量化，其并不支持云函数与云数据库。此时对于数据的存储我们可以寻求另一个解决方案——多维表格。关于多维表格的使用，我会在下面介绍。

页面展示与page的坑

一个一个的页面（page）组成了小程序的基本结构，如果要配置小程序打开的默认界面，可以有两个选择：

在app.json中增加entryPagePath字段，该字段的值对应的页面将会被配置为入口页面。
“entryPagePath”: “pages/index/index”
app.json 中不配置entryPagePath字段，则默认为 pages 列表的第一项。

{ 
    "pages":[ "pages/index/index" ] }

讯享网

在pages文件夹内，一般我们会存放每个页面的文件夹
结构一般如下
├── pages
│ │── home
│ │ ├── home.ttml
│ │ ├── home.js
│ │ ├── home.json
│ │ └── home.ttss
│ └── user
│ ├── user.ttml
│ └── user.js
值得一提的是，所有的js文件中，不管会不会用到data对象，我们都需要对data对象进行声明，否则会一直打印报错

讯享网Page({ 
    data:{ 
    }, });

另外，所有的json文件也都需要进行初始化，即便没有任何数据，也需要写入一对正反大括号。

获取用户信息 getUserInfo

与微信小程序不同，飞书小程序在获取用户信息时，在调用getUserInfo之前，还需要先调用login方法。

getUserProfile() { 
    // 用户登录 tt.login({ 
    // 成功回调 success(res) { 
    console.log(JSON.stringify(res)); // 获取用户信息 tt.getUserInfo({ 
    // 要求敏感信息 withCredentials: true, success: function(res) { 
    console.log(JSON.stringify(res)); tt.setStorageSync('user', res); app.globalData.userName = res.userInfo.nickName; }, fail: function(res) { 
    console.log(`getUserInfo fail: ${ 
     JSON.stringify(res)}`); } }); }, fail(res) { 
    console.log(`login fail: ${ 
     JSON.stringify(res)}`); } }) },

关于跳转页面栈的问题

在我们的小程序在不同的page之间进行跳转时，我们可能会更习惯使用navigateTo这个方法，但是每一次使用navigateTo方法时，都会将当前页面压入栈中，随后再执行跳转操作，每次左划屏幕边缘回退页面时，都会从页面栈中弹出页面。
例如说，我们存在两个page：pageA，pageB，我们在pageA.js文件中调用

讯享网tt.navigateTo({url: '../pageB/pageB'});

此时程序会先将pageA压入栈（stack）中，随后再从页面A跳转至页面B；注意，如果这里讲的是，必须要先将页面压入栈成功后，才会执行跳转操作，如果页面压入失败了，那么是不会执行后边的跳转操作的。如果此时用户在页面B左划屏幕，则会将栈顶的pageA弹出，并跳转至页面A上。
但是值得注意的时，页面栈的最大值为10，当页面栈的大小达到10之后，再次调用navigateTo操作将会不再起作用，页面栈不会更改，页面也不会跳转。
因而我们可以配合redirectTo来进行使用：

tt.navigateTo({ 
    "url": "../shotPhoto/shotPhoto", success(res) { 
    console.log(JSON.stringify(res)); }, // 失败回调 fail(res) { 
    console.log(`navigateTo fail: ${ 
     JSON.stringify(res)}`); tt.redirectTo({ 
    "url": "../shotPhoto/shotPhoto", success(res) { 
    console.log(JSON.stringify(res)); }, fail(res) { 
    console.log(`rediractTo fail: ${ 
     JSON.stringify(res)}`); } }) } });

但，依然要注意的一点是，redirectTo只能跳转到非tabBar界面，如果要跳转至tabBar界面，还请使用switchTab方法。

更多关于navigateTo，请参考 navigateTo
更多关于redirectTo，请参考 redirectTo
更多关于switchTab，请参考 switchTab

鉴权的获取

在飞书小程序的开发中，有时我们在尝试使用其服务端的一些功能时，可能需要我们的鉴权即tenant_access_token，此时我们可以通过小程序调用post请求来获取相关的数据。
值得关注的是，鉴权信息2小时过期，过期后重新申请即可。

讯享网tt.request({ 
    url: 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal', method: "post", data: { 
    app_id: "appid", app_secret: "secret" }, header: { 
    'Content-Type': "application/json; charset=utf-8" }, success: function(res) { 
    console.log("try to get accessToken success:" + res); accessToken = res; tt.setStorageSync("accessToken", res); tt.setStorageSync("accessTime", new Date().getTime()); }, fail: function(res) { 
    console.log("try to get accessToken failed:" + res); } })

多维表格？简配数据库！

多维表格文档多维表格

多维表格可以被视为一个简配的关系型数据库，在飞书小程序不支持数据库的前提下，可以作为数据库的一个替代选项。

在对多维表格进行增加操作时，我们需要先自行创建一个多维表格，并获取到其app_token以及table_id，
如我们多维表格的url为
https://abc.feishu.cn/base/abcedfg？table=higklm&view=vewAVZdmul
此时，abcdefg即为app_token,table_id即为higklm。
同时，我们还需要获取鉴权。获取鉴权的方式如上介绍。
此处我们仅展示新增数据：

tt.request({ 
    url:'https://open.feishu.cn/open-apis/bitable/v1/apps/apptokenapptoken/tables/tableidtableid/records', method: "post", header: { 
    'Content-Type': 'application/json', 'Authorization': 'Bearer ' + accessTokenString }, data: { 
    'fields': { 
    "人力耗时": 64, "人力评估": "8", } }, success: function(res) { 
    console.log("上传数据成功"+ res); }, fail: function(res) { 
    console.log("上传数据失败" + res); } })

持续更新。。。

初学小白，在线挨打，如果有什么纰漏之处，还请大佬们多多指正。