本文是基于全新电脑（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 生成）

# 软件教程  # 全新电脑从零安装飞书CLI(完整教程+新手防坑指南)  # 报错  # 国内  # 镜像  # 也可  # 弹出  # 可选  # 重启  # 任务管理器  # 在此  # 也会  # 过程中  # 跳过  # 也能  # 右键  # 并在  # 详细说明  # 更快  # 双击  # 正常使用  # 种方法 

相关栏目： 【 设计资讯7769 】 【 行业资讯35393 】

相关文章： 平面广告设计的方式  平面广告设计前途好  平面广告设计软件测试需要  小型平面广告设计工作室  个性青年平面广告设计  万代平面广告设计  慕阑珊平面广告设计  平面广告设计师笔试  水墨元素平面广告设计  防晒霜平面广告设计  平面广告设计师岗位  简述平面广告设计的任务  现代主义平面广告设计  包装平面广告设计价位  八宝粥平面广告设计  品牌平面广告设计推荐  平面广告设计关于动画  平面广告设计更高级的说法  平面广告设计系列推荐电脑  大宝平面广告设计  平面广告设计费报价单  平面广告设计师谈单话术  三本院校平面广告设计  幼儿园品牌平面广告设计  汽车类平面广告设计技巧  鹰目网平面广告设计与制作  间接平面广告设计：用创意点亮世界  产品简约平面广告设计  房地产鬼城平面广告设计  平面广告设计月平均工资  平面广告设计创作总结  香港豪宅平面广告设计  果汁平面广告设计制作方法  关于平面广告设计的期刊  平面广告设计城市  融合插平面广告设计  平面广告设计信息设计  航拍平面广告设计  平面广告设计功底分析论文  **炸萝卜丸子的平面广告设计**  平面广告设计名人  平面广告设计工作利与弊  路标平面广告设计尺寸  幼儿平面广告设计  炒饭平面广告设计  平面广告设计简单画 - 驾驭简洁  品牌或产品进行平面广告设计  创意平面广告设计动物画  平面广告设计主要工作  周大福品牌平面广告设计