一只比尔

在 Ubuntu 上安装更高版本的 CMake

2026-09-03T00:00:00.000Z

对于较老的 Ubuntu 版本，其包管理器中提供的 CMake 往往也是很老的版本，无法编译某些要求更高的程序。可以通过添加 CMake 官方提供的 Kitware APT Repository 来安装更高版本的 CMake。

1 安装依赖#

Terminal window

1
sudo apt-get update
2
sudo apt-get install ca-certificates gpg wget

2 获取签名密钥#

Terminal window

1
test -f /usr/share/doc/kitware-archive-keyring/copyright ||
2
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /usr/share/keyrings/kitware-archive-keyring.gpg >/dev/null

3 添加仓库#

Ubuntu Resolute Raccoon (26.04):

Terminal window

1
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ resolute-rc main' | sudo tee -a /etc/apt/sources.list.d/kitware.list >/dev/null
2
sudo apt-get update

Ubuntu Noble Numbat (24.04):

Terminal window

1
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ noble main' | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null
2
sudo apt-get update

Ubuntu Jammy Jellyfish (22.04):

Terminal window

1
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ jammy main' | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null
2
sudo apt-get update

Ubuntu Focal Fossa (20.04):

Terminal window

1
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ focal main' | sudo tee /etc/apt/sources.list.d/kitware.list >/dev/null
2
sudo apt-get update

4 安装 keyring#

Terminal window

1
sudo apt-get install kitware-archive-keyring

5 安装 CMake#

Terminal window

1
sudo apt-get install cmake

在 Ubuntu 上使用 Git Credential Manager（GCM）实现认证

2026-08-05T00:00:00.000Z

Git Credential Manager（GCM）是一个跨平台的凭证助手，能够安全地存储 Git 凭证并自动完成身份验证，同时支持 OAuth、双因素认证（2FA）等现代认证方式，且支持多账户场景，会根据不同的托管平台和仓库地址自动匹配对应的凭证。本文将介绍如何在 Ubuntu 系统上从 GitHub Release 下载安装 GCM，并配置其使用 Ubuntu 自带的 Seahorse（GNOME Keyring）作为凭证存储后端，最终实现访问私有仓库时通过浏览器完成登录认证的完整流程。

1 从 GitHub Release 下载安装 GCM#

GCM 官方维护在 GitHub 上，项目地址为 https://github.com/git-ecosystem/git-credential-manager。Ubuntu/Debian 系统可以通过 .deb 包进行安装。

1.1 下载最新的 `.deb` 包#

访问 GCM 的 Releases 页面，找到最新版本的 .deb 包。通常文件名为 gcm-linux-x64-{version}.deb。

1.2 安装 `.deb` 包#

记得更换为实际的路径。

Terminal window

1
sudo apt install ./path/to/gcm-linux-x64-{version}.deb

2 配置 GCM 使用 Seahorse 作为凭证存储#

与 Windows 和 macOS 不同，Linux 系统没有默认的全局凭证存储机制，因此需要手动配置 GCM 使用哪种凭证存储后端。Ubuntu 系统自带 GNOME Keyring，可以通过 Seahorse（“密码与密钥”应用）进行图形化管理。

2.1 配置 credential.helper#

将 GCM 设置为 Git 的凭证助手：

Terminal window

1
git config --global credential.helper manager

2.2 配置 credential.credentialStore 为 secretservice#

GCM 在 Linux 上支持多种凭证存储方式，包括 secretservice（基于 freedesktop.org Secret Service API）、gpg（基于 GPG 加密）以及 cache（内存缓存）等。其中 secretservice 使用 libsecret 库通过 D-Bus 与 GNOME Keyring 或 KDE Wallet 等桌面凭证管理器交互，在 Ubuntu 上由 Seahorse（GNOME Keyring）提供支持。

执行以下命令将凭证存储设置为 secretservice：

Terminal window

1
git config --global credential.credentialStore secretservice

也可以通过环境变量方式配置：export GCM_CREDENTIAL_STORE=secretservice。

2.3 确保依赖已安装#

secretservice 存储方式需要 libsecret 库的支持。在 Ubuntu 上通常已经预装，如果没有，可以手动安装：

Terminal window

1
sudo apt update
2
sudo apt install libsecret-1-0 libsecret-1-dev

2.4 重启系统#

配置完成后，建议重启系统以确保所有更改生效。如果不重启，可能会遇到一些奇怪的错误。

Terminal window

1
sudo reboot

3 访问私有仓库——浏览器登录认证#

完成安装和配置后，GCM 会在 Git 需要认证时自动介入。

3.1 首次认证流程#

当你首次执行需要认证的 Git 操作（如 git clone 访问私有仓库、git push 等）时，GCM 会自动启动系统的默认浏览器，打开托管平台（如 GitHub）的授权页面。

例如，执行：

Terminal window

1
git clone https://github.com/your-username/private-repo.git

GCM 会弹出一个窗口，提示你使用浏览器登录。在浏览器中完成登录和授权后，凭证会被安全地存储在 GNOME Keyring 中，后续操作将自动使用已存储的凭证，无需再次输入。

3.2 查看已存储的凭证#

Ubuntu 用户可以通过 Seahorse（“密码与密钥”应用）查看 GCM 存储的凭证：

打开 Seahorse 应用（在应用菜单中搜索“密码与密钥”或 seahorse）
在左侧面板中找到“Login”密钥环
查找类似 git:https://github.com/ 的条目

3.3 更新或删除凭证#

如果需要更新凭证（例如更换了 GitHub 密码或 Personal Access Token），可以通过 Seahorse 删除旧凭证，然后在下一次 Git 操作时重新通过浏览器认证即可：

打开 Seahorse
在“登录”密钥环中找到对应的 Git 凭证条目
右键删除
下次执行 git push 或 git clone 时，GCM 会再次打开浏览器进行认证

Ubuntu 安装 nVidia 相关

2026-07-13T00:00:00.000Z

参考：CUDA Toolkit Downloads、ubuntu下cuda-keyring_1.1-1_all.deb包作用

1 安装 CUDA 与显卡驱动#

1.1 关闭系统自带驱动 nouveau#

先通过命令lsmod | grep nouveau查看 nouveau 驱动的启用情况，若无输出则表示已经禁用。

要禁用 nouveau 驱动，编辑/etc/modprobe.d/blacklist.conf文件，在末尾加上这两行并保存：

1
blacklist nouveau
2
options nouveau modeset=0

随后在终端中：

Terminal window

1
sudo update-initramfs -u

然后重启即可。

1.2 添加 NVIDIA 存储库#

Terminal window

1
wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2004/x86_64/cuda-keyring_1.1-1_all.deb
2
sudo dpkg -i cuda-keyring_1.1-1_all.deb
3
sudo apt-get update

2 安装显卡驱动#

Terminal window

1
sudo apt-get install -y nvidia-open # 会安装最新版本的显卡驱动
2
# 或者指定版本
3
# sudo apt-get install -y nvidia-open-580

Tip

Ubuntu 22.04 系统安装时可能会编译报错，是由于不支持系统默认安装的 GCC 11 版本，手动安装 GCC 12 即可。

Terminal window

1
sudo apt install gcc-12

安装完成后，运行nvidia-smi即可检查是否安装成功。

对于大部分情况，安装好显卡驱动即可，不需执行后续操作。

3 安装 CUDA Toolkit#

安装好显卡驱动后，即已经完成 CUDA 相关运行时的安装。

最新版本的 CUDA Toolkit 可以参考 CUDA Toolkit Downloads，对于 Ubuntu 20.04 最高支持到 CUDA 12.9，因此参考CUDA Toolkit 12.9 Downloads。在前面已经添加好存储库后直接运行：

Terminal window

1
sudo apt-get -y install cuda-toolkit-13-3

