macOS

1
2
3
4

# 关闭
sudo spctl --master-disable
# 开启
sudo spctl --master-enable

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 国内需要科学上网才可以
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装后，重开终端，查看版本
# 或者
# brew --version
brew -v 

# 查看帮助文档
# 或者
# brew --help
brew -h

# brew 环境变量
# 打开 ~/.zshrc
nano ~/.zshrc

# 添加以下一行到文件末尾
eval "$(/opt/homebrew/bin/brew shellenv)"

# `Ctrl+O` → 回车保存 → `Ctrl+X` -> 退出
# 加载~/.zshrc 中的配置使其在当前终端中立即生效
source ~/.zshrc

1
2
3

/opt/homebrew/bin/git
/opt/homebrew/bin/go
/opt/homebrew/bin/python3

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 安装两个插件
brew install zsh-autosuggestions zsh-syntax-highlighting

# 打开 ~/.zshrc
nano ~/.zshrc

# 在文件末尾粘贴以下内容
source $(brew --prefix)/share/zsh-autosuggestions/zsh-autosuggestions.zsh
source $(brew --prefix)/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh

# `Ctrl+O` → 回车保存 → `Ctrl+X`  -> 退出
# 加载~/.zshrc 中的配置使其在当前终端中立即生效
source ~/.zshrc

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 打开 ~/.zshrc
nano ~/.zshrc

# 在文件最末尾粘贴一行，
PROMPT='[%*] %n@%m %1~ %# '
# `Ctrl+O` → 回车保存 → `Ctrl+X`  -> 退出

# 加载配置，立刻生效
source ~/.zshrc

# 效果预览：
# [15:30:22] lx@lxdeMacBook-Pro prgms %

1
2
3
4
5
6

brew install --cask openinterminal

# 在设置中启用 Finder 扩展
# 依次进入 系统设置 -> 通用 -> 登录项与扩展 -> OpenInTerminal Extensions，然后启用 File Provider。
# 在访达工具栏点击“显示” -> “自定义工具栏”将 “Open in Termimal”图标拖拽到访达窗口中工具栏位置上。
# 这样在访达中，右键会出现“终端”， 窗口中的工具栏也可以打开“终端”！

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

brew install git

# 若之前在安装 brew 之后有在 ~/.zshrc 中添加 eval "$(/opt/homebrew/bin/brew shellenv)"
# 则，当前的git命令就是使用 通过brew安装的git

# 查看 git 版本
git --version
# [11:03:07] lx@lxdeMacBook-Pro ~ % git --version 
# git version 2.55.0

# 查看 git 程序的位置
where git
# [10:56:42] lx@lxdeMacBook-Pro ~ % where git
# /opt/homebrew/bin/git
# /usr/bin/git
# /opt/homebrew/bin/git

# 查看系统自带git的版本
/usr/bin/git --version
# [11:02:23] lx@lxdeMacBook-Pro ~ % /usr/bin/git --version
# git version 2.54.0 (Apple Git-157)


# 生成用于 GitHub 的 SSH Key
#
ssh-keygen -t ed25519 -C "your_email@example.com"
# 1. `Enter file in which to save the key (/Users/lx/.ssh/id_ed25519):`
# 可以直接回车，使用默认路径。
# 2. `Enter passphrase (empty for no passphrase):`
#
# > 
# > **密钥密码（可选，强烈建议设置密码）**：输入密码，每次使用该密钥需要输入；直接回车代表无密码。
# 3. `Enter same passphrase again:` 再次确认密码。
# 完成后在 `~/.ssh` 生成两个文件：
#- `id_ed25519`：**私钥，务必保密，不要泄露**
#- `id_ed25519.pub`：**公钥，复制内容粘贴到 GitHub**


# 将私钥加入 ssh‑agent（Mac）
# 启动 ssh‑agent：
# ```
eval "$(ssh-agent -s)"
# ```

# > 
# > 如果设置了 passphrase，mac 可以把密钥密码存入钥匙串，避免每次手动输入：
# ```
ssh-add --apple-use-keychain ~/.ssh/id_ed25519
# ```

# 获取公钥内容
#
# 复制公钥：
# ```
cat ~/.ssh/id_ed25519.pub
# ```
# 复制全部输出，以 `ssh‑ed25519` 开头，结尾是你的邮箱。

