开发 on YSY的博客

CC Switch 使用指南：管理 API 密钥并接入 Codex

Tue, 04 Aug 2026 00:00:00 +0000

按你的目标选择对应文章：通过 CC Switch 统一管理 API 密钥并登录 Codex，或使用 CC Switch 在 Codex 中接入 DeepSeek API。

1. API 密钥管理与 Codex 登录

使用 CC Switch 管理 Faro API 密钥并登录 Codex 桌面版

2. 模型接入

使用 CC Switch 在 Codex 中接入 DeepSeek API

3. 仍未解决

如果在 CC Switch 中配置 API 后 Codex 没有生效、测速失败或模型不可用，请先查看对应子文章中的常见问题。若仍未解决，请提供：CC Switch 版本、供应商配置截图、Codex 版本，以及具体的报错文字或日志。

用本地 Codex 并行开发同一个项目

Fri, 31 Jul 2026 00:00:00 +0000

本文演示如何借助本地 Codex 和 Git 工作树，让多个对话同时推进同一个项目中的不同任务。核心原则是先划分清楚任务边界，再分别开发、提交和合并。

本文介绍两种工作流：临时工作树适合一次性的并行任务；永久工作树适合需要持续维护同一条开发线的场景。无论采用哪一种，都应避免多个任务同时修改同一批文件。

1. 临时工作树：适合一次性并行任务

临时工作树的特点是每次新建对话时创建一个分支和对应的工作树。任务完成并合并后，这个工作树通常不再继续使用，适合功能开发、测试补充或独立问题排查等短期任务。

1.1 创建工作树并分配任务

首先新建一个对话。

然后将本地环境切换到新的工作树。

接下来，为第一个工作树分配任务。重复“新建对话、创建工作树、分配任务”的过程，就可以让多个对话并行修改同一个项目。

在开始前，建议明确每个任务负责的模块和文件范围。例如，一个任务负责接口实现，另一个任务负责测试，第三个任务负责前端页面。任务说明中最好同时写清目标、涉及目录、验收方式和不应修改的文件，避免后续合并时出现冲突或重复工作。

多个任务并行执行后的效果如下：

1.2 要求每个任务完成收尾

当某个工作树中的任务完成后，可以向对应对话发送下面这段提示，确保它在提交前完成必要的检查：

1
2
3
4
5
6


请停止继续扩展范围，完成当前任务的收尾：

1. 运行本任务相关测试、Ruff、Python 编译和 git diff --check。
2. 只提交你自己修改的文件，不要更新 docs/任务书.md、docs/完成记录.md。
3. 创建一个清晰的 Git 提交。
4. 回复提交哈希、修改文件列表、测试结果和已知风险。

这样可以让每个并行任务都产出独立、可审查的提交，也便于后续定位问题。

1.3 将各工作树的改动合并到主线

当各工作树完成 Git 提交后，回到主工作区的终端，按提交间的依赖关系依次执行 cherry-pick。例如：

1
2
3
4


git cherry-pick <A 的提交哈希>
git cherry-pick <C 的提交哈希>
git cherry-pick <E 的提交哈希>
git cherry-pick <D 的提交哈希>

这些命令会将各工作树中的提交复制到主线。每次执行 cherry-pick 后，都应检查当前工作区状态和补丁格式：

1
2


git status --short
git diff --check

如果发生冲突，应在主工作区统一处理，不要回到原工作树反复修改同一处代码。处理完成后继续执行 cherry-pick，并在所有提交合并完成后运行完整测试。

2. 永久工作树：适合持续维护的任务

如果某个任务需要跨多次对话持续推进，或你希望长期保留它的独立开发环境，可以创建永久工作树。它不需要在每次开始新对话时重复创建分支，更适合持续迭代的功能或长期维护的模块。

2.1 创建永久工作树

在项目右侧的三个点菜单中，选择创建永久工作树。

创建完成后，先向 AI 发送一条只读检查指令，确认当前工作树的根目录和 Git 状态：

1

请只执行 git rev-parse --show-toplevel 和 git status --short，不修改任何文件，并报告输出结果。

确认工作树状态无误后，再为它创建对应的分支。

后续可以持续在这个工作树中推进同一类任务。需要将成果并入主线时，仍然应遵循独立提交、审查差异和集中处理冲突的原则。

3. 如何选择工作树方式

临时工作树：适合目标明确、完成后即可合并的一次性任务。
永久工作树：适合跨多个阶段持续迭代，或需要长期保留上下文和开发环境的任务。

无论使用哪种方式，任务之间的文件边界越清晰，最终合并就越顺畅。

4. 小结