随后编辑~/.bashrc配置环境变量。

Terminal window

1
export CUDA_HOME=/usr/local/cuda
2
export PATH=$PATH:$CUDA_HOME/bin
3
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$CUDA_HOME/lib64
4
export LIBRARY_PATH=$LIBRARY_PATH:$CUDA_HOME/lib64

重启终端后运行nvcc -V查看安装信息。

4 安装 cuDNN#

最新版本的 cuDNN 可以参考 cuDNN Downloads，对于 Ubuntu 20.04 最高支持到 cuDNN 9.10.2，因此参考 cuDNN 9.10.2 Downloads。在前面已经添加好存储库后直接运行：

Terminal window

1
# 对于 CUDA 12，执行
2
sudo apt-get -y install cudnn-cuda-12
3
# 对于 CUDA 13，执行
4
sudo apt-get -y install cudnn-cuda-13

OpenCode 以及第三方桌面应用 OpenChamber 的安装与使用

2026-06-15T00:00:00.000Z

1 安装#

Tip

Windows 安装直接跳到 Windows 安装 Node 即可。

1.1 安装脚本#

对于 Linux 和 macOS 系统，可以使用安装脚本直接安装。

Terminal window

1
curl -fsSL https://opencode.ai/install | bash

如果网络下载速度过慢或失败，以及 Windows 用户，可以使用 NPM 安装。

1.2 使用 NPM 安装#

首先确保安装有 Node 环境，参考下载 Node.js。

1.2.1 Linux 安装 Node#

对于 Ubuntu，可以使用以下命令安装：

Terminal window

1
# 下载并安装 nvm（此处使用了 gh-proxy 加速）：
2
curl -o- https://gh-proxy.org/https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
3

4
\. "$HOME/.nvm/nvm.sh"
5

6
# 使用 nvm 下载并安装最新 LTS 版本的 Node.js：
7
nvm install --lts
8

9
# 验证 Node.js 版本：
10
node -v # Should print "v24.16.0".
11

12
# 验证 npm 版本：
13
npm -v # Should print "11.13.0".

1.2.2 Windows 安装 Node#

对于 Windows，在下载 Node.js页面下方找到“或者获得适用于 Windows x64 平台的 Node.js 构建”，点击下载 Windows 安装程序 (.msi) 安装即可。

1.2.3 安装 OpenCode#

Node.js 安装完成后（自带 npm），在终端中执行：

Terminal window

1
npm install -g opencode-ai

安装完成后，在任意终端输入 opencode 命令即可启动 TUI 界面的 OpenCode，同时会将当前所在文件夹作为工作目录。

1.3 添加供应商#

启动 OpenCode 后，按下 Ctrl+P 可以打开命令菜单，在其中找到 Connect provider，输入供应商名称（如 DeepSeek）即可搜索，选中后输入对应的 API Key 即可。

OpenCode 官方也提供了名为 OpenCode Zen 和 OpenCode Go 的大模型服务，并提供部分免费额度，可参考OpenCode Zen 定价。注册账号后将 API Key 添加到 OpenCode 中即可使用。

2 桌面应用#

OpenCode 官方提供了桌面应用，但目前功能较少，不推荐使用。推荐使用第三方的 OpenChamber。

对于 macOS 和 Windows，可以直接下载其桌面应用。

对于 Linux，则需要安装 NPM 包后，在浏览器中以网页形式使用。

首先使用 NPM 安装 OpenChamber：

Terminal window

1
npm i -g @openchamber/web

安装完成后，在终端中运行 openchamber，随后打开其输出的地址（通常为 http://127.0.0.1:3000/）即可进入 OpenChamber 的主界面。

命令行启动 openchamber

进入主界面后，可以在设置中将语言切换为中文。

openchamber 主界面

使用 GCMP 在 VS Code Copilot 中接入 DeepSeek API

2026-06-11T00:00:00.000Z

GitHub Copilot 学生套餐一改再改，现如今删除了大部分强大的模型不说，一个月还只有相当于 2 美元的额度，基本已经属于不可用的程度了。现在也有越来越多的独立于编辑器的编码智能体，如 Codex、OpenCode 等，但是依旧可以利用插件，继续在 VSCode 里以习惯的方式使用其他供应商提供的模型（如 DeepSeek）。

1 GCMP 是什么#

GCMP（GitHub Copilot Model Providers）是一个 VS Code 扩展，为 GitHub Copilot Chat 提供国产大模型支持。它内置了 DeepSeek、智谱 AI、MiniMax、MoonshotAI、阿里云百炼等主流国产模型，MIT 开源协议，免费使用。

开源仓库：https://github.com/VicBilibily/GCMP
扩展 ID：vicanent.gcmp

2 注册 DeepSeek 并获取 API Key#

前往 DeepSeek 平台注册账号，在 API Keys 页面创建密钥并充值。

3 安装 GCMP#

在 VS Code 扩展市场中搜索 GCMP 或直接输入扩展 ID vicanent.gcmp 安装即可。

image

4 配置 DeepSeek 模型#

安装完成后按以下步骤操作：

打开 VS Code 的 GitHub Copilot Chat 面板
点击聊天输入框下方的模型选择器
在底部齿轮选择管理语言模型
点击右上角的添加模型，在弹出的提供商列表中选中 GCMP · DeepSeek
首次选择会提示输入 API Key，粘贴上一步获取的密钥
返回模型选择器，勾选 DeepSeek-V4-Flash 或 DeepSeek-V4-Pro 启用

image

5 开始使用#

在 Copilot Chat 模型选择器中选中已启用的 DeepSeek 模型，即可像使用原版 Copilot 一样进行对话。状态栏会显示当前账户余额，方便随时查看。

cargo install 的一些杂项

2026-05-17T00:00:00.000Z

cargo install 用于从 crates.io 或指定的 Git 仓库下载 Rust crate 的源代码，并在本地编译后将其二进制文件安装到 ~/.cargo/bin 目录中。

安装一个工具：
Terminal window
```
1
cargo install ripgrep
```
安装特定版本：
Terminal window
```
1
cargo install ripgrep@13.0.0
```

从 Git 仓库安装：

Terminal window

1
cargo install --git https://github.com/BurntSushi/ripgrep

列出已安装的包：
Terminal window
```
1
cargo install --list
```
卸载一个工具：
Terminal window
```
1
cargo uninstall ripgrep
```

注意：cargo install 默认会将二进制文件输出到 ~/.cargo/bin，请确保该目录已添加到系统的 PATH 环境变量中。

1 `--locked` 参数#

cargo install 在默认情况下不会使用 crate 源码中可能自带的 Cargo.lock 文件，而是根据 Cargo.toml 中的依赖范围重新计算并取满足条件的最新依赖版本。这样做在某些情况下可能引入不兼容的改动，导致编译失败或运行时异常。

添加 --locked 参数可以改变这一行为：

Terminal window

1
cargo install --locked ripgrep

其效果如下：

强制要求源码目录中存在 Cargo.lock 文件（若缺失，Cargo 会报错退出）。
严格遵守 Cargo.lock 中记录的每个依赖的具体版本，不再重新解析。

这带来两点好处：

可重现的安装：安装结果与 crate 作者在开发及发布时所用的依赖环境完全一致。
更高的稳定性：避免因某个依赖的小幅更新（即使语义上兼容）意外破坏工具功能。

建议在安装绝大多数成熟的命令行工具（如 ripgrep、fd、bat）时都加上 --locked。

2 使用 cargo-binstall 直接安装二进制文件#

cargo-binstall 是一个旨在替代 cargo install 的第三方工具。它通过下载预编译的二进制文件来代替本地编译，从而极大缩短安装时间。

2.1 为什么使用它？#

