CmdWise 文档

简体中文

English

简体中文

English

Appearance

CmdWise 安装问题排查指南 ​

安装包无法打开 ​

安装包为dmg格式，双击即可自动加载，弹出安装。 拖拽 CmdWise 到 Applications 文件夹中，即可完成安装。 如果出现无法打开，请尝试删除安装包，重新下载安装。

Homebrew 缺失 ​

在"命令应用市场（Command App Market）"页面，查看具体的命令应用（Command App）， CmdWise App 会自动检测系统是否已经安装homebrew。如果没有安装，会提示安装，弹出命令行窗口执行安装homebrew。

如果实在无法安装成功，可以按照homebrew官方网站，手工执行脚本尝试安装。

注意：该安装是执行homebrew官方的脚本，脚本命令执行过程中需要请求网络获取资源，部分资源可能对网络有要求。

中文网络环境安装homebrew ​

如果网络环境无法访问homebrew官方网站，可以尝试使用清华大学镜像。

bash
# 安装xcode-select
xcode-select --install

# 打开终端，执行以下命令
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_INSTALL_FROM_API=1

# 安装homebrew
git clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install
/bin/bash brew-install/install.sh

# 检查是否安装成功
# 如果安装成功，会显示homebrew的版本号
# 如果安装失败，会显示错误信息
brew --version

# 更新homebrew
brew update

安装完成之后，打开cmdwise进入命令应用市场，查看是否能够正常使用。

WARNING

考虑到网络环境问题，export要永久生效，需要将export命令添加到~/.zshrc或~/.bashrc文件中。

bash
echo "export HOMEBREW_BREW_GIT_REMOTE=\"https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git\"" >> ~/.zshrc
echo "export HOMEBREW_CORE_GIT_REMOTE=\"https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git\"" >> ~/.zshrc
echo "export HOMEBREW_INSTALL_FROM_API=1" >> ~/.zshrc

网络无法访问 ​

  1. 检查网络或wifi是否正常，先确定浏览器能否正常打开 https://www.apple.com
  2. 检查是否有设置代理软件，导致无法访问

cmdwise命令应用市场连接 ：https://api.cmdwise.app 获取应用信息， 可以手工浏览器访问验证是否能够正常打开。

其它 FAQ ​

命令应用（Command App）无法正常显示，样式难看 ​

由于页面渲染需要依赖样式，通过请求网络读取样式文件，需要保证网络正常，样式文件正常访问。

  1. 尝试浏览器访问 tailwindcss 是否正常
  2. 尝试浏览器访问 font-awesome 是否正常

如果访问失败，请检查网络是否正常，或者使用代理访问。

命令无法使用 ​

cmdwise app 本身不提供具体命令的实现，具体命令由操作系统（比如macos）内置或是第三方（比如brew）提供。 比如 brew install pdfly，pdfly 针对操作系统有版本要求，低于macos12，则无法使用。

如果通过cmdwise app提示的brew 安装命令，尝试多次都无法正常。可能是操作系统版本不支持。 可以尝试，手工在终端中执行命令，看看是否正常。

Copyright © 2025 CmdWise Team