使用本地 Codex 并行开发的重点不在于同时开启多少个对话，而在于任务边界清晰、每项改动独立提交，并在主工作区集中完成合并与验证。这样既能提升并行效率，也能控制集成风险。

Cursor 使用指南：入门、界面、插件、模型与常见问题

Mon, 27 Jul 2026 00:00:00 +0000

根据你的目标选择对应文章：首次了解 Cursor、调整界面与插件、配置模型服务，或排查 Agent 卡死问题。

1. 入门与界面

2. 插件与模型配置

3. 常见问题

Cursor Agent 模式频繁卡死的排查方案

ChatGPT 频繁「正在重新连接」？开启 Clash TUN 模式即可解决

Mon, 13 Jul 2026 00:00:00 +0000

1. 问题现象

使用 ChatGPT 时，界面顶部频繁弹出 正在重新连接，往往连续重试四五次，看起来已经无法正常使用了。但稍等片刻后，回复又会突然正常输出。

这种「先失败、后恢复」的表现容易让人误以为是网络波动或 ChatGPT 服务端不稳定。

2. 原因分析

问题通常出在代理配置上，而非 ChatGPT 本身。

ChatGPT 优先通过 WebSocket 与服务器保持长连接，以实现流式输出。在仅开启系统代理、未启用 TUN 模式的情况下，Clash 往往只能接管浏览器走 HTTP 代理的那部分流量，WebSocket 连接不一定能稳定经过代理，于是反复握手失败，界面便不断显示「正在重新连接」。

多次重试之后，客户端会 降级为普通 HTTP 请求 拉取回复。HTTP 走代理通常没有问题，所以最终又能看到正常输出——给人一种「快放弃了又好了」的错觉。

3. 解决方案：开启 Clash TUN 模式

TUN 模式在系统网络层接管全部流量，WebSocket 与 HTTP 都会经过 Clash 路由，长连接不再频繁中断。

3.1. 操作步骤

以 Clash Verge 为例：

打开 Clash Verge，确保代理已正常运行
进入设置，找到 TUN 模式（或 虚拟网卡模式）
开启 TUN 模式，按提示授予管理员权限（Windows 首次开启需要）
重新打开 ChatGPT 页面，发起一次对话验证

若使用其他 Clash 客户端（如 Clash for Windows、Clash Meta 等），同样在设置中开启 TUN / 增强模式即可，名称可能略有不同。

4. 总结

现象	原因	解决
频繁「正在重新连接」	WebSocket 未稳定走代理	开启 Clash TUN 模式
重试多次后又能用	客户端降级为 HTTP	同上，无需额外操作

开启 TUN 模式后，ChatGPT 的 WebSocket 长连接可以稳定经代理转发，流式输出不再反复断连。

Anaconda 安装教程

Fri, 20 Mar 2026 00:00:00 +0000

1. 下载安装包

前往 Anaconda 官网下载安装包。进入页面后，点击 Skip Registration（跳过注册）即可直接下载，无需注册账号。

跳过注册后，根据自己的操作系统选择对应的版本下载。以 Windows 为例，点击 Anaconda Distribution 下的 Windows 64-Bit Graphical Installer 即可。

2. 安装

下载完成后，双击安装程序（.exe 文件）启动安装向导。

2.1. 欢迎界面

打开安装向导后，点击 Next 继续。

2.2. 许可协议

阅读许可协议后，点击 I Agree 同意并继续。

2.3. 选择安装类型

选择 Just Me（默认推荐），然后点击 Next 继续。

2.4. 选择安装位置

默认安装路径为 C:\Users\用户名\anaconda3，建议保持默认，直接点击 Next 继续。

若需要安装到其他位置，请注意：路径中不能含有中文，否则可能导致运行异常。

2.5. 高级安装选项

建议全部勾选，然后点击 Install 开始安装。

Create shortcuts：创建快捷方式，方便从开始菜单启动 Anaconda 相关工具
Add installation to my PATH：将 Anaconda 加入系统环境变量，这样在普通 cmd/PowerShell 中也能直接使用 conda 命令。虽然安装器标注了"不推荐"，但那主要是针对同时安装了多个 Python 的用户，担心产生冲突。如果你只使用 Anaconda，勾上更方便；如果你熟悉环境变量配置，也可以不勾，后续手动添加
Register Anaconda3 as my default Python：将 Anaconda 的 Python 注册为系统默认 Python，VSCode、PyCharm 等工具可自动识别
Clear the package cache upon completion：安装完成后清理缓存，释放磁盘空间

2.6. 安装完成

等待安装进度条跑完，提示 Installation Complete 后，点击 Next 继续。

2.7. 云端推广页

这是 Anaconda 的云服务推广页面，直接点击 Next 跳过即可。