# GitHub 添加公钥
# GitHub 网页右上角头像 → Settings -> 左侧菜单 SSH and GPG keys -> New SSH key -> Title：随便写 -> 
# 将复制的公钥完整粘贴到大框，点击 Add SSH key

# 测试连通性
ssh -T git@github.com
# [7:13:13] lx@lxdeMacBook-Pro RustPrjs % ssh -T git@github.com
# Hi before80! You've successfully authenticated, but GitHub does not provide shell access.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

brew install tree

# 查看版本
tree --version

# 卸载
brew uninstall tree

# 查看当前目录完整树
tree

# 只展示2层（最常用，避免输出太多）
tree -L 2

# 只显示文件夹，不显示文件
tree -d

# 忽略 node_modules 和 .git
tree -I "node_modules|.git"

# 包含隐藏文件
tree -a

# 把目录树输出保存到 README.md
tree -L 2 > README.md

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

brew install go

# 安装后，查看版本
go --version

# 查看配置
go env

# 配置，例如：
# 1. 设置国内代理（最常用的配置，解决模块下载慢的问题）
go env -w GOPROXY=“https://goproxy.cn,direct”

# 2. 撤销 GOPROXY 的设置，恢复为官方默认值
go env -u GOPROXY

1
2
3
4
5
6
7
8

# 安装 rustup，即 Rust 官方的工具链管理器
# 不推荐使用 brew install rust 来安装 rustc+cargo+rustup
curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

# 安装后，重开终端，才能使用相关命令： rustup、 cargo、rustc

# 卸载
rustup self uninstall

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# `python` 永远指向最新稳定 Python3；
brew install python

# 卸载
# brew uninstall python

# 安装指定版本
brew install python@3.14

# 卸载
# brew uninstall python@3.14

# 查看版本
python3 --version
pip3 --version 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

brew install pyenv

# 卸载 pyenv
# brew uninstall pyenv
# 若后续有安装pyenv-virtualenv，则需要先执行 brew install pyenv-virtualenv， 才可以卸载成功！

# 打开 ~/.zshrc
nano ~/.zshrc

# 在文件末尾添加以下两行
eval "$(pyenv init --path)"
eval "$(pyenv init -)"

# `Ctrl+O` → 回车保存 → `Ctrl+X` -> 退出
# 加载~/.zshrc 中的配置使其在当前终端中立即生效
source ~/.zshrc

# 查看版本
pyenv --version
# [12:55:46] lx@lxdeMacBook-Pro ~ % pyenv --version
# pyenv 2.8.5

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# 查看可安装的版本
# 或者 pyenv install --list
pyenv install -l

# 安装指定版本
pyenv install 3.14.7
# 安装自由线程版（无 GIL，实验性）：
# pyenv install 3.14.7t

# 卸载
pyenv uninstall 3.14.7

# 查看已安装的版本
pyenv versions

# 切换 Python 版本
# 1. 仅当前终端会话, 关闭终端即失效
pyenv shell 3.14.7 

# 2. 当前目录及其子目录,写入 .python-version 文件，持久有效
pyenv local 3.14.7

# 3. 全局默认，写入 ~/.pyenv/version，持久有效
pyenv global 3.14.7

# 4. 使用操作系统自带的 Python
# system 是 pyenv 的一个特殊关键字，不是具体的版本号。
# 将 system 作为内容写入 ~/.pyenv/version，持久有效
# 若要 system 有效，则不能在 ~/.zshrc 中写入： eval "$(pyenv init --path)" 和 eval "$(pyenv init -)"
pyenv global system

# 取消设置
pyenv global system
pyenv local --unset
pyenv shell --unset


# 查看当前活跃版本及来源
pyenv version

# 查看全局版本
pyenv global

# 查看当前目录的本地版本
pyenv local

# 当前 python 的真实路径
pyenv which python

# 当前 pip 的真实路径
pyenv which pip

# pyenv 根目录
pyenv root

# 安装新版本或通过 pip install 安装了带命令行入口的工具后，需要重建 shims：
# 通常 pyenv install 会自动执行，但 pip install 不会，所以手动运行。
pyenv rehash

