全新电脑从零安装飞书CLI(完整教程+新手防坑指南)

本文是基于全新电脑（Windows系统）从零安装飞书CLI（lark-cli）的完整实操历程，包含每一步详细操作、遇到的所有报错及对应解决方案，同时整理新手高频踩坑点，确保零基础也能顺利安装、正常使用，全程可复制、可落地。

一、前置说明

适用场景：全新电脑（未安装过Node.js、飞书CLI），Windows系统（PowerShell/CMD），国内网络（优先使用国内镜像，避免下载超时）。

核心前提：飞书CLI依赖Node.js（自带npm），必须先安装Node.js，再安装飞书CLI，步骤不可颠倒。

二、完整安装步骤（按顺序执行，一步都不能少）

Step 1：打开系统终端（基础准备）

所有命令均在终端中执行，打开方式：

•按 Win+R → 输入 powershell→ 回车（推荐，后续操作更顺畅）；

•也可使用CMD，但优先选择PowerShell。

注意：终端界面若显示>符号，说明进入了Node.js交互模式（进错地方），需先退出（后续防坑指南有详细说明）。

Step 2：安装Node.js（必装依赖）

1.检查是否已安装（全新电脑可跳过，但建议确认）：在终端输入命令，回车执行：node -vnpm -v若输出版本号（如node v20.x.x、npm 11.x.x），说明已安装，直接跳至Step 3；若提示“不是内部或外部命令”，则继续安装。

2.下载并安装Node.js：

￮浏览器打开官网：https://nodejs.org/

￮下载「LTS版本」（长期支持版，稳定，适合新手）；

￮双击安装包，一路默认下一步（会自动安装npm，无需额外操作）。

3.关键一步：重启终端安装完成后，关闭当前所有终端，重新打开一个新的PowerShell（否则环境变量不生效，后续会报错），再次执行 node -v和npm -v，能看到版本号即安装成功。

Step 3：全局安装飞书CLI（国内镜像，避免超时）

在新打开的终端中，复制以下命令，回车执行（国内网络专用，速度更快）：

执行后，若出现added X packages in Xs（如added 7 packages in 8s），说明飞书CLI安装成功。

Step 4：更新npm（可选，若有版本提示）

安装飞书CLI后，若终端提示“New minor version of npm available”（如11.12.1 → 11.14.0），可选择更新npm（不更新不影响飞书CLI使用，更新后更稳定）：

1.复制更新命令，回车执行：npm install -g npm@11.14.0也可使用通用更新命令：npm install -g npm

2.验证更新：执行npm -v，若输出目标版本号（如11.14.0），则更新成功。

提示：若出现“15 packages are looking for funding”，属于npm赞助提示，无需理会，不影响使用。

Step 5：验证飞书CLI安装（关键一步）

在终端输入以下命令，回车执行：

若输出版本号（如1.0.24），说明飞书CLI已成功安装，且环境配置正常。

Step 6：飞书CLI初始化配置（必做，否则无法登录）

直接登录会报错“not configured”，需先执行初始化配置，分配飞书应用身份：

1.复制以下命令，回车执行：lark-cli config init --new

2.执行后，终端会输出一个验证URL（链接），复制该链接并在浏览器中打开；

3.用飞书App扫码/登录浏览器页面，完成自动配置，终端会提示“初始化成功”。

Step 7：飞书CLI登录授权（最终一步）

1.初始化成功后，回到终端，执行登录命令：lark-cli auth login

2.终端会输出授权链接，打开链接后用飞书App扫码，点击“授权”；

3.验证登录：执行以下命令，若能显示你的飞书姓名、企业信息，说明登录成功：lark-cli auth status

Step 8：测试飞书CLI可用（可选，确认功能正常）

执行以下常用命令，测试功能（任选其一即可）：

•查看今日日程：lark-cli agenda today

•查看未读消息：lark-cli message unread

•发送消息：lark-cli message send

三、新手高频踩坑指南（全程实测，精准避坑）