2.8. 完成安装

取消勾选 Welcome to Anaconda，然后点击 Finish 完成安装。

3. 验证安装

按 Win + R 打开运行窗口，输入 cmd 后回车打开命令提示符。

在命令提示符中依次输入以下命令验证安装是否成功：

输入 python 回车，若显示 Python 版本信息（如 Python 3.13.9 | packaged by Anaconda）则说明 Python 安装正常，输入 exit() 退出。

再输入 conda --version，若显示版本号（如 conda 25.11.1）则说明 Anaconda 安装成功。

如何查找 Gemini 订阅截止日期

Tue, 24 Feb 2026 00:00:00 +0000

Gemini（原 Google One AI）的订阅到期时间在网页里藏得比较刁钻，第一次找往往要翻半天。这里记一下具体查找路径，方便大家查找。

1. 第一步：设置和帮助 → 个人使用场景

在 Gemini 页面，唯一的入口是：

点击左侧边栏底部的 「设置和帮助」，展开或进入设置相关页面。
在随之出现的内容里进入 「个人使用场景」（Personal Usage Scenarios）。
在该页的 「你的付费内容」 区块中，点击下方的 「管理与你的 Google 账号关联的订阅」。

点击后会跳转到 Google 账号的订阅页面。

2. 第二步：在 Google 账号订阅页查看续订日期

跳转后进入的是 Google 账号 → 订阅 页面。页面顶部有返回箭头和「订阅」标题。

找到 Google One 一栏，这里的续订日期就是你会员到期的时间

3. 小结

路径总结：打开 Gemini → 设置和帮助 → 个人使用场景 → 点击「管理与你的 Google 账号关联的订阅」→ 在跳转后的「订阅」页中，看「由 Google 管理」里对应订阅卡片上的 「续订日期」 即可。

东秦学生申请 GitHub 学生认证完全指南

Fri, 13 Feb 2026 00:00:00 +0000

适用对象：东北大学秦皇岛分校（NEU Qinhuangdao）在校学生 认证优势：免费使用 GitHub Pro、JetBrains 全家桶、Azure 学生订阅等价值上千美元的开发者工具

1. 前言

GitHub Student Developer Pack 为学生提供了丰富的免费开发工具和服务。本指南基于东秦学生的实际申请经验编写，特别记录了"修改浏览器定位"这一解决认证失败的关键技巧，希望帮助同学们顺利通过认证。

2. 东北大学总校学生邮箱的注册与激活

申请 GitHub 学生包需要使用学校提供的教育邮箱。对于东秦学生，我们需要注册并激活东北大学总校的邮箱（后缀为 @mails.neu.edu.cn）。

2.1. 前情提要

在操作过程中，如果遇到网站加载缓慢、转圈半天然后报错的情况，这通常是学校网站维护或网络波动，并非您的操作问题。请不要焦躁，稍作休息，等一会儿再回来尝试。

2.2. 进入邮箱系统与初步尝试

首先，请在浏览器中访问东北大学邮件系统：

https://mails.neu.edu.cn/coremail/

在登录框下方找到并点击 新生注册。

注意：无论您是大一新生还是大四老生，只要您之前没有注册过这个邮箱账号，都必须点击“新生注册”入口。

2.3. 统一身份认证与密码重置

点击注册后，系统会跳转到“统一身份认证”界面。由于大多数同学不清楚默认密码或已遗忘，我们需要直接走密码重置流程。

2.3.1. 进入重置流程

在登录框下方，点击 忘记密码。

2.3.2. 验证账号信息

账号：输入您的东秦学号（账号是互通的）。
手机：使用您在东秦校园账号绑定的手机号。
输入图形验证码，点击 下一步。

2.3.3. 设置新密码

系统会向您的手机发送 6 位动态验证码，填入验证码。
设置一个新的密码（请务必记住，后续登录全靠它）。
点击完成。

2.4. 二次进入注册流程

密码重置成功后，不要直接登录，我们需要重新走一遍注册入口。

再次回到邮箱系统首页：https://mails.neu.edu.cn/coremail/
再次点击 新生注册。
在跳转出的统一身份认证界面，使用您的学号和 刚才重置的新密码 进行登录。
到了绑定邮箱这个界面后，保留这个界面，继续下一步

2.5. 第三次进入注册流程

输入网址再回到登录界面，再次点击新生注册

1

https://mails.neu.edu.cn/coremail/

登录成功后，会进入“新生注册”的信息填写页面，请完善以下信息：

您的姓名：确认无误。
您的学号：确认无误。
您的邮箱：设置您的邮箱前缀。
邮箱密码：设置邮箱的独立密码。
确认密码：再次输入。
手机号码：填入手机号并获取验证码。

