本文将介绍如何通过编译好的归档文件（.tar.gz）安装Elasticsearch，并进行集群配置。

Elasticsearch 安装​

安装环境及 Elasticsearch 版本

• OS: Ubuntu 24.04 LTS
• Elasticsearch: 8.17.2

下载并安装 Elasticsearch​

下载Elasticsearch并解压至安装目录：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.17.2-linux-x86_64.tar.gz

tar -xzf elasticsearch-8.17.2-linux-x86_64.tar.gz
sudo mv elasticsearch-8.17.2 /opt/elasticsearch

cd /opt/elasticsearch

创建用户及权限设置​

sudo adduser elastic
sudo passwd elastic
sudo chown -R elastic:elastic /opt/elasticsearch

配置 Systemd 服务​

创建 /etc/systemd/system/elasticsearch.service 文件，将 Elasticsearch 注册为系统服务：

sudo vim /etc/systemd/system/elasticsearch.service

[Unit]
Description=Elasticsearch
After=network.target

[Service]
User=elastic
Group=elastic
ExecStart=/opt/elasticsearch/bin/elasticsearch
Restart=always
LimitMEMLOCK=infinity
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload

配置防火墙​

sudo firewall-cmd --permanent --add-port=9200/tcp
sudo firewall-cmd --permanent --add-port=9300/tcp
sudo firewall-cmd --permanent --add-port=5601/tcp
sudo firewall-cmd --reload

配置 Elasticsearch 集群​

生成及分发证书​

为了确保集群节点之间的安全通信，生成 SSL/TLS 证书并将其分发到各个节点：

在任意节点上生成 CA 证书：

sudo -u elastic ./bin/elasticsearch-certutil ca
sudo -u elastic ./bin/elasticsearch-certutil cert --ca elastic-stack-ca.p12

将生成的 elastic-certificates.p12 文件复制到各节点的 /opt/elasticsearch/config 目录下：

sudo -u elastic scp elastic-certificates.p12 elastic@192.168.234.129:/opt/elasticsearch/config
sudo -u elastic scp elastic-certificates.p12 elastic@192.168.234.130:/opt/elasticsearch/config
sudo mv elastic-certificates.p12 config/elastic-certificates.p12

编辑 elasticsearch.yml​

为每个节点指定唯一的 node.name，并添加集群相关配置。

sudo vim /opt/elasticsearch/config/elasticsearch.yml

cluster.name: es-cluster
node.name: node-1
network.host: 0.0.0.0

path.data: /opt/elasticsearch/data
path.logs: /opt/elasticsearch/logs

# 集群节点 IP 列表
discovery.seed_hosts: ["192.168.234.128", "192.168.234.129","192.168.234.130"]

# 集群初始主节点列表（首次配置后需注释掉）
cluster.initial_master_nodes: ["node-1", "node-2","node-3"]

# SSL/TLS 配置
xpack.security.transport.ssl.enabled: true
xpack.security.transport.ssl.verification_mode: certificate
xpack.security.transport.ssl.client_authentication: required
xpack.security.transport.ssl.keystore.path: elastic-certificates.p12
xpack.security.transport.ssl.truststore.path: elastic-certificates.p12

cluster.name: es-cluster
node.name: node-2
network.host: 0.0.0.0

path.data: /opt/elasticsearch/data
path.logs: /opt/elasticsearch/logs

# 集群节点 IP 列表
discovery.seed_hosts: ["192.168.234.128", "192.168.234.129","192.168.234.130"]

# 集群初始主节点列表（首次配置后需注释掉）
cluster.initial_master_nodes: ["node-1", "node-2","node-3"]

# SSL/TLS 配置
xpack.security.transport.ssl.enabled: true
xpack.security.transport.ssl.verification_mode: certificate
xpack.security.transport.ssl.client_authentication: required
xpack.security.transport.ssl.keystore.path: elastic-certificates.p12
xpack.security.transport.ssl.truststore.path: elastic-certificates.p12

cluster.name: es-cluster
node.name: node-3
network.host: 0.0.0.0

path.data: /opt/elasticsearch/data
path.logs: /opt/elasticsearch/logs

# 集群节点 IP 列表
discovery.seed_hosts: ["192.168.234.128", "192.168.234.129","192.168.234.130"]

# 集群初始主节点列表（首次配置后需注释掉）
cluster.initial_master_nodes: ["node-1", "node-2","node-3"]

# SSL/TLS 配置
xpack.security.transport.ssl.enabled: true
xpack.security.transport.ssl.verification_mode: certificate
xpack.security.transport.ssl.client_authentication: required
xpack.security.transport.ssl.keystore.path: elastic-certificates.p12
xpack.security.transport.ssl.truststore.path: elastic-certificates.p12

注意：cluster.initial_master_nodes 仅在首次集群配置时需要，之后应将其注释掉。((Bootstrapping a cluster,官方文档))

启动集群并检查状态​

在每个节点上启动 Elasticsearch 服务后，检查集群状态。

启动服务：

sudo systemctl start elasticsearch

重置 elastic 账户的密码：

sudo bin/elasticsearch-reset-password -u elastic -i

检查节点状态：

curl -u elastic:your_pass http://192.168.234.128:9200/_cat/nodes?v

ip              heap.percent ram.percent cpu load_1m load_5m load_15m node.role   master name
192.168.234.130           19          89  88    1.30    0.80     0.37 cdfhilmrstw -      node-3
192.168.234.129           24          89   9    0.29    0.17     0.13 cdfhilmrstw -      node-2
192.168.234.128           10          90  17    0.00    0.00     0.00 cdfhilmrstw *      node-1

检查集群健康状态：

curl -u elastic:your_pass http://192.168.234.128:9200/_cluster/health?pretty

{
  "cluster_name" : "es-cluster",
  "status" : "green",
  "timed_out" : false,
  "number_of_nodes" : 3,
  "number_of_data_nodes" : 3,
  "active_primary_shards" : 3,
  "active_shards" : 6,
  "relocating_shards" : 0,
  "initializing_shards" : 0,
  "unassigned_shards" : 0,
  "unassigned_primary_shards" : 0,
  "delayed_unassigned_shards" : 0,
  "number_of_pending_tasks" : 0,
  "number_of_in_flight_fetch" : 0,
  "task_max_waiting_in_queue_millis" : 0,
  "active_shards_percent_as_number" : 100.0
}

Kibana 集成​

默认elastic账户不能直接在Kibana中使用，Kibana需使用ES内置的 kibana_system 账户。

设置密码：

cd /opt/elasticsearch
sudo bin/elasticsearch-reset-password -u kibana_system -i

安装 Kibana​

wget https://artifacts.elastic.co/downloads/kibana/kibana-8.17.2-linux-x86_64.tar.gz
tar -xzf kibana-8.17.2-linux-x86_64.tar.gz
sudo mv kibana-8.17.2 /opt/kibana

编辑 kibana.yml​

sudo vim /opt/kibana/config/kibana.yml 

