一键切换飞书账号lark-cli 多 Profile多账号管理实战指南【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址: https://gitcode.com/gh_mirrors/cli414/cli如果你需要同时使用飞书个人号和企业号、或多个测试环境账号lark-cli 的多 Profile多账号管理功能可以让切换账号变成一条命令的事。本文带你快速掌握 lark-cli profile 的 5 个核心命令与临时切换技巧实现飞书账号一键切换告别反复登录的烦恼。 什么是 Profile为什么需要多账号管理Profile 是 lark-cli 中一个独立配置的账号单元每个 Profile 绑定一个独立的 App ID 与凭据并各自维护自己的登录态。想象一下这样的场景工作场景白天用公司飞书账号收发消息、管理日程开发场景联调阶段需要切换到测试环境账号自动化场景CI 脚本中按环境注入不同账号。没有多账号支持时切换账号意味着重新登录、重新配置而 lark-cli 的多 Profile 机制把每个账号隔离成独立配置一条命令即可在账号之间来回切换且互不干扰。 每个 Profile 的 App Secret 都会安全存入系统钥匙串keychain不会明文散落在配置文件中。相关实现位于 cmd/profile/ 目录配置结构定义在 internal/core/config.go。 准备工作如果你还没安装 lark-cli可以从镜像仓库获取源码git clone https://gitcode.com/gh_mirrors/cli414/cli并确保已通过lark-cli config init完成过至少一次基础配置之后即可开始管理多个 Profile。⚡ 5 个核心命令多账号管理全掌握1️⃣ 添加账号lark-cli profile add添加一个全新 Profile核心参数是--name账号名和--app-id应用 ID。App Secret 通过标准输入传入避免出现在命令行历史中echo 你的AppSecret | lark-cli profile add \ --name mywork \ --app-id cli_xxx \ --app-secret-stdin \ --use几个值得注意的细节详见 cmd/profile/add.go--use添加后立即切换到新账号省去一次use操作--brand feishu|lark区分飞书默认与国际版 Lark 品牌--lang zh可单独为某个账号指定语言偏好同名 Profile 或相同 App ID 会被拒绝——每个 Profile 必须拥有唯一的 App ID这是凭据隔离的关键。2️⃣ 查看账号列表lark-cli profile list随时想知道我现在有哪些账号、当前在哪个账号上执行lark-cli profile list输出以 JSON 呈现每个 Profile 的名称、App ID、品牌以及两个关键标记active持久化的默认账号即不传任何参数时生效的那个effective本次调用实际生效的账号——如果用了--profile参数或环境变量它可能和active不同。这种默认值 vs 实际值的设计帮你一眼发现我是不是被环境变量顶掉了这类隐蔽问题实现见 cmd/profile/list.go。3️⃣ 一键切换lark-cli profile use这是整个多账号体系的灵魂命令lark-cli profile use mywork切换到目标 Profile 后后续所有命令都自动使用该账号的凭据。更妙的是回切快捷键lark-cli profile use --表示切回上一次的账号。在个人号和公司号之间频繁往返时use -就像浏览器前进后退键一样顺手。⚠️ 如果切换后看到类似LARKSUITE_CLI_PROFILExxx is set的警告说明当前 shell 设置了环境变量本次use只对持久化配置生效本 shell 内命令仍走环境变量指定的账号——解决方法见下文。切换逻辑与回切机制的完整实现见 cmd/profile/use.go。4️⃣ 重命名lark-cli profile rename账号名起得不好直接改lark-cli profile rename mywork work-account重命名会自动同步更新当前账号和上一个账号的引用不会出现切换记录指向旧名字的尴尬。注意新名字不能与其他 Profile 的名字或 App ID 冲突见 cmd/profile/rename.go。5️⃣ 删除lark-cli profile remove账号不再需要时清理掉lark-cli profile remove work-account删除会连带清除该账号的全部凭据与登录令牌属于破坏性操作请确认后再执行。另外有一个保护机制最后一个 Profile 不允许删除必须至少保留一个账号见 cmd/profile/remove.go。 临时切换不改默认账号也能用别的身份profile use是持久切换而很多场景只需要这一次用别的账号不想动默认配置。lark-cli 提供两种方式方式示例作用范围--profile参数lark-cli im send --profile session仅当前这一次命令环境变量export LARKSUITE_CLI_PROFILEsession当前 shell 会话内所有命令环境变量对脚本和 CI 特别友好——在流水线里按环境注入不同账号无需修改任何持久化配置export LARKSUITE_CLI_PROFILEci-bot lark-cli config show # 本 shell 内都以 ci-bot 身份执行 unset LARKSUITE_CLI_PROFILE 三种方式谁说了算记住优先级当你同时使用了多种指定方式时lark-cli 按以下优先级解析高 → 低--profile参数单次命令生效LARKSUITE_CLI_PROFILE环境变量当前 shell 生效持久化默认账号profile use设置的CurrentApp这意味着 CI 里设了环境变量也不影响你本地终端的默认账号临时脚本用了--profile也不会污染全局配置——各层互不干扰是这套设计最值得称道的地方。优先级验证用例可参考 cmd/profile_env_integration_test.go环境变量定义见 internal/envvars/envvars.go。✅ 最佳实践清单命名即说明用personal/company/ci-bot这类一看就懂的名字配合profile list随时核对添加即切换新账号加--use一步到位临时优先参数单次操作用--profile会话级用环境变量长期切换才用use删除先备份remove不可逆重要账号换名字用rename更安全AI 协作注意lark-cli 内置了对 AI Agent 的提示——除非用户明确要求Agent 不应擅自切换或删除 Profile把账号控制权留在你手里。 小结lark-cli 的多 Profile 机制把飞书多账号切换从繁琐的重新登录简化为add/list/use/rename/remove五个直观命令再叠加--profile参数与环境变量两层临时覆盖覆盖了从日常开发到 CI 自动化的全部场景。掌握它们多账号工作流从此一键搞定。【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址: https://gitcode.com/gh_mirrors/cli414/cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考