填写完毕后，点击 提交信息。

2.6. 登录邮箱（关键避坑点）

注册提交后，可能会遇到一个坑：如果直接使用刚才注册的“邮箱账号 + 邮箱密码”登录，系统可能会提示失败或进不去（可能是系统适配问题）。

正确登录方式：

回到邮箱登录首页。
即使已经注册好了，也不要直接输账号密码。
点击登录框上方的 统一身份认证登录 选项卡。
使用学号和 统一身份认证密码 进行登录。

成功登录后，您将看到邮箱主界面。请点击左上角头像，确认您的邮箱地址后缀为 @mails.neu.edu.cn。至此，教育邮箱准备工作完成

3. GitHub 账号的标准化配置

拥有了教育邮箱后，我们需要将其绑定到 GitHub 账号上，并完成官方要求的安全设置（2FA）以及个人资料的“学生化”包装。

3.1. 准备工作：网络环境配置

在登录 GitHub 之前，有一个非常重要的细节需要注意。根据实测经验，建议开启 Steam++ (Watt Toolkit) 来加速 GitHub。

避坑指南：尽量避免使用其他普通的梯子或代理工具，因为 GitHub 的风控系统可能会检测到 IP 异常，从而影响最终的认证结果。

3.2. 绑定教育邮箱

3.2.1. 进入设置页面

访问 GitHub 官网：https://github.com/
登录您的 GitHub 账号（如果没有账号请先注册）。
点击右上角的头像，在下拉菜单中选择 Settings (设置)。

3.2.2. 添加邮箱

在左侧菜单栏中找到并点击 Emails。
在 “Add email address” 输入框中，填入您在第一章注册好的学生邮箱（例如 yourname@mails.neu.edu.cn）。
点击 Add 按钮。
之后点击认证一下，GitHub 会向您的学生邮箱发送一封验证邮件。请登录您的学生邮箱，找到邮件并点击验证链接。
找到 Keep my email addresses private 选项。
务必取消勾选（保持 Off 状态）。如果不关闭这个选项，GitHub 在审核时可能无法读取到您的学生邮箱，导致认证失败。

3.3. 开启双重认证 (2FA)

GitHub 现在强制要求开启 2FA (Two-factor authentication) 才能进行某些操作，这也是申请学生包的硬性门槛。

3.3.1. 启用入口

在左侧菜单栏点击 Password and authentication。
向下滚动找到 “Two-factor authentication” 区域。
点击 Enable two-factor authentication 按钮。

3.3.2. 配置身份验证器

页面会显示一个二维码。
请在手机上下载并安装 Microsoft Authenticator (或其他类似软件)。
打开手机 App，扫描屏幕上的二维码。
App 会生成一个 6 位数的动态验证码，将其填入 GitHub 网页的输入框中。
保存恢复代码：系统会生成一组 Recovery Codes（恢复代码），请务必下载并妥善保存。如果您丢失了手机或误删了 App，这是找回账号的唯一凭证。

3.4. 完善个人资料 (关键加分项)

为了证明您的“真实学生身份”，我们需要将个人资料修改为符合东秦学生特征的标准格式。

在左侧菜单栏点击 Public profile，按照以下标准填写：

3.4.1. Name (姓名)

格式：名姓 (拼音)
示例：如果您叫张三丰，请填 Sanfeng Zhang。
注意：不要填昵称，要填真实姓名的拼音，与学生证/校园卡保持一致。

3.4.2. Bio (简介)

建议：用英文简单描述一下您的身份。
示例：Student from School of Computer Science and Engineering, majoring in Software Engineering.

3.4.3. URL (链接)

填入东秦官网地址：https://www.neuq.edu.cn/

3.4.4. Company (学校/机构)

必须严格填写东秦的英文全称：
内容：Northeastern University at Qinhuangdao
注意：不要填简写，也不要只填东北大学总校的名字，要精确到秦皇岛分校。

3.4.5. Location (地区)

内容：China

填写完毕后，点击页面底部的 Update profile 保存修改

4. 完善账单信息

在正式提交学生认证申请之前，我们需要先完善 GitHub 的账单信息（Payment information）。这一步非常关键，因为 GitHub 会校验这里的“名义地址”是否与你的学校所在地（秦皇岛）一致。

4.1. 填写账单信息 (关键)

4.1.1. 进入入口

点击 GitHub 页面右上角的头像，选择 Settings。
在左侧菜单栏找到 Access 区域，点击 Billing and licensing。
在展开的子菜单中，点击 Payment information。

4.1.2. 填写规范 (请严格照抄)

请参照以下标准进行填写，确保与第二章的个人资料保持高度一致：