以下是安装过程中遇到的所有报错、原因及解决方案，按报错场景分类，直接对应查找即可解决。

坑1：执行npm安装命令，提示“npm should be run outside of the Node.js REPL”

•报错原因：进入了Node.js交互模式（终端显示>符号），该模式只能运行JS代码，不能执行npm命令。

•解决方案（3秒搞定）：

a.在当前终端按Ctrl + D，或输入.exit回车，退出Node交互模式；

b.重新打开一个新的PowerShell，再执行npm安装命令即可。

•避坑提醒：不要随意输入node命令（输入后会进入交互模式），安装过程中只复制教程中的命令执行。

坑2：执行npm命令，提示“无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本”

•报错原因：Windows系统安全策略默认禁止PowerShell运行.ps1脚本，npm属于.ps1脚本，被系统拦截。

•解决方案（无需右键，3种方法任选）：方法1：搜索打开管理员PowerShell（最稳）方法2：Win+R一键打开（最快）方法3：任务管理器兜底（万能）打开管理员PowerShell后，执行以下命令，输入 Y回车确认：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser执行完成后，关闭所有终端，重新打开普通PowerShell，再执行npm命令即可。

a.点击左下角Windows开始菜单，输入 PowerShell；

b.搜索结果右侧，点击“以管理员身份运行”；

c.弹出UAC提示，点击“是”（标题栏会显示“管理员：”）。

a.按 Win+R，复制命令 powershell Start-Process powershell -Verb RunAs，粘贴后回车；

b.弹出UAC提示，点击“是”，直接打开管理员PowerShell。

a.按 Ctrl+Shift+Esc，打开任务管理器；

b.左上角“文件”→“运行新任务”，输入 powershell；

c.勾选“以系统管理员权限创建此任务”，点击“确定”。

坑3：执行lark-cli auth login，报错“not configured”，无二维码/链接

•报错原因：未执行飞书CLI初始化配置，CLI没有分配飞书应用身份，无法发起登录。

•解决方案：

a.先执行初始化命令：lark-cli config init --new；

b.复制终端输出的URL，在浏览器打开，飞书扫码完成配置；

c.配置成功后，再执行lark-cli auth login，即可出现授权链接/二维码。

•避坑提醒：初始化步骤不可跳过，否则无法登录，即使执行auth status也会报错。

坑4：lark-cli auth status显示正常（有姓名），但执行lark-cli user me报错

•报错原因：lark-cli user me是飞书CLI旧版本命令，新版已废弃，并非权限问题。

•解决方案：

a.放弃执行lark-cli user me，无需去飞书开放平台加权限；

b.用lark-cli auth status验证登录即可（显示姓名即登录成功）；

c.测试功能用新版可用命令（如agenda today、message unread）。

•避坑提醒：不要轻信旧版教程中的废弃命令，以本文中的可用命令为准。

坑5：npm更新/安装时，提示“权限不足（Permission denied）”

•报错原因：当前终端没有管理员权限，无法修改系统目录下的文件。

•解决方案：用“管理员身份”打开PowerShell，再执行对应的npm命令（参考坑2的管理员打开方法）。

坑6：安装飞书CLI后，执行lark-cli --version提示“不是内部或外部命令”

•报错原因：安装成功但环境变量未生效，终端无法识别lark-cli命令。

•解决方案：关闭所有终端，重新打开一个新的PowerShell，若仍不行，注销电脑后重新登录即可。

四、最终总结

全新电脑安装飞书CLI，核心流程：打开终端 → 安装Node.js（重启终端） → 安装飞书CLI（国内镜像） → 初始化配置 → 登录授权 → 验证可用，全程按步骤执行，避开上述6个坑，即可100%安装成功。

关键验证标准：执行lark-cli --version出版本号，执行lark-cli auth status显示姓名，即代表所有配置正常，可直接使用飞书CLI的各项功能。

|（注：文档部分内容可能由 AI 生成）