# 更新 pyenv
brew upgrade pyenv
# 或使用 pyenv 自带命令（部分安装方式支持）
pyenv update

1
2
3
4
5
6

brew install uv

# 也可以通过如下方式安装：
# 独立安装脚本：curl -LsSf https://astral.sh/uv/install.sh | sh
# 通过 pip：pip install uv
# 通过 pipx：pipx install uv

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# 管理 Python 版本
# 查看已安装的 Python 版本
uv python list --only-installed
# 查看可安装的 Python 版本
uv python list --only-downloads

# 安装指定版本（可安装多个：3.13 3.14）
# 默认安装 CPython 编译器的 Python 版本
uv python install 3.14.7
# 等价于 uv python install cpython@3.14.7
# uv python install pypy@3.12.14 则是安装 PyPy 编译器的 Python 版本
# CPython、PyPy、GraalPy 都是 Python 语言的具体实现，
# 可以理解为“不同厂家用不同技术做的 Python 解释器/运行时”。它们不是单纯的编译器，
# 而是包含编译器、解释器、运行时环境、标准库等完整组件的软件。

# 一次安装多个版本
# uv python install 3.14.7 3.13.15
# 不指定版本，则安装最新稳定版
# uv python install

# 卸载指定版本
uv python uninstall 3.14.7
# 即 uv python uninstall cpython@3.14.7

# uv python uninstall pypy@3.12.14

# 指定默认 Python 版本
# 即使该版本已经安装，这条命令也会重新将其设置为默认版本，
# 并创建或更新指向该版本的 python 和 python3 可执行文件
uv python --default 3.14.7

# 配置 shell，即将： export PATH="$HOME/.local/bin:$PATH" 加入到 ./zshenv 文件中
uv python update-shell

# 在当前终端，立即生效
source ~/.zshenv

# 为当前项目固定 Python 版本，生成：.python-version 文件
uv python pin 3.14.7

# 当执行 uv venv 或 uv run 等命令时，如果所需 Python 版本不存在，uv 会自动下载


# 查看 Python 实际路径
uv python find 3.14.7

# 创建新项目
uv init myproject
# 或，在 /path/to/parent/ 下创建 myproject 目录，与先 cd 再 uv init myproject 效果类似
uv init --directory /path/to/parent  myproject
cd myproject


# 安装单个包
uv pip install flask

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# 创建虚拟环境， 其中.venv 是目录名
python -m venv .venv
# 激活虚拟环境
source .venv/bin/activate
# 若是Windows系统，则使用 .venv\Scripts\activate 来激活虚拟环境
# 激活后，终端提示符通常会显示 (.venv)

# 验证是否已经处于虚拟环境中
which python
which pip
python --version
# 只显示该环境安装的包
pip list 

# 应该指向 .venv/bin/python 和 .venv/bin/pip。

# 退出虚拟环境
deactivate

# 虚拟环境本质上就是一个目录，删除目录即可：
deactivate
rm -rf .venv

# 建议把 .venv/ 加入 .gitignore，不要提交到 Git：
# 即在 .gitignore 文件中添加以下内容
.venv/
__pyche__/
*.pyc

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

# 安装 pyenv-virtualenv
brew install pyenv-virtualenv

# 在 ~/.zshrc 中加入：
eval "$(pyenv virtualenv-init -)"

# `Ctrl+O` → 回车保存 → `Ctrl+X` -> 退出
# 加载~/.zshrc 中的配置使其在当前终端中立即生效
source ~/.zshrc

# 基于 pyenv 已安装的 Python 3.14.7，创建一个名为 myapp-env 的虚拟环境，并由 pyenv 统一管理。
# 其中 myapp-env 也是目录名
# 在 ~/.pyenv/versions/ 下创建： ~/.pyenv/versions/myapp-env/
pyenv virtualenv 3.14.7 myapp-env
# 也可以省略版本，基于当前活跃版本创建：
# pyenv virtualenv myapp-env

# 手动激活指定的虚拟环境
# 激活后，你的终端提示符前会出现 (myapp-env) 标识
pyenv activate myapp-env

# 或者，绑定到项目，自动激活
cd ~/projects/myapp
pyenv local myapp-env

# 退出虚拟环境
pyenv deactivate

# 列出所有虚拟环境
pyenv virtualenvs