特性	`cargo binstall`	`cargo install`
安装方式	下载预编译二进制	下载源码并本地编译
速度	几秒内完成（尤其适合大型项目）	耗时较长，需要 Rust 工具链
依赖要求	不需要本地编译工具链	必须安装 Rust 工具链

2.2 如何使用#

首先，通过 cargo install 安装 cargo-binstall 自身（这一步仍需编译，但只需一次）：

Terminal window

1
cargo install cargo-binstall --locked

之后，即可使用 cargo binstall 安装其他工具：

Terminal window

1
cargo binstall ripgrep        # 快速安装，自动获取预编译版本
2
cargo binstall tokei@12.1.0   # 指定版本

如果 cargo-binstall 找不到预编译的二进制文件，它会自动回退到源码编译（即执行 cargo install），从而保证安装成功率。

2.3 工作原理#

cargo binstall 按以下顺序尝试获取二进制：

GitHub Releases：检查 crate 的 GitHub Release 页面是否附带了与当前平台匹配的预编译二进制。
cargo-quickinstall：查询 cargo-quickinstall 提供的预编译包仓库。
回退到源码安装：如果以上都失败，则执行 cargo install。

cargo-binstall 为 CI 环境、资源受限设备或追求效率的开发者提供了非常友好的体验。

3 使用 cargo-update 更新#

cargo install 本身不提供内置的更新命令。当你需要将已安装的工具升级到最新版本时，可以使用第三方工具 cargo-update。

3.1 安装 cargo-update#

Terminal window

1
cargo install cargo-update

3.2 更新所有已安装的包#

Terminal window

1
cargo install-update -a

-a 表示“全部”。该命令会检查每个通过 cargo install 安装的包，若发现新版本则自动升级。

3.3 更新特定包#

Terminal window

1
cargo install-update ripgrep fd-find

3.4 注意事项#

cargo-update 会跳过那些不是通过 cargo install 安装的程序（例如系统包管理器安装的）。
cargo-update 自身也可以自我更新：再次运行 cargo install cargo-update 或执行 cargo install-update cargo-update。

3.5 与 cargo binstall 的协作#

安装/重装：优先使用 cargo binstall 达到快速部署。
更新：仍然使用 cargo install-update，因为它会智能地处理版本检查，无论当初是通过 cargo install 还是 cargo binstall 安装的，都能正确升级（前提是后续更新时依然能获取到二进制或源码）。

常用的 colcon build 参数

2026-05-17T00:00:00.000Z

colcon build 是 ROS 2 中用来构建工作空间的核心命令。下面按用途分类，介绍最常用的一些参数。

1 安装方式#

--symlink-install
使用符号链接安装文件，而不是复制。当你修改了 Python 脚本、配置文件或 launch 文件时，无需重新构建就能直接生效（对 Python 包、配置文件、launch 文件这类“改动频繁”的内容特别方便，但 C++ 代码仍需重新编译）。开发调试时常用。
--merge-install
将所有包安装到同一个 install/ 目录下（类似 ROS 1 的结构），而不是默认的 install/。某些场景下可以简化环境变量设置，不过通常推荐独立安装方式。

2 包选择#

--packages-select
只构建指定的几个包，不处理其他包。
--packages-up-to
构建指定包以及它的所有递归依赖包。适合你只关心某个包和它依赖的包链。
--packages-above
构建所有直接或间接依赖于指定包的包（反向依赖）。用于检查改动影响哪些下游包。
--packages-skip
跳过指定包不构建，但其他包仍正常构建。

3 构建过程控制#

--continue-on-error
即便某个包构建失败，也继续构建其他包，便于一次性发现问题包。
--executor sequential
强制顺序构建（默认会并行构建），方便调试依赖问题或排查编译顺序。
--parallel-workers N
限制并行构建的任务数，避免资源紧张，例如 --parallel-workers 4。
--cmake-args
将参数直接传递给 CMake，如：
--cmake-args -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS="-O2"
--ament-cmake-args
将参数传递给 ament_cmake 构建系统（ROS 2 专用），用法同上。
--cmake-clean-cache
删除之前的 CMake 缓存，重新从头配置，相当于强制 clean 配置。
--cmake-force-configure
即使缓存存在，也强制重新运行 CMake 配置步骤。
--allow-overriding
改变某个包的构建类型（例如把一个原本用 ament_cmake 的包强制当成纯 cmake 包来构建），在混用不同构建系统时有用。

4 输出与事件处理#

--event-handlers
控制终端输出和通知行为。常用值：
- console_direct+：直接在终端实时打印所有包的编译输出（不缓冲）。
- console_cohesion+：每个包输出聚合显示（默认之一）。
- desktop_notification-：关闭桌面通知（构建完成/失败的通知）。
  示例：--event-handlers console_direct+

5 测试相关#

--build-tests
在构建过程中同时编译测试代码，后续才能运行 colcon test。
也可以直接用 CMake 参数开启：--cmake-args -DBUILD_TESTING=ON。

6 工作空间路径#

--build-base
指定构建中间文件存放目录，默认为工作空间下的 build/。
--install-base
指定最终安装文件的存放目录，默认为 install/。
--paths
指定包含 ROS 包的源代码目录，默认为 src/，如果你的包放在别处可以用它指定。

7 其他#

--metas
使用一个元信息文件（meta file）来统一覆盖某些包的编译选项，适合复杂的混合工作空间。

8 常见场景示例#

日常开发最常用
colcon build --symlink-install --packages-select my_package
重新全量构建（清除缓存）
colcon build --cmake-clean-cache --cmake-force-configure
只构建某个包及其依赖，并实时查看输出
colcon build --packages-up-to my_package --event-handlers console_direct+
以 Release 模式编译
colcon build --cmake-args -DCMAKE_BUILD_TYPE=Release

掌握这些参数基本就能覆盖绝大部分开发和集成场景了。

Git Submodule 命令

2026-05-17T00:00:00.000Z

git submodule 是用于在一个仓库中嵌套管理另一个独立 Git 仓库的工具。主仓库仅记录子模块所处的具体提交（commit），而不直接追踪子模块中的文件内容。

1 常用命令#

1.1 添加子模块#

Terminal window

1
git submodule add <仓库URL> <本地路径>

执行后会生成 .gitmodules 文件，并记录子模块当前所在的 commit。

1.2 克隆含有子模块的仓库#

一步到位克隆：

Terminal window

1
git clone --recurse-submodules <主仓库URL>

已克隆但子模块为空时，手动初始化并更新：
Terminal window
```
1
git submodule update --init --recursive
```

此处的 --init 参数相当于先执行 init 子命令后再执行 update 子命令，git submodule init 会根据 .gitmodules 文件的信息初始化本地 Git 配置（.git/config）。

1.3 更新子模块#

将子模块更新到远程仓库的最新提交：
Terminal window
```
1
git submodule update --remote
```
更新后，主仓库中记录的子模块指针会变化，需要手动提交：
Terminal window
```
1
git add <子模块路径>
2
git commit -m "更新子模块到最新版本"
```

1.4 查看子模块状态#

Terminal window

1
git submodule status

输出中前缀含义：

- 表示未初始化
+ 表示当前检出的提交与主仓库记录的提交不一致

1.5 删除子模块#

Terminal window

1
git submodule deinit <路径>
2
git rm <路径>
3
rm -rf .git/modules/<路径>

最后提交删除操作。

1.6 同步子模块 URL#

sync 子命令用于将 .gitmodules 文件中定义的远程 URL 同步到本地 Git 配置（.git/config）中。

1.6.1 何时需要#

当子模块的远程仓库地址发生变更（例如迁移到新服务器）时，仅修改 .gitmodules 是不够的。本地的 .git/config 仍保留旧地址，导致 git submodule update 等命令访问错误。此时需运行 sync 使本地配置与 .gitmodules 一致。

1.6.2 典型场景#

