一、抹掉磁盘并重装系统#
如果是旧电脑需要做开发者隔离,推荐使用抹掉磁盘+重装系统,如果当前电脑之前使用过其他开发者账号后,当然最好是换台新设备,而不是简单的抹掉内容和配置。
重置步骤:
- 关机并重启,进入恢复模式(按住 Command + R)
- 打开“磁盘工具” > 抹掉整个系统盘(Macintosh HD)
- 重新安装 macOS
- 开机后以全新设备使用(不恢复任何备份)
按照正常的流程配置激活系统即可。
二、默认安装位置&自定义位置#
默认安装位置:/usr/local/
Brew默认安装位置:/opt/homebrew/
自定义安装位置:/Users/xiaopin/dev/
有些工具和包通过安装文件的方式安装的,可以自定义目录,但是需要自己配置环境变量,如果是用HomeBrew的,系统自定选择安装的默认位置。因为是考虑到有时候brew安装巨慢的时候,可以考虑手动官网下载安装程序进行安装。
三、基础配置#
3.1 从Finder中配置显示Macintosh HD和用户目录#
英文:打开Finder,点击顶部菜单Finder->Settings
中文:打开访达,点击顶部菜单访达->设置->边栏->勾选硬盘->勾选用户目录(房子图标)
3.2 HOST配置(中国大陆)#
进入Macintosh HD后,默认是看不到/private/etc/Hosts, 因为这些事系统的隐藏系统文件,按Command + Shift + . 组合命令,显示或隐藏文件。 找到/private/etc/Hosts,将Hosts文件复制到桌面再进行修改。
##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting. Do not change this entry.
##
127.0.0.1 localhost
255.255.255.255 broadcasthost
::1 localhost
# GitHub Start
140.82.114.4 github.com
140.82.114.20 gist.github.com
151.101.184.133 assets-cdn.github.com
151.101.184.133 raw.githubusercontent.com
151.101.184.133 gist.githubusercontent.com
151.101.184.133 cloud.githubusercontent.com
151.101.184.133 camo.githubusercontent.com
151.101.184.133 avatars0.githubusercontent.com
199.232.68.133 avatars0.githubusercontent.com
199.232.28.133 avatars1.githubusercontent.com
151.101.184.133 avatars1.githubusercontent.com
151.101.184.133 avatars2.githubusercontent.com
199.232.28.133 avatars2.githubusercontent.com
151.101.184.133 avatars3.githubusercontent.com
199.232.68.133 avatars3.githubusercontent.com
151.101.184.133 avatars4.githubusercontent.com
199.232.68.133 avatars4.githubusercontent.com
151.101.184.133 avatars5.githubusercontent.com
199.232.68.133 avatars5.githubusercontent.com
151.101.184.133 avatars6.githubusercontent.com
199.232.68.133 avatars6.githubusercontent.com
151.101.184.133 avatars7.githubusercontent.com
199.232.68.133 avatars7.githubusercontent.com
151.101.184.133 avatars8.githubusercontent.com
199.232.68.133 avatars8.githubusercontent.com
# GitHub End
主要是将# GitHub Start 到 # GitHub End的内容添加进去,保存以后,在将Host文件复制替换到/private/etc/Hosts。
3.3 科学网络配置#
下载安装ClashX,配置订阅节点即可,不详细解释。有科学网络1.2步骤就不需要了。
四、iOS开发环境安装&配置#
1.更新macOS最新系统
桌面左上角苹果图标->系统设置->通用->软件更新
2.直接通过AppStore安装Xcode,会将git一起安装
五、SSHKey生成配置#
配置 SSH Key 是连接到远程服务器或 Git 仓库(如 GitHub、GitLab 等)的常见方法。以下是如何在 macOS 上生成和配置 SSH Key 的详细步骤:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
如果你使用默认路径,公钥将保存在 ~/.ssh/id_rsa.pub 文件中,私钥在 ~/.ssh/id_rsa 文件中。
复制公钥:
pbcopy < ~/.ssh/id_rsa.pub
这将公钥复制到剪贴板,你可以将其粘贴到远程服务器的 ~/.ssh/authorized_keys 文件中,或者在服务的设置中添加。
比如Github -> 头像 -> Settings -> SSH and GPG keys -> New SSH key -> 设置Title名称(计算机名或其他) -> 粘贴公钥 -> 保存
如果使用Github Desktop的话就不需要了,登录账号即可。
六、HomeBrew安装&配置#
打开终端命令输入:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
或使用国内镜像更快
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
如果失败多试几次,可能是你的网络问题,安装完成以后命令行输入:brew -v ,查看homebrew版本看看是否安装成功。
七、Ruby安装&配置#
一般情况下,macOS默认会安装ruby,版本可能不是最新的
官方网站:https://www.ruby-lang.org/zh_cn/downloads/
- 使用Brew安装最新的Ruby版本
brew install ruby
- 修改Shell配置文件,
#Intel芯片(目前来说可以抛弃了,现在基本都是苹果芯片)
echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile
#苹果M系列芯片
echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
也可以手动的的找到.zshrc文件,一般在 Users/用户名/.zshrc 目录下,用文本编辑器打开,在最后面加上
#如果是RVM安装的会自动有这行,可以不管,也可以注释
export PATH="$PATH:$HOME/.rvm/bin"
#在后面加上这行,会自动的将默认环境指向homebrew的ruby版本
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
- 验证安装
#查看默认ruby路径
which ruby
#查看ruby版本
ruby -v
也可以通过 rbenv 和 rvm 方式安装,之前一直用的rvm,但是rvm更新较慢,无法保证是最新的ruby版本。只要那种方式能安装最新的,就用哪种。
八、Cocoapods安装&配置#
- 升级gem和更换镜像源
Gems 是 Ruby 的包管理系统(RubyGems)用来分发和管理 Ruby 库和应用程序的包。Gems 可以包含库、应用程序、文档和其他资源,方便开发者在项目中使用和管理依赖。
- 升级gem命令
sudo gem update --system
- 更换镜像源
移除旧源
gem sources --remove https://rubygems.org/
添加新源
gem sources -a https://gems.ruby-china.com
查看镜像源信息
gem sources -l
- 彻底卸载cocoapods
- 卸载已有旧版本
sudo gem uninstall cocoapods
- 查看本地已安装的cocoapods依赖
gem list --local | grep cocoapods
显示如下:
cocoapods (1.0.1)
cocoapods-core (1.0.1)
cocoapods-deintegrate (1.0.1)
cocoapods-downloader (1.1.1)
cocoapods-plugins (1.0.0)
cocoapods-search (1.0.0)
cocoapods-stats (1.0.0)
cocoapods-trunk (1.0.0)
cocoapods-try (1.1.0)
- 逐个删除
sudo gem uninstall cocoapods-core
sudo gem uninstall cocoapods-deintegrate
sudo gem uninstall cocoapods-downloader
sudo gem uninstall cocoapods-plugins
sudo gem uninstall cocoapods-search
...
- Cocoapods安装
macOS 10.11以后系统的安装cocoapods 指令,可安装制定版本:
sudo gem install -n /usr/local/bin cocoapods
或
sudo gem install -n /usr/local/bin cocoapods -v 1.9.2
安装完成后,查看一下版本
pod --version
九、Android开发环境安装&配置#
9.1 资源文档地址#
Android官网:https://www.android.com/intl/zh-CN_cn/
Android开发者中心:https://developer.android.com/?hl=zh-cn
9.2 JDK安装配置#
OpenJDK: https://adoptium.net/zh-cn/
OpenJDK推荐统一下载 17LTS版本,以后如果环境需要再升级到21LTS
直接双击*.pkg安装文件安装
9.3 Android Studio安装配置#
Android Studio 是开发 Android 应用的官方 IDE,包含了 Android SDK、模拟器等开发所需的工具。
- 下载并安装 Android Studio:
• 访问 Android Studio 官方网站:https://developer.android.com/studio
• 下载适用于 macOS 的安装包,并进行安装。
- 打开 Android Studio,按照向导完成安装过程。
• 安装过程中会提示安装 Android SDK、Android Virtual Device (AVD) 和其他依赖工具,点击 Next 完成安装。
- 设置 Android SDK:
• 启动 Android Studio 后,打开 Preferences(在顶部菜单栏点击 Android Studio > Preferences)。
• 在 SDK Manager 中,确保 Android SDK 和 Android SDK Build-Tools 已安装,并选择需要的 Android API 版本。
设置JDK路径(可选)
Android Studio > Settings > Build,Execution,Deployment > Build Tools > Gradle > Gradle Projects > Gradle JDK > 选择默认的或者自己安装的JDK环境
9.4 配置模拟器#
配置步骤:Android Studio > Tools > Device Manager > 添加
根据提示安装对应的模拟器
9.5 创建项目并运行#
新建一个模版工程-> 等待配置安装依赖完成 -> 选择模拟器 -> 运行或调试
十、Harmony开发环境&配置#
十一、Flutter安装&配置#
11.1 直接下载解压配置#
前提: 安装配置了上面的环境后
解压到自定义目录下:/Users/xiaopin/dev/目录下后为:/Users/xiaopin/dev/flutter
将配置添加到~/.zshrc
export PATH=/Users/xiaopin/dev/flutter/bin:$PATH export PUB_HOSTED_URL=https://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn运行命令查看
flutter doctor
11.2 使用FVM方式下载安装多个版本管理#
1.介绍说明#
FVM (Flutter Version Management) 是一个开源工具,旨在简化和管理 Flutter 的不同版本,允许开发者在一个项目中使用特定版本的 Flutter,而无需更改全局安装的 Flutter 版本。
官方网站:https://fvm.app/documentation/getting-started
多版本管理:
• 支持在不同项目中使用不同的 Flutter 版本。
• 允许轻松切换 Flutter 版本,而无需手动安装或卸载。
项目级版本控制:
• 每个项目可以指定一个特定的 Flutter 版本,其他项目不会受到影响。
• 避免因 Flutter 版本更新而导致的兼容性问题。
共享版本:
• 同一设备上多个项目可以共享相同的 Flutter 版本,减少磁盘空间浪费。
易于 CI/CD 集成:
• 提供简单的工具和命令行支持,适合在 CI/CD 管道中指定 Flutter 版本。
FVM 是管理 Flutter 多版本的强大工具,适用于团队协作和复杂项目场景,能显著提升开发效率,避免版本兼容性问题。如果你的项目需要频繁切换 Flutter 版本,或者团队中有多个项目运行在不同的版本上,FVM 是一个值得采用的工具。
2.安装和使用#
2.1Homebrew安装FVM#
#安装命令
brew tap leoafarias/fvm
brew install fvm
#卸载命令
brew uninstall fvm
brew untap leoafarias/fvm
查看版本#
fvm --version
2.2.配置环境变量#
# 设置 FVM 缓存路径
export FVM_CACHE_PATH="$HOME/fvm_cache"
# 启用 Git 缓存
export FVM_USE_GIT_CACHE=true
# 设置 Git 缓存路径
export FVM_GIT_CACHE_PATH="$HOME/fvm_git_cache"
# 自定义 Flutter 仓库地址
export FVM_FLUTTER_URL="https://github.com/flutter/flutter.git"
# 启用特权访问
export FVM_PRIVILEGED_ACCESS=true
FVM_GIT_CACHE_PATH
•用于存储 Flutter Git 仓库的本地引用。
•主要作用是加速 Flutter SDK 的版本切换和下载过程。
•默认路径:~/.fvm/git_cache/。
FVM_CACHE_PATH
•用于存储已下载的 Flutter SDK 文件(即解压后的完整 Flutter SDK)。
•这是实际使用 Flutter SDK 的路径。
•默认路径:~/.fvm/versions/。
将这两个存放到自己指定的目录中,比如我的开发环境一般都存放在/User/xiaopin/dev/ 中, 只要配置这两个就好了。
# FVM存储路径配置
export FVM_GIT_CACHE_PATH="/Users/xiaopin/flutter/fvm/gitcache/"
export FVM_CACHE_PATH="/Users/xiaopin/flutter/fvm/"
export PATH=/Users/xiaopin/flutter/fvm/default/bin:$PATH
export PATH="$PATH":"$HOME/.pub-cache/bin"
2.3.安装指定版本flutter#
fvm install 3.24.0
2.4.在项目中指定Flutter版本#
在项目根目录下,使用以下命令将特定的 Flutter 版本关联到该项目:
fvm use 3.24.0
这会生成一个 .fvm 文件夹和一个 fvm_config.json 文件,用于保存项目的 Flutter 版本配置。
2.5.运行Flutter命令#
fvm flutter run
fvm flutter doctor
2.6.升级Flutter版本#
fvm install <new_version>
fvm use <new_version>
2.7.卸载旧Flutter版本#
fvm remove 3.24.0
2.8. 查看已安装版本#
fvm list
3.10.0 (global)
3.13.0 (active)
2.5.3
• global:全局版本,默认在所有项目中使用。
• active:当前项目的版本。
2.9. 查看可安装版本#
fvm releases
stable
3.13.1
3.13.0
...
beta
3.14.0-1.0.pre
3.13.0-0.3.pre
...
2.10. 清理FVM所有缓存和SDK#
FVM中的destroy命令是一个强大的工具,用于完全删除FVM缓存,包括所有缓存的Flutter SDK版本。此命令对于清理空间或重置FVM设置很有用。
fvm destroy
3. 设置默认全局Flutter版本#
fvm global 3.24.5
4. 项目单独指定Flutter版本#
fvm use 3.24.0
5. FVM 配置文件#
在项目中,FVM 会生成两个关键文件:
.fvm/fvm_config.json:
{
"flutterSdkVersion": "3.13.0"
}
- .gitignore
通常会忽略 .fvm/ 文件夹以避免版本冲突。
6. FVM 的适用场景#
1.团队协作:
确保团队成员使用相同的 Flutter 版本,避免因版本差异引发问题。
- 维护旧项目:
在新项目中使用最新版本的 Flutter,同时为旧项目保留其兼容的版本。
- 测试与调试:
快速切换 Flutter 版本以测试兼容性或复现问题。
十二、Go安装&配置#
12.1 常规安装配置#
官网下载
https://go.dev/dl/,官方都是通过安装包方式安装的。对于开发环境来说可以。如果是服务器环境的话采用docker方式,命令行方式。
安装程序安装
到官网地址下载最新的安装程序包以后,根据步骤安装,默认自动安装到 /usr/local/go 路径下,同时会自动的将 /usr/local/go/bin 添加到环境变量中。在命令行中查看版本验证是否正常安装:
go version
#go version go1.22.5 darwin/arm64
12.2 使用GVM方式下载安装多个版本管理#
介绍说明#
gvm 是 Go Version Manager 的缩写,类似于 nvm(Node.js)、pyenv(Python)、fvm(Flutter),用于在同一台机器上安装、切换多个版本的 Golang。
它适合以下场景:
- 想在本机测试多个 Go 版本兼容性
- 项目使用的 Go 版本与系统不一致
- 快速切换不同版本的 Go 编译器
支持平台#
- macOS ✅
- Linux ✅
- Windows ❌(推荐使用 g 或 WSL)
卸载旧环境#
原来如果通过pkg安装包方式安装的go环境要清理掉,避免冲突
sudo rm -rf /usr/local/go
删掉 ~/.zshrc中的配置
export PATH=$PATH:/usr/local/go/bin
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
重新加载~/.zshrc
source ~/.zshrc
安装和使用#
编写安装脚本
创建一个文件 install_gvm_go.sh , 这个默认装了 go1.24.4最新版本。
#!/bin/bash
set -e
# 1. 安装依赖
echo "🔧 安装依赖..."
if [[ "$OSTYPE" == "darwin"* ]]; then
brew install curl git mercurial make binutils bison gcc
else
sudo apt update
sudo apt install -y curl git mercurial make binutils bison gcc
fi
# 2. 安装 GVM
if [ ! -d "$HOME/.gvm" ]; then
echo "⬇️ 安装 GVM..."
bash < <(curl -sSL https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
else
echo "✅ GVM 已安装,跳过。"
fi
# 3. 加载 GVM 环境
source "$HOME/.gvm/scripts/gvm"
# 4. 安装 go1.4 -B
if ! gvm list | grep -q "go1.4"; then
echo "📦 安装 go1.4 (bootstrap)..."
gvm install go1.4 -B
else
echo "✅ go1.4 已安装,跳过。"
fi
# 5. 安装 go1.24.4
if ! gvm list | grep -q "go1.24.4"; then
echo "📦 安装 go1.24.4 ..."
gvm install go1.24.4
else
echo "✅ go1.24.4 已安装,跳过。"
fi
# 6. 设置默认版本
echo "✅ 设置默认版本为 go1.24.4 ..."
gvm use go1.24.4 --default
echo "📌 当前 Go 版本:"
go version
授权和运行脚本
#执行一下3个命令
cd [install_gvm_go.sh的文件目录]
chmod +x install_gvm_go.sh
./install_gvm_go.sh
卸载gvm#
#删除
rm -rf ~/.gvm
#删除~/.zshrc配置
常用命令#
12.3 其他插件的安装配置#
dlv
goctl
gopls
protoc
Protoc-gen-go
reverse
xorm
….
十三、mysql安装&配置#
十四、Nodejs安装&配置#
14.1 卸载所有旧Nodejs环境#
1. 检查 Node.js 安装方式#
先在终端输入以下命令,查看 node 路径:
which node
常见路径有:
/usr/local/bin/node(Homebrew 或官方包)
/opt/homebrew/bin/node(Apple Silicon Homebrew)
~/.nvm/versions/node/(nvm)
2. 用 Homebrew 卸载#
如果你是用 Homebrew 安装的:
brew uninstall node
3. 用 nvm 卸载#
如果你用 nvm 管理 Node.js 版本:
#查看所有版本
nvm ls
#查看已安装的版本,然后逐个卸载
nvm uninstall <版本号>
#卸载(如果不需要)
#rm -rf ~/.nvm
并删除相关配置(如 .zshrc 或 .bash_profile 里的 nvm 配置行)。
4. 手动删除官方安装包的 Node.js#
如果你是用官网下载的 pkg 安装包,需手动删除:
sudo rm -rf /usr/local/bin/node
sudo rm -rf /usr/local/bin/npm
sudo rm -rf /usr/local/include/node
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /usr/local/share/man/man1/node.1
sudo rm -rf /usr/local/share/doc/node
5. 检查并清理残留#
可以用以下命令检查 node 是否还存在:
which node
node -v
如果还有残留路径,按提示继续删除。
6. 清理 npm 缓存(可选)#
sudo rm -rf ~/.npm
sudo rm -rf ~/.node-gyp
14.2 安装配置#
官方网站下载安装教程#
https://nodejs.org/zh-cn/download/
在 macOS 下卸载现有的所有 Node.js 环境,常见有以下几种安装方式:
通过 Homebrew 安装
通过官方安装包(pkg)安装
通过 nvm(Node Version Manager)安装
安装程序安装#
默认安装目录
•Node.js v20.15.1 to /usr/local/bin/node •npm v10.7.0 to /usr/local/bin/npm
brew方式安装#
# Download and install Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash
# Download and install Node.js:
brew install node@22
# Verify the Node.js version:
node -v # Should print "v22.15.0".
# Verify npm version:
npm -v # Should print "10.9.2".
nvm方式安装(多项目不同版本推荐)#
npm模式
# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"
# Download and install Node.js:
nvm install 22
# Verify the Node.js version:
node -v # Should print "v22.15.0".
nvm current # Should print "v22.15.0".
# Verify npm version:
npm -v # Should print "10.9.2".
yarn模式
# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"
# Download and install Node.js:
nvm install 22
# Verify the Node.js version:
node -v # Should print "v22.15.0".
nvm current # Should print "v22.15.0".
# Download and install Yarn:
corepack enable yarn
# Verify Yarn version:
yarn -v
pnpm模式
# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"
# Download and install Node.js:
nvm install 22
# Verify the Node.js version:
node -v # Should print "v22.15.0".
nvm current # Should print "v22.15.0".
# Download and install pnpm:
corepack enable pnpm
# Verify pnpm version:
pnpm -v
nvm命令#
如果是不同项目不同版本,这个nvm就非常好用
#查看版本
nvm --version
#查看可安装的Node.js版本
nvm ls-remote
#安装指定版本
nvm install 22.15.0
#安装一个系统兼容的版本
nvm install --lts
#查看已安装版本
nvm ls
#切换指定版本
nvm use 22.15.0
#设置默认版本
nvm alias default 22.15.0
#卸载指定版本
nvm uninstall 18.18.0
#查看当前正在使用的node.js版本
nvm current
#列出所有别名
nvm alias
#升级nvm, 重新安装最新的
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
#查看帮助
nvm --help
node.js 命令#
node- 启动 Node.js 解释器,可以直接执行 JavaScript 文件或进入 REPL(交互式解释器)模式。
- 示例:
node app.js
node --version或node -v- 显示当前 Node.js 的版本信息。
node inspect <script>- 使用调试器启动脚本。
node --inspect=<port> <script>- 启动脚本并监听指定端口,用于远程调试。
npm 命令#
全称:Node Package Manager
特点:
Node.js 官方自带,安装 Node.js 时自动安装。
社区最大,兼容性最好,文档丰富。
速度一般,依赖管理方式为“嵌套 node_modules”。
6.x 以后支持 package-lock.json,7.x 以后支持 workspaces。
适用场景:新手入门、兼容性要求高的项目。
npm init- 初始化一个 npm 项目,创建或更新
package.json文件。
- 初始化一个 npm 项目,创建或更新
npm install或npm i- 安装项目所需的依赖包,根据
package.json和package-lock.json文件。
- 安装项目所需的依赖包,根据
npm install <package>或npm i <package>- 安装指定的包到项目中。
npm install <package> --save或npm i <package> -S- 安装包并将它添加到
dependencies列表中。
- 安装包并将它添加到
npm install <package> --save-dev或npm i <package> -D- 安装包并将它添加到
devDependencies列表中。
- 安装包并将它添加到
npm uninstall <package>或npm un <package>- 卸载指定的包。
npm uninstall <package> --save或npm un <package> -S- 卸载包并从
dependencies中移除。
- 卸载包并从
npm uninstall <package> --save-dev或npm un <package> -D- 卸载包并从
devDependencies中移除。
- 卸载包并从
npm update- 更新所有已安装的包到最新版本。
npm update <package>- 更新指定的包到最新版本。
npm outdated- 显示哪些已安装的包有更新的版本。
npm list或npm ls- 列出所有已安装的包及其版本。
npm publish- 发布当前项目到 npm 仓库。
npm run <script>- 执行
package.json文件中定义的脚本。
- 执行
npm start- 运行
package.json文件中定义的start脚本。
- 运行
npm test- 运行
package.json文件中定义的test脚本。
- 运行
npm config get prefix- 显示全局包的安装前缀。
npm config set prefix <path>- 设置全局包的安装前缀。
npm cache clean- 清理 npm 缓存。
npm help- 显示帮助信息。
以上命令覆盖了 Node.js 和 npm 的大部分日常使用场景,从项目初始化到包管理,再到运行和调试应用程序。
yarn命令#
由 Facebook 推出
特点:
速度比老版 npm 快,依赖解析更稳定。
支持 yarn.lock 锁定依赖,保证团队一致性。
支持 workspaces,适合 monorepo 多包管理。
CLI 体验好,命令简洁。
2.x 以后(Berry)有较大变动,支持 PnP(Plug’n’Play)等新特性。
适用场景:团队协作、需要更快安装速度和一致性的项目。
pnpm命令(推荐)#
新一代包管理器
特点:
速度最快,磁盘占用最小。
采用“硬链接”技术,所有依赖只下载一次,多个项目共享依赖,极大节省空间。
依赖结构更严格,能发现 npm/yarn 难以发现的依赖问题。
支持 workspaces,适合 monorepo。
兼容 npm/yarn 的大部分命令。
适用场景:大型项目、monorepo、多项目协作、追求极致性能和空间节省。
pnpm 是一个高性能的包管理器,用于 Node.js 项目,它提供了比 npm 和 yarn 更快的速度和更少的磁盘空间占用。
重新构建
#删除旧的依赖
rm -rf node_modules package-lock.json pnpm-lock.yaml yarn.lock
#重新安装
pnpm install
#如果需要,指定vite
#pnpm add vite@4.3.9 -D
#运行
pnpm run dev
十五、Python安装&配置#
15.1 检查自己安装了哪些版本#
我当前的系统环境是:macOS 15.1, 默认是/usr/bin/python3,Python 3.9.6
#先输入命令看看有没有返回版本号
python --version
python3 --version
#查看环境变量路径
which python
which python3
#查看所有安装的版本
ls /usr/bin/python*
ls /usr/local/bin/python*
15.2 卸载已安装的版本#
macOS默认自带的 /usr/bin/python3 低版本不用管它。
如果你之前用Homebrew安装过,使用Homebrew卸载就好了。
#查看Python相关包
brew list | grep python
#卸载
brew uninstall python@3.12 python@3.13
brew autoremove # 移除不再需要的依赖
brew cleanup # 清理 Homebrew 缓存
#查看Python相关包
brew list | grep python
#删除遗留
sudo rm -rf /opt/homebrew/bin/python3
sudo rm -rf /opt/homebrew/lib/python*
sudo rm -rf /opt/homebrew/include/python*
#查看是否还在
which python3
python3 --version
#关闭重开终端
15.3 pyenv多版本管理工具安装#
pyenv 是一个非常流行的工具,主要用于管理多个 Python 版本。它允许你安装不同版本的 Python,并可以在不同版本之间快速切换,适合需要多版本 Python 环境的开发者。
功能:
多版本管理: 允许安装和管理多个 Python 版本(如 3.7、3.8、3.9 等)。
全局和本地版本: 可以设置全局默认的 Python 版本,也可以在某个目录(项目)下指定特定的版本。
无需修改系统 Python: pyenv 不会干扰系统安装的 Python 版本,而是通过 PATH 环境变量来管理不同版本的 Python。
安装 pyenv(macOS):
安装 Homebrew(如果你还没有安装):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"通过 Homebrew 安装 pyenv:
brew install pyenv安装必要的依赖(可选,但推荐):
brew install openssl readline sqlite3 xz zlib配置 shell 环境:
将以下内容添加到你的 ~/.zshrc 或 ~/.bash_profile(取决于你使用的 shell):
export PATH="$HOME/.pyenv/bin:$PATH" eval "$(pyenv init --path)" eval "$(pyenv init -)"重新打开终端或者在现有终端:
source ~/.zshrc # 如果你用的是 zsh source ~/.bash_profile # 如果你用的是 bash查看可用的 Python 版本:
pyenv install --list安装某个 Python 版本
pyenv install 3.13.2
- 切换全局版本
pyenv global 3.13.2
- 切换本地版本
#在项目目录中使用特定版本
pyenv local 3.9.1
- 查看当前使用的 Python 版本
pyenv version
优点:
精确管理:能精确地选择每个项目或全局环境使用的 Python 版本。
简洁高效:切换版本非常快速,且不会影响系统的 Python 环境。
15.4 Conda多版本管理工具安装#
Conda 是一个更为全面的环境管理工具,它不仅可以管理 Python 版本,还可以管理其他编程语言和工具的版本(例如 R、Java、Node.js 等)。它的主要优点是能够处理 依赖 和 包 的安装和管理,特别适合科学计算和数据科学领域的开发者。
功能:
环境管理: 可以创建多个虚拟环境,每个环境有独立的 Python 版本和其他依赖。
包管理: Conda 可以轻松管理 Python 依赖以及其他语言的依赖,解决包依赖冲突问题。
跨平台: Conda 跨平台支持,适用于 macOS、Linux 和 Windows。
支持非 Python 语言: 除了 Python,Conda 还支持 R、Ruby 等语言的环境管理。
安装 Conda(Miniconda 或 Anaconda):
Miniconda:是 Conda 的轻量级版本,适合需要手动安装依赖包的开发者。
brew install --cask minicondaAnaconda:是 Conda 的完整版,预装了大量数据科学相关的包。
初始化 Conda:
安装后,执行以下命令来初始化 Conda 环境:
conda init zsh # 如果你使用的是 zsh
conda init bash # 如果你使用的是 bash
#重新载入
source ~/.zshrc # 如果你用的是 zsh
source ~/.bash_profile # 如果你用的是 bash
使用 Conda:
#创建新的虚拟环境并安装 Python
conda create --name myenv python=3.8
#激活虚拟环境
conda activate myenv
#安装依赖
conda install numpy pandas # 安装其他包
#切换环境
conda install python=3.9
#查看版本
python --version
#删除环境
conda remove --name myenv --all
优点:
包和环境管理一体化:Conda 同时支持 Python 和其他依赖包的管理,适合需要管理复杂依赖的项目。
跨平台支持:Conda 提供跨平台的支持,非常适合开发在多个操作系统上工作的项目。
科学计算和数据分析:对于数据科学、机器学习开发者来说,Conda 提供了丰富的工具包和库(例如 TensorFlow、PyTorch 等)。
适用场景:
如果你不仅仅需要管理 Python 版本,还需要管理其他包和语言的环境,Conda 是更好的选择。
适合那些涉及 数据科学、机器学习、大数据分析 的开发者。