# 删除指定的虚拟环境
# 删除后，~/.pyenv/versions/myapp-env 目录会被移除
pyenv virtualenv-delete myapp-env

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 在当前目录创建 .venv 虚拟环境
uv venv

# 创建名为 my-env 的虚拟环境
uv venv my-env

# 创建使用特定 Python 版本（如 3.14）的虚拟环境
uv venv --python 3.14


# 手动激活 .venv 虚拟环境
source .venv/bin/activate
# 激活后，你的终端提示符前会出现 (.venv) 标识，此时即可使用 uv pip 安装包

# 若使用 my-env 虚拟环境，则需要使用
source my-env/bin/activate
# 激活后，你的终端提示符前会出现 (my-venv) 标识，此时即可使用 uv pip 安装包

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

brew install nginx
# 查看版本确认
nginx -v

# 后台常驻（开机自启）推荐
brew services start nginx
brew services stop nginx
brew services restart nginx

# nginx原生命令
nginx -t                  # ✅校验配置语法，修改配置一定要先跑这个！
nginx -s reload           # 平滑重载配置，不中断服务
nginx -s stop             # 立刻停止
nginx -s quit             # 优雅停止

# 在 /opt/homebrew/etc/nginx/servers/目录下为新站点新建配置文件，例如：prgm.conf，
touch /opt/homebrew/etc/nginx/servers/prgm.conf

# 该文件的内容如下：
server {
    listen 80;
    server_name prgm.cn;

    # 网站根目录，替换成你的网站文件夹
    root /Users/lx/Hugos/prgms/public;
    index index.html index.htm;

    # 前端SPA路由（Vue/React单页应用必须加，刷新404修复）
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 日志（可选）
    access_log /opt/homebrew/var/log/nginx/prgm.cnaccess.log;
    error_log /opt/homebrew/var/log/nginx/prgm.cn.error.log;
}

# 检查配置语法
nginx -t
# 重载配置
nginx -s reload

# 本地域名解析
# 修改 /etc/hosts文件
# 例如，新增 127.0.0.1 prgm.cn
nano /etc/hosts

# nano 相关操作
# `Ctrl + O`：保存
# `Ctrl + X`：退出
# `Ctrl + W`：搜索文字
# `Ctrl + K`：剪切当前一行
# `Ctrl + U`：粘贴

# 查看 /etc/hosts中的内容
cat /etc/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
127.0.0.1	prgm.cn

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 默认安装最新的 extended 版本，该版本支持 Sass，是做 Hugo 站点的首选
brew install hugo
# 重复执行，遇到有新版本，相当于更新版本

# 查看安装版本
hugo version
# 例如： hugo v0.165.0+extended+withdeploy darwin/arm64 BuildDate=2026-08-12T14:26:28Z VendorInfo=Homebrew

# 更新 hugo 版本
brew upgrade hugo

# 锁定 hugo 版本
brew pin hugo

# 取消锁定
brew unpin hugo

1
2
3
4
5
6
7
8

# 安装
brew install --cask stats

# 卸载
brew uninstall --cask stats

# 配置
open /Applications/Stats.app

1
2
3
4
5
6
7
8
9

brew install --cask visual-studio-code

# 安装后查看版本
code --version

# 或从命令行直接打开
open -a "Visual Studio Code"
# 或，指定打开某个文件
code ~/.zshrc

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

# 到 https://developer.android.com/studio?hl=zh-cn 下载最新版 Android Studio
# 点击 Android Studio.dmg 打开后拖入 Applications
# 执行以下命令，递归删除 Android Studio 整个 App 包里所有文件的网络隔离标记
xattr -rd com.apple.quarantine /Applications/Android\ Studio.app 