子模块远程库从 github.com/old/repo 迁至 gitlab.com/new/repo。
更新 .gitmodules 中的 URL 并提交。
其他成员拉取主仓库后，执行 git submodule sync，否则更新时会尝试从旧地址拉取而失败。

1.6.3 用法#

Terminal window

1
# 同步所有子模块
2
git submodule sync
3

4
# 同步指定子模块
5
git submodule sync <子模块路径>
6

7
# 递归同步（子模块嵌套时）
8
git submodule sync --recursive

2 子模块在仓库中的配置文件#

2.1 `.gitmodules`：版本控制的配置文件#

位于主仓库根目录，采用 INI 格式，记录了子模块的逻辑路径和远程 URL。该文件随主仓库一起版本控制，他人克隆后可见。

1
[submodule "libs/mylib"]
2
    path = libs/mylib
3
    url = https://github.com/example/lib.git
4
[submodule "vendor/other"]
5
    path = vendor/other
6
    url = git@gitlab.com:team/other.git
7
    branch = develop

path：子模块在主仓库中的相对路径。
url：子模块的远程仓库地址。
可选字段如 branch，指定 git submodule update --remote 时跟踪的分支（不写则默认跟踪主仓库记录的 commit）。

2.2 `.git/config`：本地仓库配置（不版本控制）#

执行 git submodule init 后，.gitmodules 中的配置会被复制到 .git/config 中，形成类似结构：

1
[submodule "libs/mylib"]
2
    url = https://github.com/example/lib.git
3
    active = true

后续 git submodule update 等命令实际读取的是此处的 url。
若 .gitmodules 中的 URL 变化，需手动执行 git submodule sync 来同步此处。
该文件仅在本地存在，不会被提交，每个人的副本独立。

2.3 主仓库的树对象：子模块指针的存储#

子模块本质上是一个类型为 commit 的 Git 对象，它在主仓库每一次提交的树对象中表现为一个特殊条目：

模式：160000（普通文件是 100644，目录是 040000）。
名称：子模块的目录名。
哈希：指向子模块仓库中某一个具体 commit 的 SHA-1 值。

用底层命令可查看到类似：

Terminal window

1
$ git ls-tree HEAD libs/mylib
2
160000 commit 1a2b3c4d...  libs/mylib

这个 commit SHA 决定了子模块检出到哪个版本。当你在主仓库中 git add libs/mylib 并提交时，实际上就是更新了这个哈希值。

2.4 `.git/modules/<路径>`：子模块实际的 Git 数据#

子模块本身的仓库（对象库、引用等）存储在主仓库的 .git/modules/<子模块路径> 目录下（旧版本 Git 直接存放在子模块目录内的 .git 文件中）。
这个目录对用户一般是透明的，但它是子模块能独立进行 Git 操作的基础。

3 一些操作#

3.1 将子文件夹独立为子模块#

假设原仓库结构：

1
my-project/
2
├── .git/
3
├── target-folder/       ← 想独立为子模块的文件夹
4
│   ├── a.txt
5
│   └── b.js
6
└── other-stuff/

最终：target-folder 变成一个独立的 Git 仓库，并在原仓库中作为子模块引用，且所有历史提交（仅针对 target-folder/ 的修改）都保留在新仓库里。

3.1.1 保留子文件夹提交历史#

提取文件夹的历史到一个新分支

进入原仓库根目录，运行：
Terminal window
```
1
git subtree split --prefix=target-folder --branch=subrepo-branch
```
这会创建一个名为 subrepo-branch 的新分支，其中只包含 target-folder/ 的历史记录（就像这个文件夹一直是独立仓库一样）。

创建一个新的 Git 仓库并推送

Terminal window

1
# 创建临时目录并初始化新仓库
2
mkdir /tmp/new-subrepo
3
cd /tmp/new-subrepo
4
git init
5

6
# 拉取刚才 split 出来的历史
7
git pull /path/to/my-project subrepo-branch
8

9
# 添加远程仓库（例如 GitHub 上新创建的空仓库）
10
git remote add origin <新仓库的远程地址>
11
git push -u origin master

回到原仓库，删除原文件夹并添加子模块

Terminal window

1
cd /path/to/my-project
2

3
# 删除原文件夹（注意先确保新仓库已推送完成）
4
git rm -rf target-folder
5
git commit -m "Remove target-folder to replace with submodule"
6

7
# 添加子模块，使用新仓库的地址
8
git submodule add <新仓库的远程地址> target-folder
9

10
# 提交子模块配置
11
git commit -m "Add target-folder as submodule"

清理临时分支
Terminal window
```
1
git branch -D subrepo-branch
```

3.1.2 不保留子文件夹提交历史#

如果你不需要保留 target-folder 在原仓库中的提交历史，可以直接：

把 target-folder 的内容复制到一个全新的 Git 仓库并推送。
在原仓库中删除 target-folder（git rm -rf target-folder）。
git submodule add <新仓库地址> target-folder。
提交。

历史会丢失（新仓库只有一次初始提交），但操作更快。

使用 pnpm 管理 node 运行环境

2026-05-17T00:00:00.000Z

参考安装 | pnpm、pnpm runtime | pnpm

在 pnpm v6 开始可以使用 pnpm env 命令管理 Node 环境，类似于 nvm 等工具，而在 v11 开始变为 pnpm runtime 命令。因此，可以使用独立脚本在不安装 Node 的情况下直接安装 pnpm，然后来管理计算机上的 Node 环境。

1 基本用法#

使用 pnpm runtime set 命令可以方便地安装各种版本：

Terminal window

1
pnpm runtime set   [-g]

支持的运行时包括：

node - Node.js
deno - Deno
bun - Bun

例如：

Terminal window

1
# 安装最新的 Node.js v22 长期支持（LTS）版本
2
pnpm runtime set node lts -g
3

4
# 安装最新版本
5
pnpm runtime set node latest -g
6

7
# 安装指定版本号
8
pnpm runtime set node 22.11.0 -g
9

10
# 安装预发布版 (Release Candidate)
11
pnpm runtime set node rc -g
12

13
# 通过代号安装，例如 Node.js 4.x 的代号 'argon'
14
pnpm runtime set node argon -g

重要提示：自 v11 起，通过 pnpm runtime 安装的 Node.js 将不再包含捆绑的 npm、npx 和 corepack。这可以显著减少安装时的文件数量、提升速度。如果需要，你仍然可以通过 pnpm add -g npm 来单独安装 npm。

2 项目级配置：`devEngines.runtime`#

为了让团队使用统一的 Node.js 版本，可以将运行时要求写入项目的 package.json 文件中。这比在命令行手动切换更可靠。

在 package.json 中添加 devEngines.runtime 字段。例如，声明你的项目需要 Node.js v24.4.0 或更高版本：

1
{
2
  "devEngines": {
3
    "runtime": {
4
      "name": "node",
5
      "version": "^24.4.0",
6
      "onFail": "download"
7
    }
8
  }
9
}

这里的配置项含义如下：

name："node"，表示声明的是 Node.js 运行时。也支持 "deno" 或 "bun"。
version："^24.4.0"，一个 semver 版本范围。pnpm install 时会自动解析并安装符合该范围的最新版本，并将确切版本锁定在 pnpm-lock.yaml 中。
onFail："download"，定义了当本地环境不满足版本要求时的行为。可选值有 "download"（自动下载）、"warn"（仅警告）、"error"（报错）或 "ignore"（忽略）。

配置后，只需运行 pnpm install，pnpm 就会根据配置自动处理 Node.js 的安装和校验。

Neovim 配置

2026-05-17T00:00:00.000Z

使用 Vim 的分支 Neovim，与 Vim 不同，Neovim 的用户配置文件位于 $XDG_CONFIG_HOME/nvim/（默认是 ~/.config/nvim/），全局配置文件（默认不存在）位于 $XDG_CONFIG_DIRS/nvim/sysinit.vim（默认是 /etc/xdg/nvim/sysinit.vim），如果不存在，则会载入 /usr/share/nvim/sysinit.vim，后者不建议由用户编辑。同时，Neovim 的配置文件支持 Lua 语法。

