[x-cmd] 安装指南
安装指南
本指南概述如何在各种 Shell 环境和操作系统中安装、更新和卸载 x-cmd。
x-cmd 是一个采用 Posix Shell 兼容语法开发的命令行库/工具箱, 以灵活轻便为首要设计目标。为最大限度地减少对系统的影响，x-cmd 核心运行仅依赖系统预装命令，并仅在用户目录下活动，因此安装和绝大部分使用场景并不需要 root 权限.
不同系统和 Shell 之间存在差异。感谢用户的反馈与支持, x-cmd 已针对这些差异提供相应的解决方案。本文档将总结这些方案，并提供相关文档链接。
安装成功后, 欢迎阅读我们的 入门指南 ~ 该指南将引导您快速掌握 x-cmd 的核心功能，包括自动补全、主题定制、模块管理和包管理，助您快速上手。
使用 Posix Shell 安装脚本
最便捷的安装方式是使用 x-cmd 官方提供的安装脚本，该脚本托管在 https://get.x-cmd.com。
该脚本采用 Posix Shell 兼容语法编写, 用户可以采用 curl 或 wget 下载, 并直接在 bash、zsh、dash、ash 下运行。
- 使用
curl命令安装
eval "$(curl https://get.x-cmd.com)"
- 使用
wget命令安装
eval "$(wget -O- https://get.x-cmd.com)"
在 Fish, Elvish, Elvish, xonsh, tcsh 下安装 x-cmd
由于安装脚本使用 POSIX shell 语法编写，在非 POSIX shell 环境（如 fish、elvish、nushell、xonsh、tcsh）无法直接运行，因此请使用以下命令：
curl https://get.x-cmd.com | sh
或者
wget -O- https://get.x-cmd.com | sh
安装后, 为了能在 Shell 启动时自动加载 x-cmd, 我们提供了形如 x <shell-name> --setup 的快速配置命令。
以 fish 为例：
~/.x-cmd.root/bin/x fish --setup
我们特意为以下 Shell 的用户准备了专题文档, 以进一步改善上手体验：
- fish
- elvish
- nushell
- xonsh
- tcsh
在 Windows 及 Powershell 上安装 x-cmd
我们提供 x-cmd.bat 批处理脚本下载, 用户只需双击打开, 即能触发安装.
同时, x-cmd 还提供一份采用 Powershell 编写的安装脚本, 用户可以在 powershell 下调用如下命令即能下载该脚本并触发安装.
[System.Text.Encoding]::GetEncoding("utf-8").GetString($(Invoke-WebRequest -Uri "https://get.x-cmd.com/x-cmd.ps1").RawContentStream.ToArray()) | Invoke-Expression
请移步到 windows 安装, 该文档提供了 windows 系统下详细的入门介绍、注意事项和原理说明.
powershell 的用户也可以直接访问 powershell 专题文档
采用系统包管理安装
Homebrew
- 运行命令进行安装
brew install x-cmd
- 安装成功后，需要运行命令在当前用户环境下激活
x-cmd
- 运行命令进行安装
sudo yay -S x-cmd
# or
sudo paru -S x-cmd
- 安装成功后，需要运行命令在当前用户环境下激活
x-cmd
apt
等待社区审核中
相关跟进：Debian、Kali
apk
等待社区审核中
相关跟进：Alpine MR #80866
pacman
等待社区审核中
相关跟进：Arch AUR 页面
dnf
等待社区审核中
相关跟进：Red Hat Bugzilla #2351807
其它安装方法: Docker 容器, SSH 远程安装
Docker 容器
在没有预装 curl 或 wget 的精简 Linux 容器环境中，可以使用以下命令快速安装 x-cmd：
x docker run -x -it <container name or id>
x docker setup <container name or id>
- 关于
x docker命令，请参考x-cmd的 Docker 模块文档。
通过 ssh 在远程主机上安装 x-cmd
基本原理是通过 scp 将 x-cmd 的 all-in-one 安装包投送到远程服务器的用户目录中, 并触发以解压和自动配置.
更新 x-cmd: x upgrade
更新 x-cmd 非常简单, 只需要运行 x upgrade 命令
或者再次运行安装脚本：
eval "$(curl https://get.x-cmd.com)"
- 注意：
- 升级过程不会删除旧版本的 x-cmd，也不会影响其他已打开的 shell 环境。
- 更详细的解释和原理分析，请参考 相关文档。
卸载 x-cmd
卸载 x-cmd 非常简单，运行以下命令即可：
x uninstall self
这将删除 ~/.x-cmd.root 目录并清除 shell 配置文件 (如 ~/.bashrc) 中的 x-cmd 加载命令。
- 注意：
- 请在 uninstall 之前, 确保没有活跃的进程在调用 x-cmd
- 更详细的解释和原理分析，请参考 相关文档。