server.port: 5601
server.host: "0.0.0.0"
elasticsearch.hosts: ["http://192.168.234.128:9200","http://192.168.234.129:9200","http://192.168.234.130:9200"]
elasticsearch.username: "kibana_system"
elasticsearch.password: "your_pass"

启动 Kibana​

cd /opt/kibana
nohup bin/kibana &

现在，我们可以通过浏览器访问 http://192.168.234.128:5601（或 Kibana 安装节点的 IP 地址），并使用 elastic 账户登录。

本文将介绍如何通过VS Code Cline扩展 + Ollama + DeepSeek R1组合实现免费的AI编程环境搭建。

Cline 是一个可在 VS Code 中使用的 AI 编程辅助扩展，它是开源的解决方案，能够根据用户的指令或代码输入提供多种辅助功能，从而大幅提升开发效率。

与之类似的 VS Code 扩展还有 Continue、Roo Code 等，这些工具均经过一定程度的验证，并且拥有活跃的社区支持。

这些工具在基本设置方式上大同小异，大家可以根据个人习惯选择适合自己的工具。需要注意的是，Cline 本身没有 Tab 自动补全功能，因此可以考虑配合 Continue 一同使用。

根据 openrouter.ai 平台的 token 使用情况来看，Cline 和 Roo Code 的 token 使用量远远领先于其他工具。

Cline,

• VS Code Marketplace
• Github (26.4k Stars)

Continue

• VS Code Marketplace
• Github (22.3k Stars)

Roo Code (prev. Roo Cline)

• VS Code Marketplace
• Github (4.9k Stars)

DeepSeek R1 本地部署​

为什么选择本地部署？​

• 免费及低成本运营: 与需要每月订阅费用的 Cursor AI 不同，Cline 是开源提供的，DeepSeek R1 也可以在本地运行，因此无需额外费用即可享受强大的 AI 辅助功能。
• 数据安全: 所有的 AI 计算都在本地环境中进行，代码和相关数据不会传输到外部服务器，从而在隐私和安全方面提供了显著的优势。
• 快速响应: DeepSeek R1 直接在用户的硬件上运行，因此无需网络延迟即可提供快速响应，与 API 调用方式相比，可以期待更低的延迟。

当然，不能期望在个人 PC 上运行的轻量化蒸馏模型能够提供与 API 提供的完整参数模型相同的效果。

老实说，对于大多数个人开发者来说，承担一定费用并使用平台提供的 API 更为现实（尤其是使用韩语等少数语言的情况下），本地运行方式建议以实验性的心态去尝试。

安装 Ollama​

Ollama 是一个可以帮助在本地轻松运行像 DeepSeek R1 这样的大型语言模型的工具。

• 从 Ollama 官方网站 下载并安装 Ollama。

下载所需的 DeepSeek R1 模型​

根据您的 PC 配置选择合适的模型进行下载。

例如，下载 14B 模型：

# 参考: https://ollama.com/library/deepseek-r1

# ollama run deepseek-r1:1.5b
ollama run deepseek-r1:7b
# ollama run deepseek-r1:8b
# ollama run deepseek-r1:14b
# ollama run deepseek-r1:32b
# ollama run deepseek-r1:70b

下载完成后，模型会自动在本地启动，显示如下信息：

pulling manifest
pulling 96c415656d37... 100% ▕████████████████████████████████████████████████████████▏ 4.7 GB
pulling 369ca498f347... 100% ▕████████████████████████████████████████████████████████▏  387 B
pulling 6e4c38e1172f... 100% ▕████████████████████████████████████████████████████████▏ 1.1 KB
pulling f4d24e9138dd... 100% ▕████████████████████████████████████████████████████████▏  148 B
pulling 40fb844194b2... 100% ▕████████████████████████████████████████████████████████▏  487 B
verifying sha256 digest
writing manifest
success
>>> hello?
<think>

</think>

Hello! How can I assist you today? 😊

>>>

本地运行的模型可以通过 http://localhost:11434 访问。

VS Code 和 Cline 设置​

安装 VS Code 扩展​

在 VS Code 扩展市场中搜索 Cline 并安装。

在 Cline 中连接 ollama（本地 DeepSeek R1）​

• 打开 VS Code 中的 Cline 设置。
• 在 API Provider 列表中选择 Ollama。
• 在 Base URL 字段中输入 http://localhost:11434，然后在模型选择选项中选择正在运行的 DeepSeek R1 模型（例如：deepseek-r1:14b）

当本地 DeepSeek 模型部署成功后，在输入 Base URL 后，Model ID 下方会自动显示可选模型列表。

如果在输入信息后出现MCP hub not available 错误，重启 VS Code 即可解决。
参考 Github Issue: https://github.com/cline/cline/issues/969

测试​

设置完成后，使用 Cline 发送 prompt 测试响应情况。

若发现输入 prompt 后 CPU 疯转而相应特别慢或无响应，则可能是由于电脑硬件不足以支撑该模型运行，此时建议尝试使用低版本的模型进行测试。

API 连接方式​

• 获取 DeepSeek API 密钥（DeepSeek 官方网站）
• 在 VS Code 中打开 Cline 设置，在 API Provider 列表中选择 DeepSeek，输入 API Key，并选择模型 deepseek-reasoner。

现在，你也可以以每月 $0 的成本体验 Cursor 级别的 AI 编程！如果在设置过程中遇到问题，可以参考 Ollama 官方文档或 Cline GitHub 问题页面获取帮助。

特别是 DeepSeek R1，其性能与 OpenAI 相当，凭借亲民的价格和开源战略在市场上掀起了巨大波澜。

本文将采用最简单的方式，介绍如何通过 Spring AI 对接 DeepSeek API，实现一个基础的 AI 聊天机器人。

Spring AI：AI集成的利器​

Spring AI 是 Spring 生态系统中用于集成生成式 AI 的项目，为开发者提供了便捷的 AI 模型整合方案。其主要特性包括：

1. 标准化API: 支持Anthropic、OpenAI、Microsoft、Amazon、Google、Ollama、DeepSeek等主流 AI 服务的统一接口。
2. 模块化架构: 实现与具体AI服务商解耦的灵活结构
3. 快速集成: 基于Spring Boot自动配置的极简整合
4. 扩展能力: 支持自定义模型和高级配置选项

特别适合需要快速部署和扩展 AI 能力的商业应用场景。

DeepSeek：高性能、低成本​

这家中国新兴 AI 公司凭借 DeepSeek R1 震撼业界，其核心优势包括：

• 顶尖语言模型: 达到 OpenAI-o1 级别的高性能模型。
• OpenAI兼容API: 完美适配现有的 OpenAI 生态应用。
• 成本优势: 相比 OpenAI 更具价格竞争力。

准备工作​

• Java 17+
• Gradle 8+
• DeepSeek API密钥 (DeepSeek 官网入口)
• 在环境变量中设置 API 密钥（避免直接写入application.yml）

功能实现​

1. build.gradle配置​

创建Spring Boot项目后，在build.gradle中配置依赖：

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.4.2'
    id 'io.spring.dependency-management' version '1.1.7'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'