Windows 下配置文件位于 C:\Users\Bill\AppData\Local\nvim\init.vim。

1 将 vim 链接到 nvim#

在 Arch Linux 下，可以使用包 AUR (zh_CN) - neovim-symlinks 来办到。

在 Linux 下，使用软链接：

Terminal window

1
mkdir -p ~/.local/bin  # 创建用户级别的 bin 目录
2
ln -s $(which nvim) ~/.local/bin/vim  # 建立软链接

随后将自定义目录添加到 PATH 开头，在 ~/.bashrc（或 ~/.zshrc）中添加：

Terminal window

1
export PATH="$HOME/.local/bin:$PATH"

在 Powershell 中，使用别名：

单次配置：

Terminal window

1
Set-Alias -Name vim -Value nvim

使用 echo $PROFILE 命令找到配置文件位置，随后在对应的目录下建立对应的配置文件，并在其中写入：

Terminal window

1
function vim {nvim}

2 配置文件及插件管理器#

使用插件管理器 folke/lazy.nvim，通过直接编辑 Neovim 的配置文件即可引入。同时，有一个名为 LazyVim/LazyVim 的项目，提供了开箱即用的配置模板，功能强大，但是对于我而言不需要这么多功能，所以只选择了部分插件。Lazy nvim 直接通过编辑配置文件的方式引入，整个配置文件夹结构为：

Terminal window

1
nvim
2
├── init.lua
3
├── lazy-lock.json
4
└── lua
5
    ├── config
6
    │   └── lazy.lua
7
    └── plugins
8
        └── spec1.lua

具体的配置文件，可以参考我的 dotfile 仓库：dotfiles/dotfiles/nvim at master · CMBill/dotfiles

要安装 Lazy nvim，首先在 ~/.config/nvim/init.lua 文件中引入：

1
require("config.lazy")

随后在配置文件夹下新建 lua/config 文件夹，在 ~/.config/nvim/lua/config/lazy.lua 中填写 lazy.nvim 启动文件：

1
-- Bootstrap lazy.nvim
2
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
3
if not (vim.uv or vim.loop).fs_stat(lazypath) then
4
  local lazyrepo = "https://github.com/folke/lazy.nvim.git"
5
  local out = vim.fn.system({ "git", "clone", "--filter=blob:none", "--branch=stable", lazyrepo, lazypath })
6
  if vim.v.shell_error ~= 0 then
7
    vim.api.nvim_echo({
8
      { "Failed to clone lazy.nvim:\n", "ErrorMsg" },
9
      { out, "WarningMsg" },
10
      { "\nPress any key to exit..." },
11
    }, true, {})
12
    vim.fn.getchar()
13
    os.exit(1)
14
  end
15
end
16
vim.opt.rtp:prepend(lazypath)
17

18
-- Make sure to setup `mapleader` and `maplocalleader` before
19
-- loading lazy.nvim so that mappings are correct.
20
-- This is also a good place to setup other settings (vim.opt)
21
vim.g.mapleader = " "
22
vim.g.maplocalleader = "\\"
23

24
-- Setup lazy.nvim
25
require("lazy").setup({
26
  spec = {
27
    -- import your plugins
28
    { import = "plugins" },
29
  },
30
  -- Configure any other settings here. See the documentation for more details.
31
  -- colorscheme that will be used when installing plugins.
32
  install = { colorscheme = { "habamax" } },
33
  -- automatically check for plugin updates
34
  checker = { enabled = true },
35
})

展开收起

要安装、配置插件，则在 lua 文件夹里新建 plugin 文件夹，在其中的 lua 文件会被识别为插件配置。这里是我的插件配置：

主题：catppuccin
配置首先加载了 catppuccin/nvim，并设置为高优先级（1000），确保界面尽早渲染。配色选用柔和的 mocha 风格，加载后直接应用，为整个编辑器定下温暖、护眼的基调。
功能中心：snacks.nvim
folke/snacks.nvim 是本配置的核心，它集成了十几项日常高频功能，且默认全部开启：大文件优化、仪表盘、文件浏览器、图片预览、缩进线、输入增强、通知系统、智能选择器、快速文件跳转、作用域高亮、平滑滚动、状态列和单词跳转等。通知超时设为 3 秒。

快捷键设计非常有条理，几乎覆盖所有场景：
- 查找与导航：ff 查找文件，fg 查找 Git 文件，/ 全文搜索，fb 切换缓冲区，fp 查找项目，fr 最近文件。
- Git 操作：直接使用 gs/gl/gd 等组合查看状态、日志、差异、暂存等，gg 打开 Lazygit，gB 在浏览器中打开远程仓库。
- LSP 集成：gd 跳转定义，gr 查看引用，gy 类型定义，ss 工作区符号等，完全取代原生 LSP 浮窗，界面更统一。
- 实用工具：e 打开文件浏览器，z 进入禅模式，. 打开草稿缓冲区，切换终端，bd 删除缓冲区，cR 重命名文件。
init 函数中还准备了调试辅助（dd、bt）和一系列 toggle 映射，比如 us 切换拼写检查、ul 切换行号、ud 切换诊断显示等，一键控制编辑器状态，非常方便。
按键提示：which-key.nvim
配置了 folke/which-key.nvim，采用 helix 风格预设，在按下后自动弹出可用的快捷键菜单。额外添加了 ? 手动显示当前缓冲区专属快捷键，帮助记忆不常用的组合键。
状态栏：lualine.nvim
nvim-lualine/lualine.nvim 在 VeryLazy 时加载，直接使用 catppuccin-mocha 主题，使状态栏与整体配色完美融合，无需额外调校。
图标与配对：mini.nvim 生态
选取了两个轻量的 mini 插件：mini.icons 为各类文件类型提供图标支持，按需延迟加载；mini.pairs 在进入插入模式时自动配对括号、引号等，保持编辑体验流畅。
Git 装饰：gitsigns.nvim
lewis6991/gitsigns.nvim 在打开文件时即生效，用自定义符号（如 ┃ 表示新增或修改，_ 表示删除）在左侧符号列标示变更状态，且区分暂存与未暂存的符号。配置还启用了当前行 blame 预览（行尾显示作者和时间），延迟 1 秒出现，同时限制超长文件禁用，兼顾性能与信息展示。