# 之后打开，同意协议，安装一些组件
Preparing "Install Sources for Android 37.0 (revision 2)".
Downloading https://dl.google.com/android/repository/source-37.0_r02.zip
"Install Sources for Android 37.0 (revision 2)" ready.
Installing Sources for Android 37.0 in /Users/lx/Library/Android/sdk/sources/android-37.0
"Install Sources for Android 37.0 (revision 2)" complete.
"Install Sources for Android 37.0 (revision 2)" finished.
Preparing "Install Android SDK Build-Tools 36 v.36.0.0".
Downloading https://dl.google.com/android/repository/build-tools_r36_macosx.zip
"Install Android SDK Build-Tools 36 v.36.0.0" ready.
Installing Android SDK Build-Tools 36 in /Users/lx/Library/Android/sdk/build-tools/36.0.0
"Install Android SDK Build-Tools 36 v.36.0.0" complete.
"Install Android SDK Build-Tools 36 v.36.0.0" finished.
Preparing "Install Android SDK Platform 37.0 (revision 2)".
Downloading https://dl.google.com/android/repository/platform-37.0_r02.zip
"Install Android SDK Platform 37.0 (revision 2)" ready.
Installing Android SDK Platform 37.0 in /Users/lx/Library/Android/sdk/platforms/android-37.0
"Install Android SDK Platform 37.0 (revision 2)" complete.
"Install Android SDK Platform 37.0 (revision 2)" finished.
Preparing "Install Android SDK Platform-Tools v.37.0.1".
Downloading https://dl.google.com/android/repository/platform-tools_r37.0.1-darwin.zip
"Install Android SDK Platform-Tools v.37.0.1" ready.
Installing Android SDK Platform-Tools in /Users/lx/Library/Android/sdk/platform-tools
"Install Android SDK Platform-Tools v.37.0.1" complete.
"Install Android SDK Platform-Tools v.37.0.1" finished.
Preparing "Install Android Emulator v.37.1.11".
Downloading https://dl.google.com/android/repository/emulator-darwin_aarch64-15917651.zip
"Install Android Emulator v.37.1.11" ready.
Installing Android Emulator in /Users/lx/Library/Android/sdk/emulator
"Install Android Emulator v.37.1.11" complete.
"Install Android Emulator v.37.1.11" finished.
SDK Manager found the following installed packages: build-tools;36.0.0 emulator platform-tools platforms;android-37.0 sources;android-37.0
Android SDK is up to date.

1
2
3
4

# 到 https://github.com/tisfeng/Easydict/releases 下载最新版 Easydict.dmg
# 点击 Easydict.dmg 打开后拖入 Applications
# 执行以下命令，递归删除 Easydict 整个 App 包里所有文件的网络隔离标记
xattr -rd com.apple.quarantine /Applications/Easydict.app

1

brew install lihaoyun6/tap/quickrecorder

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 访问 https://www.navicat.com/en/download/navicat-premium-lite
# 下载安装包
# 打开安装包，拖拽到 Applications
# 执行以下命令，递归删除 Navicat Premium Lite 整个 App 包里所有文件的网络隔离标记
# 下载的 Navicat 打开时，macOS 提示：
# “Navicat Premium Lite” 无法打开，因为 Apple 无法检查其是否包含恶意软件。
# 原理：macOS 检测到文件带有`com.apple.quarantine`标记，
# 触发 Gatekeeper 安全校验；如果软件未公证 / 签名，直接阻止运行。
# 执行这条命令相当于告诉系统：你信任这个程序，不再做隔离校验
xattr -rd com.apple.quarantine /Applications/Navicat\ Premium\ Lite.app 
# 使用临时邮箱注册账号
# 验证邮箱
# 登录账号
# 访问数据库

1
2
3
4

# 到官网 https://www.google.com/chrome/dr/download/ 下载 Chrome 的最新安装包
# 打开安装包，拖拽到 Applications
# 执行以下命令
xattr -rd com.apple.quarantine /Applications/Google\ Chrome.app 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 前提没有提交到远程仓库
# 推荐：撤销本次commit，代码保留在暂存区（最安全，不会丢代码）
# `HEAD^` = 上一个提交节点，回退 HEAD 指针，
# 文件改动还在 add 后的暂存状态，可以重新写 message 再 commit
git reset --soft HEAD^

# 或者
# 撤销本次commit，代码保留在工作区（取消add，需要重新git add）
# 等价 git reset --mixed HEAD^ （mixed是reset默认模式）
git reset HEAD^

# 如果你只是想修改这次空的 commit message，而不是撤销提交，直接：
git commit --amend -m "正确的提交信息"

1
2

git reset HEAD
# 等价于 git reset --mixed HEAD

1

git restore --staged .

1
2

git reset HEAD 文件名
# 示例：git reset HEAD src/main.rs