java {
    toolchain {
        languageVersion = JavaLanguageVersion.of(17)
    }
}

repositories {
    mavenCentral()
    maven { url 'https://repo.spring.io/milestone' }
    maven { url 'https://repo.spring.io/snapshot' }
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    implementation 'org.springframework.ai:spring-ai-openai-spring-boot-starter:1.0.0-M5'
//    implementation 'org.springframework.ai:spring-ai-ollama-spring-boot-starter:1.0.0-M5'
}

spring-ai-openai-spring-boot-starter支持所有符合OpenAI API标准的服务

2. application.yml配置​

配置DeepSeek连接参数：

如需要与其他语言模型连接，只需要修改base-url、api-key 和 model 的值

spring:
  application:
    name: spring-ai-deepseek
  ai:
    openai:
      base-url: https://api.deepseek.com
      api-key: ${DEEPSEEK_API_KEY}
      chat:
        options:
#          model: deepseek-chat
          model: deepseek-reasoner
          stream-usage: false

#    ollama integration
#    ollama:
#      base-url: http://localhost:11434
#      chat:
#        options:
#          model: deepseek-r1:7b

3. Controller 编写​

接下来，我们编写一个 Spring AI 控制器，通过 API 调用 DeepSeek 服务。

@RestController
@CrossOrigin(origins = "*")
public class ChatController {

    private final ChatClient chatClient;

    public ChatController(ChatClient.Builder builder) {
        chatClient = builder.build();
    }

    @PostMapping("/chat")
    public ChatResponse chat(@RequestParam String prompt) {
        return chatClient.prompt().user(prompt).call().chatResponse();
    }
}

测试​

现在Deepseek API 服务仍然不是很稳定。如出现 API 错误，可以通过以下链接查看服务状态：

查看服务状态: https://status.deepseek.com/

聊天界面实现​

我是借助Cursor快速搭建了一个UI界面，推荐大家也可以使用自己擅长的AI工具，动手定制符合自己需求的交互界面。

总结​

本文介绍了如何使用 Spring AI 连接 DeepSeek API，并实现一个基础的 AI 聊天机器人。

作为 OpenAI 的强劲竞争对手，DeepSeek 未来有望在 AI 市场上占据重要地位。

Cursor AI는 단순한 코드 편집기가 아닙니다. AI의 강력한 자연어 처리(NLP)와 코드 이해 능력을 기반으로 한 다목적 도구로, 개발자부터 콘텐츠 크리에이터에 이르기까지 다양한 사용자에게 혁신적인 생산성 향상을 제공합니다.

참고로, 뒤에 업데이트 하는 내용이지만 이번 포스트도 Cursor AI를 활용해 작성해보았습니다. 그동안 VS Code로 블로그 글을 작성해왔던 터라 나름 친숙한 느낌이 들었습니다.

대부분의 단어에 제안 문장이 뜨다 보니 귀찮은 부분도 없지 않았지만, 글의 틀을 잡고 문맥을 다듬는 데 있어서는 많은 도움을 받을 수 있겠다는 생각이 들었습니다.

1. 개발자를 위한 최적의 AI 코드 편집기
Cursor AI는 개발자에게 꼭 필요한 기능을 제공합니다.

• 코드 자동 완성: AI가 코드의 맥락을 이해하고, 다음에 작성할 코드를 예측하여 빠르게 제안.
• 버그 수정 및 디버깅: 코드 내 잠재적인 오류를 실시간으로 탐지하고, 수정 방안을 제시.
• 코드 리팩토링: 더 효율적이고 가독성 높은 코드로 개선하는 방법을 제안.
• 문서화 지원: 코드에 대한 설명을 자동으로 생성하여 개발 생산성을 높일수 있음.

2. 콘텐츠 크리에이터를 위한 AI 글쓰기 도구
Cursor AI는 개발 영역을 넘어 글쓰는 사람들에게도 강력한 도구로 활용될 수 있습니다.

• 자연어 생성: 블로거, 작가, 콘텐츠 크리에이터를 위해 아이디어 구상부터 문장 작성까지 AI 도움을 받을수 있음.
• 문서 요약: 긴 글을 간결하게 요약하거나, 핵심 포인트를 추출.
• 스타일 맞춤화: 특정 톤이나 스타일에 맞춰 글을 작성하거나 수정 가능.
• 번역 지원: 다양한 언어로의 번역을 통해 글로벌 콘텐츠 제작에 도움을 줄수 있음.

3. 다목적 AI Assist 도구로서의 가능성
Cursor AI는 단일 영역에 국한되지 않고, 다양한 업무와 프로젝트에 적용할 수 있습니다.

• 프로젝트 관리: 작업 목록 생성, 일정 관리, 보고서 작성 등 지원.
• 학습 및 연구: 복잡한 개념을 쉽게 설명하거나, 연구 자료를 정리하는 데 활용가능.

아래는 간단한 스네이크 게임을 만들어본 결과입니다.

Cursor 핵심기능​

Tab 자동완성​

Cursor의 기본기능은 문장이나 코드 앞뒤 문맥을 파악하여 코드제안을 하게 되는데, 이때 Tab 키로 코드제안을 수락할수 있습니다.

GitHub Copilot, JetBrains AI와 같은 기타 AI툴에서도 지원되는 기능이죠? Cursor의 Tab기능은 이 외에도 아래와 같은 차별화 된 기능을 제공하고 있습니다.

1. 멀티라인 자동완성(Multi-line Completion)

Cursor는 아래와 같이 멀티라인의 코드 제안/자동완성이 가능합니다.

2. Smart Rewrite

소스의 오류를 인지하여 자동으로 보정작업을 해줄수 있습니다.

3. 커서 예측(Cursor Prediction)

Cursor는 사용자가 다음에 편집하려는 위치를 예측하여 마우스 커서를 자동으로 이동시킬 수 있습니다.

예를 들어, 제가 함수에 파라미터 하나를 추가했을 때, Cursor는 두 가지 예측을 합니다. 하나는 payload에 추가 작업을 할 수도 있다는 예측(커서 이동), 또 하나는 boolean 파라미터를 사용해 if문을 생성할 수 있다는 예측입니다.

Chat (Ctrl/⌘ + L)​

Cursor Chat 기능은 코드 편집기 내에서 AI와 대화하며 코드 관련 질문을 하거나 문제를 해결할 수 있는 기능입니다.

1. 다양한 컨텍스트지원

컨텍스트(Context)는 상황, 배경, 맥락 등을 의미하며 요즘 흔히 말하는 Prompt도 컨텍스트의 일종의라고 볼수 있습니다. 컨텍스트에 따라 답변의 정확성, 비용 등에도 영향줄수 있으며 AGI의 활용에 있어서 상당히 중요한 역할을 합니다.

Cursor는 아래와 같이 다양한 컨텍스틀 지원합니다:

• 현재 파일 컨텍스트: 기본적으로 현재 열린 파일의 내용을 컨텍스트로 포함합니다. 이를 통해 AI는 코드의 특정 부분을 이해하고 관련된 답변을 제공할 수 있습니다.
• 프로젝트 전체 컨텍스트: @Codebase를 사용하여 전체 프로젝트를 컨텍스트로 포함할 수 있습니다.
• 외부 문서 및 웹 검색: @Doc을 통해 기술 문서를 참조하거나 @Web을 사용해 웹 검색 결과를 포함할 수 있습니다

2. 코드 적용 기능 (Apply)

AI가 제안한 코드를 바로 편집기에 적용할 수 있습니다. 코드 블록 우측의 "Apply" 버튼을 클릭하거나 Ctrl/⌘ + Enter를 눌러 변경 사항을 적용할 수 있습니다.

적용된 코드는 편집기에서 diff형태로 표시되며, 코드 블록 단위로나 파일단위로 변경을 수락할수 있습니다.

3. 채팅 이력 관리

AI화의 대화 기록은 이력으로 관리가 됩니다.AI 패널의 오른쪽 상단에 있는 'Previous Chats' 버튼을 누르거나, Ctrl/⌘ + Alt/Option + L을 누르면 채팅 기록을 확인할 수 있습니다.

4. AI 모델 전환

Cursor Chat은 여러 AI 모델을 지원하며, Ctrl/⌘ /를 눌러 모델을 전환할 수 있습니다. 선택한 모델은 이후 세션에서도 유지됩니다

Inline Chat(Ctrl/Cmd K)​

시작에 이력서 샘플 생성하면서 사용했던 기능입니다. 조금 단순한 지시나, 블록단위의 코드 생성/변경은 Ctrl/Cmd K를 사용하는게 많이 편리합니다.

Ctrl/Cmd K를 누른후 뜨는 창을 프롬프트 바(Prompt Bar)라고 부르며 Chat기능과 마찬가지로 @Codebase, @Doc, @Web 등 기능을 사용할수 있습니다.

변경을 원하는 코드 선택해서 누르거나, 코드 선택을 하지 않은 상태로 눌러 새로운 코드를 생성할수 있습니다.

Composer (Ctrl/⌘ + I)​

Composer 기능은 Chat기능과 달리 에디터에 직접 작용되며, 긴 텍스트와 코드를 체계적으로 작성하고 편집하는 데 최적화 되어있습니다.

Composer vs Chat

Composer는 실험적인 기능으로, Rule이나 prompt를 잘 짜서 사용하면 의외의 효과를 볼수 있습니다.

일반적으로 구조적이고 잘 정리된 요구사항을 prompt로 활용할 때 Composer 기능이 더 적합하며, 프리스타일의 질문/요청에는 Chat 기능이 더 적합합니다.

아래와 같이 prompt 입력후, 변경내역이 실시간으로 에디터에 반영됩니다. (참고로, 시작에 보여드린 스네이크 게임도 Composer를 사용한 결과물입니다.)

Rules for AI​

Cursor Rules란 Cursor의 AI 어시스턴트가 코드를 해석하고, 제안을 생성하며, 질문에 응답할 때 그 동작을 맞춤화하는 사용자 정의 규칙들입니다. Cursor Rules에는 두 가지 유형이 있습니다:

• 전역 규칙(Global Rules): 이 규칙은 모든 프로젝트와 파일에 적용되며, AI의 전반적인 동작을 정의합니다.(Cursor Settings > General > Rules for AI)
• 로컬 규칙(Local Rules): 이 규칙은 특정 프로젝트 또는 파일에만 적용됩니다.(프로젝트 root에 .cursorrules파일로 정의)

Cursor Rules는 아래와 같은 효과를 낼수 있습니다:

1. 코딩 스타일에 맞게 AI 응답을 맞춤화

   • AI가 생성하는 코드나 제안이 개인 또는 팀의 코딩 스타일과 일치하도록 설정할 수 있습니다.
   • 예를 들어, 들여쓰기 방식, 변수 명명 규칙, 코드 구조 등을 지정할 수 있습니다.

2. 팀 전체에 걸쳐 코딩 표준 강제 적용

   • 팀 전체가 동일한 코딩 표준을 따르도록 AI를 설정할 수 있습니다.
   • 이를 통해 코드베이스의 일관성을 유지하고, 코드 리뷰 과정을 단순화할 수 있습니다.

3. 코드 일관성 및 품질 향상

   • AI가 생성하거나 수정하는 코드가 항상 일관된 품질을 유지하도록 지침을 제공할 수 있습니다.
   • 예를 들어, 특정 보안 규칙이나 성능 최적화 기준을 준수하도록 설정할 수 있습니다.

4. 개발 워크플로우 간소화

   • 반복적인 작업을 자동화하고, AI가 개발자의 작업 흐름에 더 잘 통합되도록 설정할 수 있습니다.
   • 예를 들어, 특정 유형의 코드 생성 요청에 대해 항상 동일한 형식으로 응답하도록 설정할 수 있습니다.

결론: Cursor AI, 다목적 AI 도구로의 진화​

오늘은 Cursor의 핵심 기능에 대해 정리해봤습니다. Cursor는 단순한 코드 편집기를 넘어, AI의 힘을 활용해 다양한 분야에서 활용 가능한 다목적 도구로 자리 잡고 있습니다.

처음 Cursor를 접했을 때는 개발자들을 위한 코드 편집기로만 생각했지만, 실제로 사용해보면 그 이상의 잠재력을 발견할 수 있습니다. Cursor는 AI의 자연어 처리 능력을 바탕으로, 코드 작성부터 복잡한 문제 해결, 글쓰기와 콘텐츠 생성에 이르기까지 다양한 작업을 지원하는 강력한 도구입니다.

Cursor는 단순히 도구를 넘어, 사용자의 창의성과 생산성을 극대화하는 파트너 역할을 합니다. 여러분도 Cursor를 통해 더 스마트하고 효율적인 작업 방식을 경험해보시길 추천합니다.

Git：不再是开发者的专属工具！​

过去，Git 主要被视为开发者使用的专业工具，但如今它已经成为博主、作家以及喜欢整理笔记的人们的必备工具。

Git 是什么？

简单来说，Git 是一个版本控制系统。它可以帮助你记录计算机文件的更改，并在需要时回到特定的时间点。 首先，Git 是一个记录代码或文件更改历史，并在多人协作时防止冲突的版本控制系统。简单来说，它是一个可以安全“保存”和“共享”所有工作的数字工作空间。

举个例子，当你在写小说时，如果对内容不满意，想要 “回到一周前的版本”，Git 可以让这种魔法成为可能。

如今，Git 也经常与 Obsidian、Logseq 等笔记管理工具结合使用，广泛应用于个人知识管理（PKM）中。

对于初学者，建议从 GUI 工具开始使用。（如 Sourcetree, GitKraken, GitHub Desktop, VS Code 等）

基本的 Git 工作流程

---- Git Workflow ---
[工作目录 (Working Directory)]  🖥️
        |
        |  文件操作（修改、添加、删除）
        |    |
        |    |  git add <文件>  （暂存变更）
        |    ↓
        v
[暂存区 (Staging Area)]      📦
        |
        |  git commit -m "消息"  （提交变更）
        ↓