1
return {
2
    {
3
        "catppuccin/nvim",
4
        name = "catppuccin",
5
        priority = 1000,
6
        config = function()
7
            require("catppuccin").setup({
8
                flavour = "mocha",
9
            })
10
            vim.cmd.colorscheme "catppuccin"
11
        end
12
    },
13
    {
14
        "folke/snacks.nvim",
15
        priority = 1000,
16
        lazy = false,
17
        ---@type snacks.Config
18
        opts = {
19
            bigfile = { enabled = true },
20
            dashboard = { enabled = true },
21
            explorer = { enabled = true },
22
            image = { enabled = true },
23
            indent = { enabled = true },
24
            input = { enabled = true },
25
            notifier = {
26
                enabled = true,
27
                timeout = 3000,
28
            },
29
            picker = { enabled = true },
30
            quickfile = { enabled = true },
31
            scope = { enabled = true },
32
            scroll = { enabled = true },
33
            statuscolumn = { enabled = true },
34
            words = { enabled = true },
35
            styles = {
36
                notification = {
37
                    -- wo = { wrap = true } -- Wrap notifications
38
                }
39
            }
40
        },
41
        keys = {
42
            -- Top Pickers & Explorer
43
            { "", function() Snacks.picker.smart() end, desc = "智能查找文件" },
44
            { ",", function() Snacks.picker.buffers() end, desc = "缓冲区" },
45
            { "/", function() Snacks.picker.grep() end, desc = "全文搜索" },
46
            { ":", function() Snacks.picker.command_history() end, desc = "命令历史" },
47
            { "n", function() Snacks.picker.notifications() end, desc = "通知历史" },
48
            { "e", function() Snacks.explorer() end, desc = "文件浏览器" },
49
            -- find
50
            { "fb", function() Snacks.picker.buffers() end, desc = "缓冲区" },
51
            { "fc", function() Snacks.picker.files({ cwd = vim.fn.stdpath("config") }) end, desc = "查找配置文件" },
52
            { "ff", function() Snacks.picker.files() end, desc = "查找文件" },
53
            { "fg", function() Snacks.picker.git_files() end, desc = "查找 Git 文件" },
54
            { "fp", function() Snacks.picker.projects() end, desc = "项目" },
55
            { "fr", function() Snacks.picker.recent() end, desc = "最近" },
56
            -- git
57
            { "gb", function() Snacks.picker.git_branches() end, desc = "Git Branches" },
58
            { "gl", function() Snacks.picker.git_log() end, desc = "Git Log" },
59
            { "gL", function() Snacks.picker.git_log_line() end, desc = "Git Log Line" },
60
            { "gs", function() Snacks.picker.git_status() end, desc = "Git Status" },
61
            { "gS", function() Snacks.picker.git_stash() end, desc = "Git Stash" },
62
            { "gd", function() Snacks.picker.git_diff() end, desc = "Git Diff (Hunks)" },
63
            { "gf", function() Snacks.picker.git_log_file() end, desc = "Git Log File" },
64
            -- gh
65
            { "gi", function() Snacks.picker.gh_issue() end, desc = "GitHub Issues (open)" },
66
            { "gI", function() Snacks.picker.gh_issue({ state = "all" }) end, desc = "GitHub Issues
67
(all)" },
68
            { "gp", function() Snacks.picker.gh_pr() end, desc = "GitHub Pull Requests (open)" },
69
            { "gP", function() Snacks.picker.gh_pr({ state = "all" }) end, desc = "GitHub Pull Requests (all)" },
70
            -- Grep
71
            { "sb", function() Snacks.picker.lines() end, desc = "当前缓冲区行" },
72
            { "sB", function() Snacks.picker.grep_buffers() end, desc = "搜索已打开缓冲区" },
73
            { "sg", function() Snacks.picker.grep() end, desc = "搜索文本" },
74
            { "sw", function() Snacks.picker.grep_word() end, desc = "选区或单词", mode = { "n", "x" } },
75
            -- search
76
            { 's"', function() Snacks.picker.registers() end, desc = "Registers" },
77
            { 's/', function() Snacks.picker.search_history() end, desc = "搜索历史" },
78
            { "sa", function() Snacks.picker.autocmds() end, desc = "自动命令" },
79
            { "sb", function() Snacks.picker.lines() end, desc = "当前缓冲区行" },
80
            { "sc", function() Snacks.picker.command_history() end, desc = "命令历史" },
81
            { "sC", function() Snacks.picker.commands() end, desc = "命令" },
82
            { "sd", function() Snacks.picker.diagnostics() end, desc = "诊断" },
83
            { "sD", function() Snacks.picker.diagnostics_buffer() end, desc = "缓冲区诊断" },
84
            { "sh", function() Snacks.picker.help() end, desc = "帮助页面" },
85
            { "sH", function() Snacks.picker.highlights() end, desc = "高亮组" },
86
            { "si", function() Snacks.picker.icons() end, desc = "图标" },
87
            { "sj", function() Snacks.picker.jumps() end, desc = "跳转列表" },
88
            { "sk", function() Snacks.picker.keymaps() end, desc = "按键映射" },
89
            { "sl", function() Snacks.picker.loclist() end, desc = "位置列表" },
90
            { "sm", function() Snacks.picker.marks() end, desc = "标记" },
91
            { "sM", function() Snacks.picker.man() end, desc = "手册" },
92
            { "sp", function() Snacks.picker.lazy() end, desc = "搜索插件配置" },
93
            { "sq", function() Snacks.picker.qflist() end, desc = "快速修复列表" },
94
            { "sR", function() Snacks.picker.resume() end, desc = "恢复" },
95
            { "su", function() Snacks.picker.undo() end, desc = "撤销历史" },
96
            { "uC", function() Snacks.picker.colorschemes() end, desc = "配色方案" },
97
            -- LSP
98
            { "gd", function() Snacks.picker.lsp_definitions() end, desc = "转到定义" },
99
            { "gD", function() Snacks.picker.lsp_declarations() end, desc = "转到声明" },
100
            { "gr", function() Snacks.picker.lsp_references() end, nowait = true, desc = "引用" },
101
            { "gI", function() Snacks.picker.lsp_implementations() end, desc = "转到实现" },
102
            { "gy", function() Snacks.picker.lsp_type_definitions() end, desc = "转到类型定义" },
103
            { "gai", function() Snacks.picker.lsp_incoming_calls() end, desc = "传入调用" },
104
            { "gao", function() Snacks.picker.lsp_outgoing_calls() end, desc = "传出调用" },
105
            { "ss", function() Snacks.picker.lsp_symbols() end, desc = "LSP 符号" },
106
            { "sS", function() Snacks.picker.lsp_workspace_symbols() end, desc = "LSP Workspace 符号" },
107
            -- Other
108
            { "z", function() Snacks.zen() end, desc = "切换 Zen Mode" },
109
            { "Z", function() Snacks.zen.zoom() end, desc = "切换放大模式" },
110
            { ".", function() Snacks.scratch() end, desc = "切换临时缓冲区" },
111
            { "S", function() Snacks.scratch.select() end, desc = "选择临时缓冲区" },
112
            { "n", function() Snacks.notifier.show_history() end, desc = "通知历史" },
113
            { "bd", function() Snacks.bufdelete() end, desc = "删除缓冲区" },
114
            { "cR", function() Snacks.rename.rename_file() end, desc = "重命名文件" },
115
            { "gB", function() Snacks.gitbrowse() end, desc = "Git 浏览", mode = { "n", "v" } },
116
            { "gg", function() Snacks.lazygit() end, desc = "Lazygit" },
117
            { "un", function() Snacks.notifier.hide() end, desc = "清除所有通知" },
118
            { "", function() Snacks.terminal() end, desc = "切换终端" },
119
            { "", function() Snacks.terminal() end, desc = "which_key_ignore" },
120
            { "]]", function() Snacks.words.jump(vim.v.count1) end, desc = "下一个引用", mode = { "n", "t" } },
121
            { "[[", function() Snacks.words.jump(-vim.v.count1) end, desc = "上一个引用", mode = { "n", "t"
122
} },
123
            {
124
                "N",
125
                desc = "Neovim News",
126
                function()
127
                    Snacks.win({
128
                        file = vim.api.nvim_get_runtime_file("doc/news.txt", false)[1],
129
                        width = 0.6,
130
                        height = 0.6,
131
                        wo = {
132
                            spell = false,
133
                            wrap = false,
134
                            signcolumn = "yes",
135
                            statuscolumn = " ",
136
                            conceallevel = 3,
137
                        },
138
                    })
139
                end,
140
            }
141
        },
142
        init = function()
143
            vim.api.nvim_create_autocmd("User", {
144
                pattern = "VeryLazy",
145
                callback = function()
146
                    -- Setup some globals for debugging (lazy-loaded)
147
                    _G.dd = function(...)
148
                        Snacks.debug.inspect(...)
149
                    end
150
                    _G.bt = function()
151
                        Snacks.debug.backtrace()
152
                    end
153

154
                    -- Override print to use snacks for `:=` command
155
                    if vim.fn.has("nvim-0.11") == 1 then
156
                        vim._print = function(_, ...)
157
                            dd(...)
158
                        end
159
                    else
160
                        vim.print = _G.dd
161
                    end
162

163
                    -- Create some toggle mappings
164
                    Snacks.toggle.option("spell", { name = "Spelling" }):map("us")
165
                    Snacks.toggle.option("wrap", { name = "Wrap" }):map("uw")
166
                    Snacks.toggle.option("relativenumber", { name = "Relative Number" }):map("uL")
167
                    Snacks.toggle.diagnostics():map("ud")
168
                    Snacks.toggle.line_number():map("ul")
169
                    Snacks.toggle.option("conceallevel",
170
                        { off = 0, on = vim.o.conceallevel > 0 and vim.o.conceallevel or 2 }):map("uc")
171
                    Snacks.toggle.treesitter():map("uT")
172
                    Snacks.toggle.option("background", { off = "light", on = "dark", name = "Dark Background" }):map(
173
                        "ub")
174
                    Snacks.toggle.inlay_hints():map("uh")
175
                    Snacks.toggle.indent():map("ug")
176
                    Snacks.toggle.dim():map("uD")
177
                end,
178
            })
179
        end,
180
    },
181
    {
182
        "folke/which-key.nvim",
183
        event = "VeryLazy",
184
        opts = {
185
            preset = "helix",
186
            spec = {},
187
        },
188
        keys = {
189
            {
190
                "?",
191
                function()
192
                    require("which-key").show({ global = false })
193
                end,
194
                desc = "当前缓冲区按键提示 (which-key)",
195
            },
196
        },
197
    },
198
    {
199
        'nvim-lualine/lualine.nvim',
200
        event = "VeryLazy",
201
        dependencies = { 'nvim-tree/nvim-web-devicons' },
202
        opts = {
203
            theme = 'catppuccin-mocha',
204
        }
205
    },
206
    {
207
        'nvim-mini/mini.icons',
208
        lazy = true,
209
        version = false
210
    },
211
    {
212
        'nvim-mini/mini.pairs',
213
        event = "InsertEnter",
214
        opts = {},
215
        version = false
216
    },
217
    {
218
        "lewis6991/gitsigns.nvim",
219
        event = { "BufReadPre", "BufNewFile" },
220
        opts = {
221
            signs                        = {
222
                add          = { text = '┃' },
223
                change       = { text = '┃' },
224
                delete       = { text = '_' },
225
                topdelete    = { text = '‾' },
226
                changedelete = { text = '~' },
227
                untracked    = { text = '┆' },
228
            },
229
            signs_staged                 = {
230
                add          = { text = '┃' },
231
                change       = { text = '┃' },
232
                delete       = { text = '_' },
233
                topdelete    = { text = '‾' },
234
                changedelete = { text = '~' },
235
                untracked    = { text = '┆' },
236
            },
237
            signs_staged_enable          = true,
238
            signcolumn                   = true, -- Toggle with `:Gitsigns toggle_signs`
239
            numhl                        = false, -- Toggle with `:Gitsigns toggle_numhl`
240
            linehl                       = false, -- Toggle with `:Gitsigns toggle_linehl`
241
            word_diff                    = false, -- Toggle with `:Gitsigns toggle_word_diff`
242
            watch_gitdir                 = {
243
                follow_files = true
244
            },
245
            auto_attach                  = true,
246
            attach_to_untracked          = false,
247
            current_line_blame           = false, -- Toggle with `:Gitsigns toggle_current_line_blame`
248
            current_line_blame_opts      = {
249
                virt_text = true,
250
                virt_text_pos = 'eol', -- 'eol' | 'overlay' | 'right_align'
251
                delay = 1000,
252
                ignore_whitespace = false,
253
                virt_text_priority = 100,
254
                use_focus = true,
255
            },
256
            current_line_blame_formatter = ',  - ',
257
            blame_formatter              = nil, -- Use default
258
            sign_priority                = 6,
259
            update_debounce              = 100,
260
            status_formatter             = nil, -- Use default
261
            max_file_length              = 40000, -- Disable if file is longer than this (in lines)
262
            preview_config               = {
263
                -- Options passed to nvim_open_win
264
                style = 'minimal',
265
                relative = 'cursor',
266
                row = 0,
267
                col = 1
268
            },
269
        }
270
    }
271

272
}

展开收起

使用 tree 命令输出文件夹结构

2026-05-17T00:00:00.000Z

与其他常见发行版不同，在 Arch Linux 上 tree 命令通常不是系统自带的。

1 安装与基本用法#

安装：在终端执行 sudo pacman -S tree。
基本语法：安装后，使用 tree [选项] [目录] 的格式即可输出目录树。
查看当前目录结构：直接输入 tree 并回车，会以树形结构清晰地展示当前目录下的所有文件和文件夹。
查看指定目录：你还可以指定路径，例如 tree /etc 来查看特定目录的结构。

2 常用选项详解#

tree 命令的强大之处在于它丰富的参数选项，可以灵活地控制输出内容。

选项	功能说明	使用示例
`-a`	显示所有文件，包括以点 `.` 开头的隐藏文件。	`tree -a`
`-d`	只显示目录，不显示文件，用于快速查看目录骨架。	`tree -d`
`-L`	限制目录的显示深度，比如 `-L 2` 只显示到第二级子目录，防止输出过多。	`tree -L 2`
`-P`	仅列出匹配指定模式的文件，支持通配符。	`tree -P "*.py"`
`-I`	排除匹配指定模式的文件或目录，多个模式用竖线 `\|` 分隔。	`tree -I "node_modules\|.git"`
`-h`	以人类可读的格式（如 KB、MB）显示文件大小。	`tree -h`
`-p`	显示每个文件的权限信息。	`tree -p`
`-f`	为每个文件或目录显示完整的路径前缀。	`tree -f`
`-D`	显示文件或目录的最后修改时间。	`tree -D`
`-o`	将输出结果导出到指定的文件中。	`tree -o structure.txt`
`--du`	显示每个目录的磁盘使用情况（以块为单位）。	`tree --du`

3 实用场景示例#

以下是一些针对特定场景的命令组合：

只显示项目目录结构，限制深度：tree -d -L 2，这会只显示目录，并且限制深度为 2 层。
排除干扰目录，显示完整结构：tree -I 'node_modules|.git|__pycache__'，这样可以忽略开发中常见的依赖或缓存文件夹。
查看指定目录，并显示文件大小：tree -h /home/user/Documents，这会在输出时以易读的格式显示文件大小。
导出目录结构：tree -L 3 -o my_project_structure.txt，这会将限制深度为 3 层的目录树输出到文件中。

4 注意事项#

谨慎处理大型目录：在根目录（/）或包含海量子目录（如 node_modules）的目录中运行 tree 时，务必用 -L 或 -I 限制范围，否则可能会因输出量巨大而卡顿。
处理中文乱码：tree 命令原生支持 UTF-8。如果出现乱码，通常是终端环境问题。可以先检查并设置 locale 环境变量（如 export LANG=zh_CN.UTF-8）来解决。

Zsh 配置与优化

2026-05-15T00:00:00.000Z

1 安装#

Terminal window

1
sudo pacman -S zsh

2 更改默认终端#

Terminal window

1
chsh -l # 查看安装了哪些 Shell
2
chsh -s /usr/bin/zsh # 修改当前账户的默认 Shell

3 切换到 Zsh 并配置#

第一次启动时按照提示配置即可，也可以直接编辑 .zshrc 文件。

Terminal window展开收起

1
# Lines configured by zsh-newuser-install
2
HISTFILE=~/.histfile
3
HISTSIZE=99999
4
SAVEHIST=99999
5
setopt autocd beep extendedglob nomatch notify
6
bindkey -v
7
# End of lines configured by zsh-newuser-install
8
# The following lines were added by compinstall
9
zstyle :compinstall filename '/home/bill/.zshrc'
10

11
autoload -Uz compinit
12
compinit
13
# End of lines added by compinstall
14

15
### Added by Zinit's installer
16
if [[ ! -f $HOME/.local/share/zinit/zinit.git/zinit.zsh ]]; then
17
    print -P "%F{33} %F{220}Installing %F{33}ZDHARMA-CONTINUUM%F{220} Initiative Plugin Manager (%F{33}zdharma-continuum/zinit%F{220})…%f"
18
    command mkdir -p "$HOME/.local/share/zinit" && command chmod g-rwX "$HOME/.local/share/zinit"
19
    command git clone https://github.com/zdharma-continuum/zinit "$HOME/.local/share/zinit/zinit.git" && \
20
        print -P "%F{33} %F{34}Installation successful.%f%b" || \
21
        print -P "%F{160} The clone has failed.%f%b"
22
fi
23

24
source "$HOME/.local/share/zinit/zinit.git/zinit.zsh"
25
autoload -Uz _zinit
26
(( ${+_comps} )) && _comps[zinit]=_zinit
27
### End of Zinit's installer chunk
28

29
# 绑定键盘上的特殊按键如End，可以命令行里按cat回车，再按下对应的按键即可查看
30
bindkey  "^[[H"   beginning-of-line
31
bindkey  "^[[F"   end-of-line
32
bindkey  "^[[3~"  delete-char
33

34
# 配置默认编辑器
35
export EDITOR='nvim'
36

37
# 配置插件
38
zinit light zsh-users/zsh-completions
39
zinit light zsh-users/zsh-autosuggestions
40
zinit light zdharma-continuum/fast-syntax-highlighting
41
zinit light agkozak/zsh-z
42

43
# Starship
44
eval "$(starship init zsh)"
45

46
# 终端语言
47
export LANG=zh_CN.UTF-8
48
export LC_ALL=zh_CN.UTF-8
49

50
# 别名
51
alias ls='ls --color=auto'
52
alias ll='ls -alhF'
53
alias grep='grep --color=auto'

展开收起

3.1 基本 Zsh 设置#

这一部分也是初始化的时候设置的。

历史记录
HISTFILE=~/.histfile：指定历史命令保存文件。 HISTSIZE=99999 和 SAVEHIST=99999：内存中及文件中的历史命令最大数量。
Shell 选项
setopt autocd beep extendedglob nomatch notify：
- autocd：直接输入目录名即可进入。
- beep：出错时响铃。
- extendedglob：启用扩展模式匹配。
- nomatch：无匹配时不报错。
- notify：后台任务完成时立即通知。
键绑定
bindkey -v：使用 vi 风格命令行编辑（默认是 emacs 风格）。

3.2 命令补全系统#

通过 compinit 加载 Zsh 自带的智能补全，并设置 compinstall 保存补全配置。

3.3 插件管理器 Zinit#

参考 https://github.com/zdharma-continuum/zinit

自动安装：若未安装 Zinit，脚本会从 GitHub 克隆到 ~/.local/share/zinit。
加载 Zinit：然后加载其核心文件及补全定义。
Zinit 用于管理 Zsh 插件，轻量且高效。

3.4 键盘按键修正#

针对终端发送的转义序列，绑定常用按键：

^[[H：Home → 行首
^[[F：End → 行尾
^[[3~：Delete → 删除光标后字符

3.5 编辑器环境变量#

export EDITOR='nvim'：设置 Neovim 为默认文本编辑器。

3.6 加载的 Zinit 插件#

zsh-users/zsh-completions：提供额外的补全定义。
zsh-users/zsh-autosuggestions：根据历史记录实时建议命令（按 → 补全）。
zdharma-continuum/fast-syntax-highlighting：高性能语法高亮，类似于 zsh-syntax-highlighting。
agkozak/zsh-z：智能目录跳转，根据访问频率快速切换到常用目录，类似于 autojump。使用 ajeetdsouza/zoxide 替代。

3.7 提示符 Starship#

eval "$(starship init zsh)"：启用 Starship 跨 shell 提示符，显示 Git 状态、时间、路径等丰富信息。

3.8 终端语言环境#

export LANG=zh_CN.UTF-8 和 export LC_ALL=zh_CN.UTF-8：设置用户终端为中文 UTF-8 编码。

3.9 常用别名#

ls='ls --color=auto'：彩色显示目录内容。
ll='ls -alhF'：列出所有文件（包括隐藏），人性化大小，并标记类型。
grep='grep --color=auto'：匹配结果高亮显示。

一只比尔

在 Ubuntu 上安装更高版本的 CMake

1 安装依赖#

2 获取签名密钥#

3 添加仓库#

4 安装 keyring#

5 安装 CMake#

在 Ubuntu 上使用 Git Credential Manager（GCM）实现认证

1 从 GitHub Release 下载安装 GCM#

1.1 下载最新的 .deb 包#

1.2 安装 .deb 包#

2 配置 GCM 使用 Seahorse 作为凭证存储#

2.1 配置 credential.helper#

2.2 配置 credential.credentialStore 为 secretservice#

2.3 确保依赖已安装#

2.4 重启系统#

3 访问私有仓库——浏览器登录认证#

3.1 首次认证流程#

3.2 查看已存储的凭证#

3.3 更新或删除凭证#

Ubuntu 安装 nVidia 相关

1 安装 CUDA 与显卡驱动#

1.1 关闭系统自带驱动 nouveau#

1.2 添加 NVIDIA 存储库#

2 安装显卡驱动#

3 安装 CUDA Toolkit#

4 安装 cuDNN#

OpenCode 以及第三方桌面应用 OpenChamber 的安装与使用

1 安装#

1.1 安装脚本#

1.2 使用 NPM 安装#

1.2.1 Linux 安装 Node#

1.2.2 Windows 安装 Node#

1.2.3 安装 OpenCode#

1.3 添加供应商#

2 桌面应用#

使用 GCMP 在 VS Code Copilot 中接入 DeepSeek API

1 GCMP 是什么#

2 注册 DeepSeek 并获取 API Key#

3 安装 GCMP#

4 配置 DeepSeek 模型#

5 开始使用#

cargo install 的一些杂项

1 --locked 参数#

2 使用 cargo-binstall 直接安装二进制文件#

2.1 为什么使用它？#

2.2 如何使用#

2.3 工作原理#

3 使用 cargo-update 更新#

3.1 安装 cargo-update#

3.2 更新所有已安装的包#

3.3 更新特定包#

3.4 注意事项#

3.5 与 cargo binstall 的协作#

常用的 colcon build 参数

1 安装方式#

2 包选择#

3 构建过程控制#

4 输出与事件处理#

5 测试相关#

6 工作空间路径#

7 其他#

8 常见场景示例#

Git Submodule 命令

1 常用命令#

1.1 添加子模块#

1.2 克隆含有子模块的仓库#

1.3 更新子模块#

1.4 查看子模块状态#

1.5 删除子模块#

1.6 同步子模块 URL#

1.6.1 何时需要#

1.6.2 典型场景#

1.6.3 用法#

2 子模块在仓库中的配置文件#

2.1 .gitmodules：版本控制的配置文件#

2.2 .git/config：本地仓库配置（不版本控制）#

2.3 主仓库的树对象：子模块指针的存储#

2.4 .git/modules/<路径>：子模块实际的 Git 数据#

3 一些操作#

1.1 下载最新的 `.deb` 包#

1.2 安装 `.deb` 包#

1 `--locked` 参数#

2.1 `.gitmodules`：版本控制的配置文件#

2.2 `.git/config`：本地仓库配置（不版本控制）#

2.4 `.git/modules/<路径>`：子模块实际的 Git 数据#

2 项目级配置：`devEngines.runtime`#