Linux 系统下 Node.js 与 Codex 安装排错指南

遇到的问题 2 (Git 克隆失败): 虽然安装脚本下载成功了，但在执行过程中再次报错。

error: RPC failed; curl 16 Error in the HTTP2 framing layer
fatal: expected flush after ref listing
Failed to clone nvm repo. Please report this!

分析： 这说明网络环境虽然可以完成短暂的脚本下载，但无法支持 git clone 这种需要持续稳定连接的操作。

解决方案 1 (使用国内镜像源): 改用 Gitee 上的镜像源进行安装。

curl -fsSL https://gitee.com/mirrors/nvm-sh/raw/master/install.sh | bash

遇到的问题 1 (连接失败):

curl: (7) Couldn't connect to server

分析： 这是典型的网络问题，由于众所周知的原因，从国内直接连接 GitHub 的服务器 (raw.githubusercontent.com) 可能会失败。

常规操作 (尝试从 GitHub 安装):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

阶段三：使用 NVM 安装 Node.js 失败

1. 问题分析： nvm 在安装 Node.js 之前，需要先连接到 Node.js 的官方服务器 (nodejs.org) 获取可用的版本列表。由于网络问题，这一步也失败了，导致 nvm 认为没有任何版本可供安装。

解决方案： 为 nvm 配置国内的 Node.js 镜像源（如淘宝镜像）。

# 1. 设置镜像源，并将其永久写入配置文件，一劳永逸
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node && echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc

# 2. 重新加载配置 (或者重启终端)
source ~/.bashrc

遇到的问题：

Version '22' not found - try `nvm ls-remote` to browse available versions.

常规操作：

nvm install 22 # 或者其他版本

阶段四：成功安装 Node.js 和 Codex

在解决了所有底层环境和网络问题后，最后的安装就水到渠成了。

最终，安装 Codex (使用 nvm 后，全局安装不再需要 sudo):

npm install -g @openai/codex

此时，安装过程将顺利完成。

验证 Node.js 版本：

node -v # 应输出 v20.x.x 或更高版本

使用配置好镜像的 nvm 安装 Node.js (推荐安装 LTS 长期支持版):

nvm install --lts

核心命令总结 (Cheat Sheet)

下次在新环境配置时，可以直接参考以下核心命令：

安装目标包:

npm install -g @openai/codex

安装 Node.js 并设为默认:

nvm install --lts
nvm use --lts
nvm alias default 'lts/*'

为 NVM 配置国内镜像源:

echo 'export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node' >> ~/.bashrc
source ~/.bashrc

手动安装 NVM (最稳妥):

rm -rf ~/.nvm
mkdir -p ~/.nvm && curl -L https://gitee.com/mirrors/nvm-sh/repository/archive/v0.39.7.tar.gz | tar -xz -C ~/.nvm --strip-components=1
cat <<'EOF' >> ~/.bashrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"
EOF
source ~/.bashrc