[本地仓库 (Local Repository)]  🏠
        |
        |  git push origin <分支>  （将更改推送到远程仓库）
        ↓
[远程仓库 (Remote Repository)] 🌍
        |
        |  git pull origin <分支>  （git fetch + git merge 组合）
        ↓
[协作者的本地仓库]  🏠
        |
        |  git merge（合并）
        |    |
        |    |  冲突解决 (Conflict Resolution , 如果需要)
        |    ↓
        v
[协作者的工作目录 (Working Directory)]  🖥️

Git 术语整理​

Git 命令​

1. 仓库配置​

git config​

git config 是用于管理 Git 配置的命令。通过该命令可以设置或查看用户名、邮箱、编辑器、别名等配置。配置可以在全局（global）、本地（local）和系统（system）级别进行管理。

Git config 文件的类型:

• system 配置文件：适用于所有用户（很少使用）
  • macOS/Linux: /etc/gitconfig，如果是通过 Homebrew 安装的 Git，可能位于 /usr/local/etc/gitconfig。
  • Windows: C:\Program Files\Git\etc\gitconfig
• global 配置文件：适用于当前用户，位于 ~/.gitconfig。
• local 配置文件：仅适用于特定仓库，位于 <repo>/.git/config。

可以使用 -e 选项查看配置文件的位置（例如：git config --global -e）。

global vs. local 通常用户信息使用global配置，项目特定设置使用local配置。

配置优先级： local config> global config > system config

使用示例：

# 查看当前所有生效的配置
git config --list

# 查看全局配置
git config --global --list

# 在全局配置中添加用户名
git config --global user.name "John Doe"

# 在全局配置中添加用户邮箱
git config --global user.email "john@example.com"

# 查看特定配置的值（例如：用户名）
git config --get user.name

# 删除特定配置（例如：用户名）
git config --global --unset user.name

# 使用编辑器打开配置文件
git config --global --edit

# 查看配置值的来源
git config --show-origin user.name

git alias​

git alias 是一个非常实用的功能，它可以将常用的长命令简化为短别名，从而让操作更加高效。你可以通过 git config 命令来设置别名，也可以直接编辑 .gitconfig 文件进行配置。

1. 使用 git config 设置alias

# 设置别名（常用别名）
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.unstage 'reset HEAD --'  # 将文件从暂存区移除
git config --global alias.last 'log -1 HEAD'      # 查看最近一次提交
git config --global alias.amend 'commit --amend'  # 修改最近一次提交

# 查看所有别名
git config --get-regexp alias
# 删除别名
git config --global --unset alias.<别名>

# 使用示例
git co main          # 等同于 `git checkout main`
git br               # 等同于 `git branch`
git ci -m "提交信息"   # 等同于 `git commit -m "提交信息"`
git st               # 等同于 `git status`
git unstage file.txt # 等同于 `git reset HEAD file.txt`
git last             # 等同于 `git log -1 HEAD`
git amend            # 等同于 `git commit --amend`

2. 2. 通过配置文件 .gitconfig 设置alias 你也可以直接编辑 .gitconfig 文件来设置别名。.gitconfig 文件通常位于用户的主目录下（~/.gitconfig）。

[alias]
    co = checkout
    br = branch
    ci = commit
    st = status
    last = log -1 HEAD
    lg = log --oneline --graph --decorate --all

2. 创建仓库​

创建 Git 仓库的方式有两种：git init 和 git clone。

git init​

git init 是用于初始化一个新的 Git 仓库的命令。该命令会在当前目录或指定目录下创建一个名为 .git 的隐藏子目录，从而将该目录初始化为 Git 仓库。

使用示例：

# 在当前目录初始化一个新的 Git 仓库
git init

# 在指定目录初始化一个新的 Git 仓库
git init my-repo

# 初始化一个裸仓库（无工作目录）
git init --bare

# 初始化过程中减少输出信息
git init --quiet

# 指定初始分支名称进行初始化
git init --initial-branch develop

git clone​

git clone 是 Git 版本控制系统中用于将远程仓库（remote repository）克隆到本地仓库（local repository）的命令。该命令会将远程仓库的完整历史记录和文件复制到本地。

使用示例：

# 基本克隆
git clone https://github.com/user/repo.git

# 克隆到指定目录
git clone https://github.com/user/repo.git my-directory

# 仅克隆指定分支
git clone --single-branch --branch main https://github.com/user/repo.git

# 浅克隆（仅克隆最近一次提交）
git clone --depth 1 https://github.com/user/repo.git

# 克隆时包含子模块
git clone --recurse-submodules https://github.com/user/repo.git

# 克隆为裸仓库（无工作目录）
git clone --bare https://github.com/user/repo.git

# 克隆为镜像仓库
git clone --mirror https://github.com/user/repo.git

3. 变更跟踪与管理​

git status​

git status 是用于显示当前工作目录和暂存区状态的 Git 命令。通过该命令，可以一目了然地查看哪些文件被修改了，哪些文件已经准备好提交等。

git status 状态值说明:

git status 命令:

使用示例:

# 基本状态查看
git status

# 以简短格式查看状态
git status -s

# 查看分支信息
git status --branch

# 查看未跟踪文件的状态
git status --untracked-files=all

# 查看详细的状态信息
git status --verbose

git add​

git add 是将工作目录中的变更添加到暂存区（staging area）的命令。该命令用于准备提交的文件，使 Git 能够跟踪这些变更。

使用示例:

# 将特定文件添加到暂存区
git add file.txt

# 将当前目录的所有变更添加到暂存区
git add .

# 将工作目录的所有变更添加到暂存区
git add -A

# 仅将已跟踪文件的变更添加到暂存区
git add -u

# 以交互方式选择变更并添加到暂存区
git add --patch

# 强制将忽略的文件添加到暂存区
git add --force

git diff​

git diff 是 Git 中用于比较变更的命令。该命令用于查看工作目录、暂存区和提交之间的差异。它会以行为单位显示文件的添加、删除和修改。

使用示例:

# 查看工作目录和暂存区的差异
git diff

# 查看暂存区和最新提交的差异
git diff --cached

# 查看工作目录和最新提交的差异
git diff HEAD

# 查看工作目录和特定提交的差异
git diff abc1234

# 查看两个提交之间的差异
git diff abc1234 def5678

# 查看变更文件的统计信息
git diff --stat

# 仅查看变更文件的名称
git diff --name-only

# 查看变更文件的名称和状态
git diff --name-status

# 为输出添加颜色
git diff --color

# 以单词为单位查看差异
git diff --word-diff

# 忽略空格变更查看差异
git diff --ignore-space-change

# 仅查看特定状态的文件（例如：添加的文件）
git diff --diff-filter=A

# 检查空格错误
git diff --check

# 仅检查是否有差异（无输出）
git diff --quiet

git stash​

git stash 是用于临时保存当前工作目录中变更的命令。它将当前工作目录的变更保存到栈中，并将工作目录恢复到干净状态，以便进行其他操作。之后可以重新应用这些保存的变更。

