Node.js 简介#

• Node.js：一个跑在服务端的 JavaScript 运行环境（Chrome V8 引擎做底子）
• npm：Node 的包管理器，用来装各种依赖（理解成 Node 的“应用商店”就行）

中文官网 👉 https://nodejs.org/zh-cn

安装 Node.js & npm#

两种方式：

1
sudo apt-get update
2
sudo apt-get install nodejs npm -y

1
wget https://nodejs.org/dist/v18.12.1/node-v18.12.1-linux-x64.tar.xz
2
tar xvf node-v18.12.1-linux-x64.tar.xz
3
sudo mkdir -p /usr/local/node
4
sudo mv node-v18.12.1-linux-x64/* /usr/local/node
5

6
# 建立软链接
7
sudo ln -s /usr/local/node/bin/node /usr/bin/node
8
sudo ln -s /usr/local/node/bin/npm /usr/bin/npm

1
node -v
2
npm -v

Node.js 更新神器：n#

apt 装的 Node.js 可能不是最新的，推荐用 n 来升级（注意：n 不支持 Windows）。

安装：

1
sudo npm install -g n
2
sudo ln -s /usr/local/node/bin/n /usr/bin/n
3
n -V

常用操作：

1
sudo n latest    # 最新版
2
sudo n stable    # 稳定版
3
sudo n lts       # LTS 版本
4
sudo n 18.12.1   # 指定版本

确认更新：

1
node -v

（我这边更新后是 v24.3.0）

登录方式#

首次运行必须登录，三种方式：

• Google 账号登录（推荐）
• Gemini API Key
• Vertex AI

⚠️ 大坑提醒：

• 一定要在 有桌面环境的终端 运行 gemini，否则登录会无限失败。
• 如果你用 SSH 登录，只会收到一个迷惑提示： Authentication timed out. Please try again. + 一个 TOS 链接。

Workspace 账号问题#

如果你绑定了 Google Cloud，可能会被误判成 Workspace 账号，报错： Login Failed: Ensure your Google account is not a Workspace account

解决方案：

1. 换个没绑 Google Cloud 的账号

2. 或者设置环境变量：

   1
   export GOOGLE_CLOUD_PROJECT="你的项目编号"
   

   （写到 ~/.bashrc 或 ~/.zshrc 里永久生效）

1. / 命令 —— 控制 & 会话管理#

• /help 或 /?：显示帮助
• /chat save：保存对话历史
• /chat resume：恢复某个历史对话
• /compress：压缩上下文（省 Token 的神器）
• /memory show / /memory refresh：管理记忆
• /stats：查看会话统计
• /clear：清屏
• /quit：退出

2. @ 命令 —— 注入文件 & 目录#

• @README.md → 把指定文件注入 Prompt
• @src/ → 注入整个目录（会自动忽略 .gitignore 里的文件）

3. ! 命令 —— Shell 交互#

• !ls -la → 在 CLI 里直接跑 Shell
• 单独输一个 ! → 进入 Shell 模式（再次输入 ! 退出）

快捷键：

• Shift+Enter → 换行
• Ctrl+L → 清屏
• Alt+←/→ → 光标跳单词
• Ctrl+C → 强制退出