First name / Last name (姓名)
- 格式：名姓 (拼音)
- 示例：如果您叫张三丰，这里填 Sanfeng 后面填 Zhang。
- 警告：必须填真实姓名的拼音，严禁使用昵称或中文。
Company (公司/学校)
- 这里的输入框可能自动同步了个人资料，如果没有，请手动填入：
- Northeastern University at Qinhuangdao
Address (街道地址)
- 内容：Northeastern University at Qinhuangdao
- 注意：必须填东秦的英文全称。
City (城市)
- 内容：Qinhuangdao
State/Province (省份)
- 内容：Hebei Province
Country/Region (国家/地区)
- 选择：China

确认所有信息无误后，点击底部的 Save billing information 保存。

5. 开始申请流程，解决定位问题与上传凭证（核心章节）

5.1. 进入教育优惠申请入口

5.1.1. 找到入口

依然在左侧 Billing and licensing 菜单下。
点击 Education benefits。
在页面右侧找到并找到绿色的 Start an application 按钮，但是先不要点击，先看下一步。

GitHub 会校验您的物理位置是否在学校附近。如果您身处校外（如寒暑假在家），或者校园网定位不准，直接申请很可能导致认证失败。

请务必按照以下“修改浏览器定位”的流程操作：

5.1.2. 打开开发者工具

在当前申请页面，按键盘上的 F12 键（打开开发者工具）。
保持开发者工具开启，不要关闭。

5.1.3. 调出传感器 (Sensors) 面板

在开发者工具窗口中，先点击顶部的 Network (网络) 选项卡。
点击右上角的三个点图标（更多选项）。
在下拉菜单中选择 More tools (更多工具)。
在子菜单中选择 Sensors (传感器)。
此时，界面下方会出现一个 Sensors 面板。

5.1.4. 输入东大坐标参数 (严格照抄)

在 Sensors 面板中进行如下设置：

Location: 在下拉框中选择 Other…
Latitude (纬度): 输入 41.7636
Longitude (经度): 输入 123.4113
Timezone ID: 输入 Asia/Shanghai
Locale: 输入 zh-Hans-CN
Accuracy: 输入 150

5.1.5. 刷新页面生效

保持开发者工具（F12）和 Sensors 面板处于开启状态（这一点非常重要，不能关）。
后续截图虽然没有截入开发者工具面板，但是一定不能关
点击浏览器左上角的刷新按钮。
页面刷新后，点击绿色的 Start an application 按钮。

5.2. 确认身份信息

5.2.1. 选择角色

Select your role in education: 选择 Student (学生)。

5.2.2. 确认学校关联

由于我们在第二章已经绑定了 @mails.neu.edu.cn 的邮箱，系统会自动识别出学校。
界面通常会提示：You have verified the email address … associated with the school Northeastern University, China.
此时直接点击 Continue (继续) 即可。

点击 Continue 后，再点击 Share Location（分享定位）。

5.3. 上传学生证件

定位通过后，页面下方会出现证件上传区域。

5.3.1. 选择凭证类型

在 Please select the type of proof you would like to provide 下拉菜单中，选择：

1. Dated school ID - Good (有日期的学生证)

5.3.2. 拍照上传

浏览器会请求使用摄像头，请务必点击允许。
拿出您的东北大学秦皇岛分校一卡通（校园卡）。
拍摄要求：
- 拍摄印有人像照片的那一面。
- 确保光线充足，文字清晰可见。
- 手持卡片对准摄像头（第二次点击通常有 3 秒延迟拍摄）。
- 亲测饭卡（一卡通）是可行的。

5.4. 提交与审核结果

5.4.1. 提交申请

照片上传无误后，点击底部的 Submit 提交申请。

5.4.2. 查看审核状态

提交后页面会显示审核状态，一般 3-4 分钟即可出结果，请刷新页面查看：

Approved (绿色)：恭喜！认证通过。页面提示福利将在 72 小时内到账。
Denied (红色)：认证失败。系统会提示具体原因（如图像不清、定位不符等），请根据提示修正后重新尝试。

6. 参考资料

新电脑 Git 初始化配置指南

Wed, 11 Feb 2026 00:00:00 +0000

1. 问题背景

在新电脑上使用 Git 时，常常会因为缺少必要配置而遇到各种问题：

无法连接 GitHub（网络问题）
提交代码时提示缺少用户信息
中文文件名显示为乱码

本文整理了新机 Git 初始化的完整流程，帮助你快速配置好开发环境。

2. 配置代理

如果你需要使用代理工具访问 GitHub，首先需要配置 Git 的网络代理。

2.1. 查找代理端口