• git stash 将工作目录的变更保存到栈中。
• 可以保存多个 stash，每个 stash 都有一个唯一的标识符（stash@{n}）。

使用示例:

# 临时保存当前工作目录中的变更
git stash

# 附带消息临时保存变更
git stash save "WIP: Working on feature X"

# 查看已保存的 stash 列表
git stash list

# 应用最近保存的 stash
git stash apply

# 应用特定的 stash
git stash apply stash@{1}

# 应用最近保存的 stash 并从栈中移除
git stash pop

# 移除最近保存的 stash
git stash drop

# 移除所有 stash
git stash clear

# 查看最近保存的 stash 的变更内容
git stash show

# 以补丁格式查看最近保存的 stash 的变更内容
git stash show -p

# 将未跟踪的文件也保存到 stash 中
git stash --include-untracked

git commit​

git commit 是将暂存区（staging area）中的文件变更保存到本地仓库的命令。每次提交代表一个逻辑上的变更单元，可以看作是工作的快照。

commit의 구성 요소:

• 提交哈希 (Commit Hash): 用于唯一标识提交的 40 位 SHA-1 哈希值。
  • 哈希值基于提交的内容（变更、作者、日期等）生成。
• 树对象 (Tree Object): 表示提交时工作目录结构的对象。
  • 树对象存储文件和目录的结构，并包含每个文件的哈希值。
  • 通过树对象可以重建提交时的文件状态。
• 父提交 (Parent Commit): 指向当前提交的上一个提交（父提交）的哈希值。
  • 通常有一个父提交，但合并提交可能有两个或多个父提交。
  • 通过父提交可以追踪提交历史。
• 作者 (Author): 创建提交的人的姓名和邮箱。
• 提交者 (Committer): 实际将提交记录到仓库的人的姓名和邮箱。（可能与作者不同）
• 提交日期 (Commit Date): 提交创建的日期和时间。
• 提交消息 (Commit Message): 对提交变更的描述。
• GPG 签名 (GPG Signature) (可选): 使用 --gpg-sign 选项为提交添加 GPG 签名，确保提交的完整性（是否被篡改）。

使用示例:

# 提交暂存区的变更（打开提交消息编辑器）
git commit

# 直接输入提交消息并提交
git commit -m "添加新功能"

# 自动暂存已跟踪文件的变更并提交
git commit -a -m "更新已跟踪文件"

# 修改最新提交（更改提交消息或添加文件）
git commit --amend

# 提交前不运行钩子脚本
git commit --no-verify -m "绕过钩子"

# 创建空提交（无变更提交）
git commit --allow-empty -m "空提交"

# 在提交消息中添加 Signed-off-by 行
git commit --signoff -m "添加签名"

# 不修改提交消息直接执行 --amend
git commit --amend --no-edit

# 创建用于修改特定提交的提交
git commit --fixup=abc1234

# 创建用于与特定提交合并的提交
git commit --squash=abc1234

git log​

git log 是用于查看 Git 仓库提交历史的命令。通过该命令可以查看提交的哈希值、作者、日期、提交消息等信息。

使用示例:

# 查看提交历史
git log

# 仅查看最近的 5 个提交
git log -n 5

# 以单行格式简要查看提交信息
git log --oneline

# 查看提交中变更文件的统计信息
git log --stat

# 以补丁格式查看提交中的变更内容
git log --patch

# 以图形格式查看提交历史
git log --graph

# 以美观格式输出提交信息
git log --pretty=oneline

# 仅查看特定日期之后的提交（例如：2023-10-01 之后）
git log --since="2023-10-01"

# 仅查看特定日期之前的提交（例如：2023-10-31 之前）
git log --until="2023-10-31"

# 仅查看特定作者的提交（例如：作者名为 "John"）
git log --author="John"

# 仅查看提交消息中匹配特定模式的提交（例如："bugfix"）
git log --grep="bugfix"

# 仅查看特定文件或目录的提交历史（例如：src/main.c）
git log -- src/main.c

# 排除合并提交
git log --no-merges

# 同时查看分支和标签信息
git log --decorate

# 缩短提交哈希值的显示
git log --abbrev-commit

# 仅查看变更文件的名称
git log --name-only

# 查看变更文件的名称和状态
git log --name-status

# 查看所有引用（分支、标签等）的提交历史
git log --all

git show​

git show 是用于显示特定提交、标签或树的详细信息的命令。该命令在查看提交的变更内容、作者、日期、提交消息等信息时非常有用。

使用示例:

# 显示特定提交的详细信息
git show abc1234

# 显示特定标签指向的提交的详细信息
git show v1.0.0

# 显示特定树的详细信息
git show HEAD:path/to/file

# 以单行格式简要显示提交信息
git show --oneline abc1234

# 显示提交中变更文件的统计信息
git show --stat abc1234

# 以补丁格式显示提交中的变更内容
git show --patch abc1234

# 仅显示变更文件的名称
git show --name-only abc1234

# 显示变更文件的名称和状态
git show --name-status abc1234

# 以自定义格式输出提交信息
git show --format="%h - %an, %ar : %s" abc1234

# 不显示补丁信息，仅显示提交消息
git show --no-patch abc1234

# 为输出添加颜色
git show --color abc1234

# 仅显示提交消息
git show --quiet abc1234

5. 分支管理​

git branch​

git branch 是 Git 中用于创建、查看和删除分支的命令。分支是分离和合并工作的核心功能，通过 git branch 可以有效地管理分支。

使用示例:

# 查看本地分支列表
git branch

# 创建新分支
git branch feature-branch

# 删除分支（仅可删除已合并的分支）
git branch -d feature-branch

# 强制删除分支（未合并的分支也可删除）
git branch -D feature-branch

# 重命名当前分支
git branch -m new-branch-name

# 查看所有分支（本地 + 远程）
git branch -a

# 查看远程分支列表
git branch -r

# 查看已合并到当前分支的分支列表
git branch --merged

# 查看未合并到当前分支的分支列表
git branch --no-merged

# 设置当前分支的上游分支
git branch --set-upstream-to=origin/main

# 取消当前分支的上游分支设置
git branch --unset-upstream

# 查看分支列表，并显示每个分支的最新提交消息
git branch --verbose

git checkout​

git checkout 是 Git 中用于切换分支或将工作目录恢复到特定提交或文件的命令。它广泛应用于分支切换、文件状态恢复、提交检出等操作。

尽管目前在 git --help 中已不再推荐使用该命令，但它仍然被广泛使用。

The git-checkout(1) command is seen by many as hard to understand because it connects two somewhat unrelated features: switching between branches and restoring worktree files from arbitrary revisions. In 2019, we thus implemented two new commands git-switch(1) and git-restore(1) to split out these separate concerns into standalone functions. (참고: Commit 028bb23)

意思是由于一个命令同时处理分支切换和文件恢复这两个不相关的功能，给用户带来了困惑。因此，从 Git 2.23 开始，git checkout 命令被拆分为 git switch 和 git restore 两个命令。

因为仍然被广泛使用，说目前没有弃用计划。

