在麒麟OS V10 SP1/V11中安装pnpm需根据网络与权限环境选择npm全局安装、官方脚本或离线部署方式，并须配置store-dir等路径至/home防根分区写满，再修复对应目录权限。
如果您在国产麒麟操作系统（KylinOS）V10 SP1 或 V11 桌面/服务器版中尝试安装 pnpm，但遇到 Node.js 版本不匹配、全局目录权限拒绝、镜像源超时或 pnpm 命令未识别等问题，则很可能是由于系统默认未预装 pnpm、网络策略限制或路径配置不符合麒麟环境规范所致。以下是针对麒麟OS平台的多路径安装与进阶配置方案：
一、通过 npm 全局安装（兼容性最广）
该方法适用于已成功安装 Node.js 22.x 且 npm 可正常联网访问国内镜像源的场景，利用 npm 作为引导器安装 pnpm，规避麒麟系统对直接二进制下载的策略拦截。
1、确认 Node.js 与 npm 已就绪：
执行 node -v 与 npm -v，输出应分别为 v22.x.x 与 10.x.x 或更高版本。
2、切换 npm 镜像源至国内可信节点：
执行 npm config set registry https://registry.npmmirror.com/。
3、以 root 权限全局安装 pnpm：
执行 sudo npm install -g pnpm。
4、验证安装结果：
执行 pnpm -v，若返回有效版本号（如 9.14.0+），则安装成功。
二、使用 NodeSource + pnpm 官方脚本安装（推荐 x86_64 架构）
此方式绕过 npm 依赖链，直接通过 curl 获取 pnpm 安装脚本并执行，适配麒麟 V10 SP1 的 Debian/Ubuntu 系源体系，避免因 npm 本身存在缓存污染导致的安装失败。
1、确保 curl 工具已安装：
执行 sudo apt install -y curl。
2、下载并执行 pnpm 安装脚本：
执行 curl -fsSL https://get.pnpm.io/install.sh | sh -。
3、将 pnpm 二进制路径加入用户环境变量：
执行 echo 'export PATH="$HOME/.local/share/pnpm:$PATH"' >> ~/.bashrc && source ~/.bashrc。
4、验证命令可用性：
新开终端后执行 pnpm -v。
三、离线部署方式（适用于无外网或强管控环境）
当麒麟系统处于完全断网、或仅能访问内网 Nexus/私有仓库时，需预先在可联网机器下载 pnpm 二进制包，并手动部署至目标麒麟主机的指定路径，确保权限与符号链接正确。
1、在联网环境下载对应架构二进制：
访问 https://github.com/pnpm/pnpm/releases，下载 pnpm-linux-x64.tar.gz（x86_64）或 pnpm-linux-arm64.tar.gz（鲲鹏）。
2、解压并复制至系统级 bin 目录：
执行 sudo tar -xzf pnpm-linux-x64.tar.gz -C /usr/local/bin。
3、赋予可执行权限：
执行 sudo chmod +x /usr/local/bin/pnpm。
4、验证是否纳入 PATH：
执行 which pnpm，应返回 /usr/local/bin/pnpm。
四、进阶配置：定制 Store 与全局路径（防 C 盘爆满）
麒麟桌面版默认挂载点为 /home，而系统盘（/）空间有限；pnpm 默认 store-dir 位于 ~/.pnpm-store，易造成根分区写满。必须显式重定向 store、global-dir、cache-dir 至大容量分区（如 /home 或 /data）。
1、创建目标目录结构：
执行 mkdir -p /home/user/pnpm/{store,global,cache,state,bin}（请将 user 替换为实际用户名）。
2、逐项设置 pnpm 配置项：
执行 pnpm config set store-dir /home/user/pnpm/store。
3、执行 pnpm config set global-dir /home/user/pnpm/global。
4、执行 pnpm config set global-bin-dir /home/user/pnpm/bin。
5、执行 pnpm config set cache-dir /home/user/pnpm/cache。
6、执行 pnpm config set state-dir /home/user/pnpm/state。
7、验证全部配置生效：
执行 pnpm config list，检查各路径是否指向新位置。
五、权限修复：解决“EACCES: permission denied”错误
麒麟OS默认启用严格的文件权限控制，当 pnpm 尝试写入全局目录或 store 时，若当前用户未被授予对应目录的写权限，会触发 EACCES 错误。必须显式授权而非使用 sudo 执行 pnpm 命令。
1、定位当前 pnpm store 路径：
执行 pnpm config get store-dir。
2、递归修改该路径所有权：
执行 sudo chown -R $USER:$USER /home/user/pnpm/store（路径需与上步一致）。
3、同步修复 global-dir 权限：
执行 sudo chown -R $USER:$USER /home/user/pnpm/global。
4、将 pnpm_bin 目录加入用户 PATH：
执行 echo 'export PATH="/home/user/pnpm/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。