不同的代理工具使用的端口不同：

Clash：默认端口 7890
Clash Verge：默认端口 7897
其他工具：可在工具的设置中查看

2.2. 设置代理

在 Git Bash 或终端中输入以下命令（将 7897 替换为你的实际端口）：

1
2


git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897

2.3. 验证配置

输入以下命令查看配置是否生效：

1

git config --global -l

如果看到以下输出，说明代理配置成功：

1
2


http.proxy=http://127.0.0.1:7897
https.proxy=http://127.0.0.1:7897

3. 配置用户信息

Git 在提交代码时需要记录提交者的身份信息。

3.1. 设置用户名和邮箱

在引号内填入你的 GitHub 用户名和邮箱（建议使用 GitHub 绑定的邮箱）：

1
2


git config --global user.name "你的 GitHub 用户名"
git config --global user.email "your-email@example.com"

示例：

1
2


git config --global user.name "sign-river"
git config --global user.email "example@gmail.com"

4. 解决中文文件名乱码问题

如果你的项目中有中文文件名，Git 默认会将其转义为八进制编码，显示为乱码（如 \344\270\255\346\226\207）。

4.1. 设置显示中文

执行以下命令禁用路径引号转义：

1

git config --global core.quotepath false

配置后，git status 等命令就能正常显示中文文件名了。

5. 完整配置脚本

如果你想一次性完成所有配置，可以复制以下命令并修改对应的值：

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


# 配置代理（根据实际端口修改）
git config --global http.proxy http://127.0.0.1:7897
git config --global https.proxy http://127.0.0.1:7897

# 配置用户信息（替换为你的信息）
git config --global user.name "你的用户名"
git config --global user.email "your-email@example.com"

# 解决中文乱码
git config --global core.quotepath false

# 查看所有配置
git config --global --list

6. 常见问题

6.1. Q1: 如何取消代理配置？

如果不再需要代理，可以使用以下命令移除：

1
2


git config --global --unset http.proxy
git config --global --unset https.proxy

6.2. Q2: 如何修改已有的配置？

直接重新执行设置命令即可覆盖旧配置，或者使用以下命令编辑配置文件：

1

git config --global --edit

6.3. Q3: 配置是否对所有仓库生效？

--global 参数表示全局配置，对当前用户的所有 Git 仓库生效。如果只想针对某个仓库配置，可以去掉 --global 参数，在仓库目录下执行命令。

7. 总结

完成以上配置后，你的新电脑就可以正常使用 Git 进行开发了。这些配置只需要执行一次，之后就可以专注于代码本身。

如果遇到其他 Git 相关问题，欢迎在评论区讨论！

Markdown 语法指南

Tue, 10 Feb 2026 00:00:00 +0000

1. 前言

Markdown 是一种轻量级标记语言，让你可以用纯文本格式编写文档，然后转换成格式丰富的 HTML 页面。本文将系统介绍 Markdown 的各种语法。

2. 基础语法

2.1. 标题

使用 # 符号创建标题，数量表示标题级别：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

2.2. 段落和换行

段落：段落之间用空行分隔

1
2
3


这是第一段内容。

这是第二段内容。

换行：在行末添加两个空格或使用 <br>

1
2
3
4
5
6
7


第一行内容
第二行内容（注意上一行末尾有两个空格）

或者使用 HTML 标签：
第一行内容<br>
第二行内容
在代码段和图片间添加空行更适合用第二种方法

效果：第一行内容第二行内容

或者：
第一行内容
第二行内容

2.3. 强调

1
2
3
4


_斜体_ 或 _斜体_
**粗体** 或 **粗体**
**_粗斜体_** 或 **_粗斜体_**
~~删除线~~

效果：

斜体
粗体
粗斜体
~~删除线~~

3. 列表

3.1. 无序列表

使用 -、+ 或 * 加空格：

1
2
3
4
5


- 第一项
- 第二项
 - 嵌套项 1
 - 嵌套项 2
- 第三项

效果：

第一项
第二项
- 嵌套项 1
- 嵌套项 2
第三项

3.2. 有序列表

使用数字加点加空格：

1
2
3
4
5


1. 第一项
2. 第二项
 1. 嵌套项 1
 2. 嵌套项 2
3. 第三项

效果：

第一项
第二项
1. 嵌套项 1
2. 嵌套项 2
第三项

3.3. 任务列表

1
2
3


- [x] 已完成任务
- [ ] 未完成任务
- [ ] 待办事项

效果：

已完成任务
未完成任务
待办事项

4. 链接和图片

4.1. 链接

普通链接：

1
2