使用示例:

# 切换到指定分支
git checkout main

# 创建新分支并切换到该分支
git checkout -b feature-branch

# 将工作目录移动到指定提交（进入 Detached HEAD 状态）
git checkout abc1234

# 将工作目录中的指定文件恢复到最新提交状态
git checkout -- file.txt

# 将工作目录中的所有变更恢复到最新提交状态
git checkout .

# 强制将工作目录恢复到最新提交状态
git checkout -f

# 以交互方式选择变更并恢复
git checkout --patch

# 创建并切换到跟踪远程分支的本地分支
git checkout --track origin/feature-branch

# 将当前分支切换到 Detached HEAD 状态
git checkout --detach

# 在切换分支时，如果发生冲突则自动尝试合并
git checkout --merge feature-branch

git switch​

git switch 命令是 Git 2.23 版本引入的一个新命令，它的主要目的是为了取代传统的 git checkout 命令，提供一种更简洁、直观的分支切换方式。

为什么引入 git switch？

• 更清晰的命令意图: git switch 的命令名更明确地表达了它的功能，即切换分支。
• 减少歧义: git checkout 命令既可以用于创建新分支，也可以用于切换分支，这在某些情况下可能会导致混淆。
• 更符合直觉: switch 这个词在日常生活中更常用于表示切换，因此更容易记忆和理解。

使用示例:

# 切换到指定分支
git switch main

# 创建新分支并切换到该分支
git switch -c feature-branch

# 将工作目录移动到指定提交（进入 Detached HEAD 状态）
git switch --detach abc1234

# 创建并切换到跟踪远程分支的本地分支
git switch --track origin/feature-branch

# 即使发生冲突也强制切换分支
git switch --force feature-branch

# 在切换分支时，如果发生冲突则自动尝试合并
git switch --merge feature-branch

git merge​

git merge 是将两个分支的变更合并为一个的命令。通常用于将已完成功能开发的分支合并到主分支。合并可以通过 Fast-forward、3-way merge、Conflict Resolution(冲突解决)等多种方式完成。

合并方式：

Fast-forward merge: --ff vs --no-ff :

* 合并 feature 分支时：
  - main:    A --- B --- C
                      \
  - feature:           D --- E --- F

1. 执行 `git merge --no-ff feature`
  - main:    A --- B --- C ------------------- M
                      \                     /
  - feature:           D --- E --- F ---
  - 生成合并提交 M。
  - feature 分支的历史在 main 分支中完整保留。
  
2. 执行 `git merge --ff feature`（在快进合并条件下）
  - main:    A --- B --- C --- D --- E --- F
                      \
  - feature:           D --- E --- F
  - 不生成合并提交。
  - main 分支指向 feature 分支的最新提交。

使用示例:

# 将指定分支合并到当前分支
git merge feature-branch

# 禁用 Fast-forward 合并（始终生成新的合并提交）
git merge --no-ff feature-branch

# 仅允许 Fast-forward 合并（无法 Fast-forward 则中止）
git merge --ff-only feature-branch

# 将指定分支的变更压缩为一个提交并合并
git merge --squash feature-branch

# 合并过程中发生冲突时中止并恢复
git merge --abort

# 解决冲突后继续合并
git merge --continue

# 执行合并但不自动提交
git merge --no-commit feature-branch

# 合并后显示变更的统计信息
git merge --stat feature-branch

# 指定合并策略（例如：recursive）
git merge --strategy=recursive feature-branch

# 指定合并策略选项（例如：ours）
git merge --strategy-option=ours feature-branch

6. 远程仓库​

git remote​

git remote 是用于管理远程仓库的命令。可以通过该命令添加、查看、删除远程仓库，或修改远程仓库的 URL 等。

使用示例:

# 查看远程仓库列表
git remote

# 查看远程仓库列表及其 URL
git remote -v

# 添加新的远程仓库
git remote add origin https://github.com/user/repo.git

# 删除已注册的远程仓库
git remote remove origin

# 重命名远程仓库
git remote rename origin upstream

# 修改远程仓库的 URL
git remote set-url origin https://github.com/user/new-repo.git

# 查看特定远程仓库的详细信息
git remote show origin

# 清理本地不存在的远程分支
git remote prune origin

# 更新远程仓库的所有分支和标签
git remote update

# 查看特定远程仓库的 URL
git remote get-url origin

# 指定远程仓库中要跟踪的分支
git remote set-branches origin main

# 添加远程仓库并设置跟踪特定分支
git remote add --track main origin https://github.com/user/repo.git

git pull​

git pull 是将远程仓库的变更拉取到本地仓库并合并的命令。它是 git fetch 和 git merge 的组合，通常用于将远程分支的最新状态同步到本地。

使用示例:

# 拉取当前分支的远程仓库变更并合并
git pull

# 拉取指定远程仓库和分支的变更并合并
git pull origin main

# 拉取变更后执行变基
git pull --rebase

# 仅允许 Fast-forward 合并（无法 Fast-forward 则中止）
git pull --ff-only

# 禁用 Fast-forward 合并（始终生成新的合并提交）
git pull --no-ff

# 自动暂存工作目录中的变更，合并后再恢复
git pull --autostash

# 执行合并但不自动提交
git pull --no-commit

# 拉取远程仓库的所有标签
git pull --tags

# 不拉取标签
git pull --no-tags

git push​

git push 是将本地仓库的变更上传到远程仓库的命令。通常用于将本地的提交同步到远程仓库。可以推送分支、标签或特定提交。

使用示例:

# 推送当前分支的变更到远程仓库
git push

# 推送指定远程仓库和分支的变更
git push origin main

# 推送指定标签到远程仓库
git push origin v1.0.0

# 推送所有分支的变更到远程仓库
git push --all

# 推送所有标签到远程仓库
git push --tags

# 强制推送变更（注意：会覆盖远程仓库的现有提交）
git push --force

# 强制推送，但仅当远程分支与本地一致时才执行
git push --force-with-lease

# 删除远程仓库的指定分支
git push --delete origin old-branch

# 推送当前分支到远程仓库并设置为上游分支
git push --set-upstream origin feature-branch

# 模拟推送（仅显示将要推送的变更）
git push --dry-run

# 删除远程仓库中本地不存在的分支
git push --prune origin

# 推送前不运行钩子脚本
git push --no-verify

# 推送时自动推送所有相关的标签
git push --follow-tags

git fetch​

git fetch 是将远程仓库的变更拉取到本地仓库的命令。与 git pull 不同，fetch 不会自动合并变更。因此，它更安全，允许用户在需要时手动合并。

| 命令及选项                      | 说明                                                                                             |
|-------------------------------------|------------------------------------------------------------------------------------------------|
| `git fetch`                         | 拉取远程仓库的所有变更。                                                           |
| `git fetch <remote>`                | 拉取指定远程仓库的所有变更。                                                    |
| `git fetch <remote> <branch>`       | 拉取指定远程仓库的特定分支变更。                                                       |
| `git fetch --all`                   | 拉取所有远程仓库的数据。                                                              |
| `git fetch --prune`                 | 清理本地不存在的远程分支。                                                                  |
| `git fetch --tags`                  | 拉取远程仓库的所有标签。                                                                |
| `git fetch --force`                 | 强制拉取远程数据，覆盖本地分支的变更。                                   |