[链接文本](https://example.com)
[带标题的链接](https://example.com "鼠标悬停时显示")

效果：

自动链接：

1
2


<https://example.com>
<email@example.com>

效果：

引用式链接：

1
2
3
4


这是 [链接][1] 和 [另一个链接][link-ref]

[1]: https://example.com
[link-ref]: https://another-example.com

效果：这是 GitHub 和 VS Code

4.2. 图片

基本语法：

1
2


![图片描述](图片路径。jpg)
![带标题的图片](图片路径。jpg "鼠标悬停标题")

调整图片大小（需要 HTML）：

1

<img src="图片路径。jpg" alt="描述" width="300" />

示例：

1

<img src="images/example.jpg" alt="示例图片" width="400" />

引用式图片（与引用式链接类似）：

1
2
3


![图片][image-ref]

[image-ref]: 图片路径。jpg

5. 引用

5.1. 基本引用

1
2
3


> 这是一句引用
>
> 可以包含多个段落

效果：

这是一句引用

可以包含多个段落

5.2. 嵌套引用

1
2
3
4
5


> 第一层引用
>
> > 第二层引用
> >
> > > 第三层引用

效果：

第一层引用

第二层引用

第三层引用

5.3. 引用中使用其他元素

1
2
3
4
5
6


> ## 引用中的标题
>
> - 列表项 1
> - 列表项 2
>
> **粗体文本**

效果：

引用中的标题

列表项 1

列表项 2

粗体文本 和 斜体文本

6. 代码

6.1. 行内代码

使用反引号包裹：

1

这是一段包含 `代码` 的文本。

效果：这是一段包含 代码 的文本。

6.2. 代码块

6.2.1. 方式一：使用三个反引号

1
2
3
4


```python
def hello():
 print("Hello, World!")
```

6.2.2. 方式二：缩进四个空格

1
2


 def hello():
 print("Hello, World!")

6.2.3. 指定语言以启用语法高亮

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


```python
print("Python 代码")
```

```javascript
console.log("JavaScript 代码");
```

```bash
echo "Shell 脚本"
```

效果：

1
2


def greet(name):
 print(f"Hello, {name}!")

1
2
3


function greet(name) {
 console.log(`Hello, ${name}!`);
}

1
2


#!/bin/bash
echo "Hello, World!"

7. 表格

7.1. 基本表格

1
2
3
4


| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -------: |
| 内容 1 | 内容 2 | 内容 3 |
| 长内容 | 短 | 中等内容 |

效果：

左对齐	居中对齐	右对齐
内容 1	内容 2	内容 3
长内容	短	中等内容

对齐方式：

:--- 左对齐
:---: 居中
---: 右对齐

8. 分隔线

使用三个或更多的 -：

1

---

效果：

第一条分隔线：

9. 转义字符

使用反斜杠 \ 转义特殊字符：

1
2
3


\* 不是斜体
\# 不是标题
\[ 不是链接

效果：

* 这不会变成列表
# 这不会变成标题
[这不是链接、]

可转义的字符：

1

\ ` * _ { } [ ] ( ) # + - . !

10. 进阶语法

10.1. 脚注

1
2
3


这是一段包含脚注的文本 [^1]。

[^1]: 这是脚注内容。

效果：这是一段包含脚注的文本 ¹，还有另一个脚注 ²。

10.2. 定义列表

1
2
3
4
5
6


术语
: 定义内容
: 可以有多个定义

另一个术语
: 另一个定义

效果：

Markdown: 一种轻量级标记语言; 由 John Gruber 创建
HTML: 超文本标记语言

10.3. 缩略语

1
2
3
4


_[HTML]: Hyper Text Markup Language
_[CSS]: Cascading Style Sheets

HTML 和 CSS 是 Web 开发的基础。

11. HTML 支持

Markdown 支持内嵌 HTML 标签：

1
2
3
4
5
6
7
8
9


<div align="center">
 <h2>居中标题</h2>
 <p style="color: red;">红色文字</p>
</div>

<details>
 <summary>点击展开</summary>
 隐藏的内容
</details>

效果：

这是居中的标题

这是红色的文字

点击展开查看更多

这里是隐藏的内容

可以包含列表
也可以包含其他 Markdown 语法
甚至是粗体

12. 数学公式

使用 LaTeX 语法（需要支持）：

行内公式：

1

这是行内公式 $E = mc^2$

效果：这是行内公式 $E = mc^2$，还有勾股定理 $a^2 + b^2 = c^2$

块级公式：

1
2
3


$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

效果：

$$ \sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n $$$$ \int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2} $$

13. 常用技巧

13.1. 空行和空格

1
2
3
4
5
6
7


<!-- 强制空行（HTML 注释不显示） -->

&nbsp;

<!-- 空格 -->

使用&nbsp; 添加不间断空格

效果：

第一段文字

第二段文字（上方有空行）

这里有三个空格的效果

13.2. 文本居中

1

<div align="center">居中的内容</div>

效果：

这段文字是居中的

可以包含多行内容

13.3. 折叠内容

1
2
3
4
5


<details>
 <summary>点击展开</summary>

 这里是折叠的内容 可以包含任何 Markdown 语法
</details>

效果（上文 HTML 支持部分已展示）

13.4. 颜色文字

1
2


<span style="color: red;">红色文字</span>
<span style="color: blue;">蓝色文字</span>

效果：

这是红色文字这是蓝色文字这是绿色文字这是橙色文字

14. VS Code 快捷键（Markdown All in One）

功能	快捷键
加粗	`Ctrl + B`
斜体	`Ctrl + I`
删除线	`Alt + S`
切换标题级别	`Ctrl + Shift + ]`
预览	`Ctrl + K V`

15. 常见问题

15.1. Q: 如何在列表中添加多个段落？

A: 在段落前添加 4 个空格或 1 个 Tab：

1
2
3
4
5
6
7


1. 第一项

 这是第一项的第二段。

 这是第一项的第三段。

2. 第二项

效果：

第一项

这是第一项的第二段内容。

这是第一项的第三段内容。
第二项

15.2. Q: 如何在表格中换行？

A: 使用 <br> 标签：

1
2
3


| 列 1 | 列 2 |
| ---------------- | ---- |
| 第一行<br>第二行 | 内容 |

效果：

列 1	列 2
第一行第二行	内容
多行内容演示	这是单行

15.3. Q: 图片太大怎么办？

A: 使用 HTML 指定宽度：

1

<img src="image.jpg" alt="描述" width="400" />

16. 在线工具推荐

StackEdit：在线 Markdown 编辑器
Dillinger：支持实时预览
Typora：所见即所得编辑器
Markdown Preview Enhanced：VS Code 插件

17. 参考资料

最后更新：2026-02-10

这是第一个脚注的内容。 ↩︎
这是第二个脚注的内容。 ↩︎

VS Code 编写 Markdown 如何轻松解决格式问题

Tue, 10 Feb 2026 00:00:00 +0000

1. 前言

在 VS Code 中编写 Markdown 时，常常会遇到各种格式问题：表格对不齐、列表缩进混乱、链接格式错误等。本文将介绍如何通过插件和配置来轻松解决这些问题，让你的 Markdown 写作更加高效。

2. 安装插件 markdownlint

2.1. 格式检查工具

功能：

实时检查 Markdown 格式
自动修复常见问题
保持文档规范统一

常见提示：

规则	说明	解决
MD001	标题层级不连续	不要从 # 直接跳到 ###
MD009	行尾有多余空格	删除行尾空格
MD012	连续空行超过一行	删除多余空行
MD013	行长度超过限制	换行或调整配置
MD022	标题前后需要空行	添加空行
MD032	列表前后需要空行	添加空行

2.2. 使用方法

在拓展商店搜索并安装 markdownlint

打开设置 (json)

在设置中输入

1
2
3
4


 "editor.codeActionsOnSave": {
 "source.fixAll.markdownlint": "explicit",
 },
 "editor.formatOnSave": true,

3. 总结

之后只要 Ctrl + S 保存文件，就会自动修正 Markdown 格式

最后更新：2026-02-10

VS Code 自动在中英文间添加空格

Tue, 10 Feb 2026 00:00:00 +0000

1. 前言

在编写中英文混排的文档时，在中文和英文之间添加空格是一个良好的排版习惯。这样做可以：

提升阅读体验：适当的空格让文字更加清晰易读，避免中英文紧贴在一起显得拥挤
符合排版规范：许多中文排版指南都建议在中英文之间添加空格
保持文档一致性：统一的格式让整个文档看起来更专业

但是手动添加空格既繁琐又容易遗漏，本文将介绍如何使用 VS Code 插件实现保存时自动格式化。

2. 安装插件

2.1. Pangu-Markdown

打开 VS Code 扩展商店，搜索 Pangu-Markdown 并安装。

3. 配置自动格式化

3.1. settings.json 配置

打开设置

搜索并启用自动格式化

搜索 pangu，勾选 “Format On Save”（保存时自动格式化）选项。

重启 VS Code

配置完成后需要重启 VS Code 才能生效。

注意：如果配置后没有生效，请尝试重启 VS Code。这是插件生效的必要步骤。

4. 总结

配置完成后，使用 Ctrl+S 保存文件时，插件会自动在中文和英文之间添加空格，让你专注于内容创作，无需担心排版格式问题。