**使用示例:**

```bash
# 拉取远程仓库的所有变更
git fetch

# 拉取指定远程仓库的所有变更
git fetch origin

# 拉取指定远程仓库的特定分支变更
git fetch origin main

# 拉取所有远程仓库的变更
git fetch --all

# 清理本地不存在的远程分支
git fetch --prune

# 拉取远程仓库的所有标签
git fetch --tags

# 强制拉取远程数据，覆盖本地分支的变更
git fetch --force

7. 标签​

git tag​

git tag 是用于在特定提交上添加或管理标签的命令。标签通常用于标记发布版本（例如 v1.0.0），以便轻松引用提交。标签分为 Lightweight 标签和 Annotated 标签两种类型。

• Lightweight 标签: 仅是一个指向提交的名称，不包含额外信息（如消息、签名等）。通过 git tag <tagname> 创建。
• Annotated 标签: 包含标签名称、消息、签名、作者信息等。通常用于标记发布版本。通过 git tag -a <tagname> 创建。
• 标签推送: 默认情况下，标签不会通过 git push 推送到远程仓库。需要显式指定推送标签。（参考 git push）
• 删除(-d)本地标签后，若需删除远程仓库中的标签，需使用 git push <remote> --delete <tagname>。

使用示例:

# 查看所有标签列表
git tag

# 在当前提交上添加 Lightweight 标签
git tag v1.0.0

# 在当前提交上添加 Annotated 标签（需要输入消息）
git tag -a v1.0.0

# 添加 Annotated 标签并指定消息
git tag -a v1.0.0 -m "Release version 1.0.0"

# 在特定提交上添加标签
git tag v1.0.0 abc1234

# 删除特定标签
git tag -d v1.0.0

# 查看与特定模式匹配的标签列表（例如：v1.*）
git tag -l "v1.*"

# 查看包含特定提交的标签列表
git tag --contains abc1234

# 查看指向特定提交的标签列表
git tag --points-at abc1234

# 按版本顺序对标签列表排序
git tag --sort=version:refname

# 按逆序对标签列表排序
git tag --sort=-version:refname

# 强制覆盖现有标签（注意：不建议覆盖已发布的标签）
git tag -f v1.0.0

# 为标签添加 GPG 签名
git tag --sign v1.0.0

8. 提交记录（日志）​

🔗git log​

🔗git show​

git blame​

git blame 是用于查看特定文件中每一行最后一次修改的提交和作者的命令。该命令在追踪代码的特定部分由谁、何时修改时非常有用。

使用示例:

# 查看特定文件中每一行最后一次修改的提交和作者
git blame README.md

# 查看特定文件中第 10 行到第 20 行的修改记录
git blame -L 10,20 README.md

# 追踪文件中复制的代码的原始提交
git blame -C README.md

# 追踪文件中移动的代码的原始提交
git blame -M README.md

# 忽略空格变更，仅查看代码变更
git blame -w README.md

# 显示作者的电子邮件地址
git blame -e README.md

# 显示完整的提交哈希值
git blame -l README.md

# 显示提交的时间戳
git blame -t README.md

# 显示简短的提交哈希值
git blame -s README.md

# 忽略特定提交并显示结果
git blame --ignore-rev abc1234 README.md

# 忽略文件中列出的提交并显示结果
git blame --ignore-revs-file .git-blame-ignore-revs README.md

git reflog​

git reflog 是 Reference Logs 的缩写，用于显示 Git 中 HEAD 和分支的移动记录。该命令在恢复误删的分支或提交时非常有用。reflog 仅在本地仓库中保留，不会与远程仓库同步。

使用示例:

# 查看 HEAD 的移动记录
git reflog

# 查看特定分支的移动记录
git reflog main

# 查看所有引用（分支、标签等）的移动记录
git reflog --all

# 指定日期格式查看记录（例如：ISO 格式）
git reflog --date=iso

# 仅查看特定时间之后的记录（例如：2 周前）
git reflog --since=2.weeks.ago

# 仅查看特定时间之前的记录（例如：1 天前）
git reflog --until=1.day.ago

# 仅查看与特定模式匹配的记录（例如：包含 "merge" 的记录）
git reflog --grep=merge

9. 撤销修改及回退​

🔗git checkout​

git reset​

git reset 命令是 Git 中一个非常强大的命令，用于回退版本。它可以将当前 HEAD 指向不同的提交，从而达到撤销修改的目的。

reset 命令有三种模式，对工作区、暂存区有不同影响：

示例命令对比：

使用示例:

# 현재 브랜치의 HEAD를 특정 커밋으로 이동 (기본: --mixed)
git reset abc1234

# HEAD를 특정 커밋으로 이동하지만, 스테이징 영역과 작업 디렉토리는 변경하지 않음 (--soft)
git reset --soft abc1234

# HEAD를 특정 커밋으로 이동하고, 스테이징 영역을 리셋하지만 작업 디렉토리는 변경하지 않음 (--mixed)
git reset --mixed abc1234

# HEAD를 특정 커밋으로 이동하고, 스테이징 영역과 작업 디렉토리를 모두 리셋 (--hard)
git reset --hard abc1234

# 특정 파일을 스테이징 영역에서 제거
git reset file.txt

# 변경 사항을 인터랙티브하게 선택하여 스테이징 영역에서 제거
git reset --patch

# HEAD를 특정 커밋으로 이동하지만, 작업 디렉토리의 변경 사항을 유지 (--keep)
git reset --keep abc1234

git restore​

git restore 是 Git 2.23 版本引入的一个新命令，用于简化和改进文件恢复操作。它比 git checkout 和 git reset 命令更专注于恢复文件内容和工作区状态。

使用示例:

# 将工作目录中的文件恢复到最新提交状态
git restore file.txt

# 将暂存区中的文件恢复到最新提交状态
git restore --staged file.txt

# 将工作目录中的文件恢复到特定提交的状态
git restore --source=HEAD~2 file.txt

# 仅恢复工作目录中的文件（暂存区不会更改）
git restore --worktree file.txt

# 以交互方式选择更改并恢复
git restore --patch file.txt

# 恢复过程中减少输出
git restore --quiet file.txt

# 不恢复合并冲突的文件
git restore --ignore-unmerged file.txt

# 同时恢复子模块的更改
git restore --recurse-submodules

10. 리베이스​

git rebase​

git rebase 是用于重新构建分支提交历史的命令。它可以将当前分支的提交重新定位到另一个分支的最新提交上，从而创建更整洁的提交历史。通常用于替代 git merge，有助于保持提交历史的线性。

• 在 rebase 过程中发生冲突时，解决冲突后需运行 git rebase --continue。
• 在交互模式（-i）下，可以修改、删除、合并或重新排序提交。（例如，将 pick 改为 squash 可以将多个提交合并为一个。）