Firefly

Firefly 简单使用指南

Sun, 14 Jun 2026 00:00:00 GMT

这个博客模板是基于 Astro 构建的。对于本指南中未提及的内容，您可以在 Astro 文档中找到答案。

文章的 Front-matter#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
description: 这是我新 Astro 博客的第一篇文章。
5
image: ./cover.jpg
6
tags: [前端, 开发]
7
category: 前端开发
8
draft: false
9
---

属性	描述
`title`	文章标题。
`published`	文章发布日期。
`updated`	文章更新日期。如果未设置，将默认使用发布日期。
`pinned`	是否将此文章置顶在文章列表顶部。
`description`	文章的简短描述。显示在首页上。
`image`	文章封面图片路径。 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：`public` 目录中的图片 3. 不带任何前缀：相对于 markdown 文件的路径
`tags`	文章标签。
`category`	文章分类。
`lang`	文章语言代码（如 `zh-CN`）。仅当文章语言与站点默认语言不同时设置。
`licenseName`	文章内容的许可证名称。
`licenseUrl`	文章内容的许可证链接。
`author`	文章作者。
`sourceLink`	文章内容的来源链接或参考。
`draft`	如果这篇文章仍是草稿，则不会显示。
`comment`	是否启用此文章的评论功能。默认为 `true`。
`slug`	自定义文章 URL 路径。如果不设置，将使用文件名作为 URL。
`password`	文章密码。设置后文章内容将被 AES-256-GCM 加密，访客需输入密码才能查看。
`passwordHint`	密码提示。显示在密码输入框上方，帮助访客回忆密码，也可以不加。

文章文件的放置位置#

您的文章文件应放置在 src/content/posts/ 目录中。您也可以创建子目录来更好地组织您的文章和资源。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。

Slug 使用示例#

示例 1：使用文件名作为 URL#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/my-first-blog-post

示例 2：自定义 Slug#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
slug: hello-world
5
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/hello-world

示例 3：其他语言文件名使用Slug#

1
---
2
title: 如何使用 Firefly 博客主题
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

文件：src/content/posts/如何使用Firefly博客主题.md

URL：/posts/how-to-use-firefly-blog-theme

Slug 使用建议#

使用英文和连字符：my-awesome-post 而不是 my awesome post
保持简洁：避免过长的 slug
具有描述性：让 URL 能够反映文章内容
避免特殊字符：只使用字母、数字和连字符
保持一致性：在整个博客中使用相似的命名模式

注意事项#

Slug 一旦设置并发布，建议不要随意更改，以免影响 SEO 和已存在的链接
如果多个文章使用相同的 slug，后面的文章会覆盖前面的
Slug 会自动转换为小写

Firefly 博客官方指南

Fri, 12 Jun 2026 00:00:00 GMT

1. Markdown 基础语法#

来源：[[markdown-tutorial]]

Firefly 完整支持 CommonMark 与 GFM（GitHub Flavored Markdown）规范。

1.1 块级元素#

段落与换行#

段落之间用空行分隔，段内换行在行末添加两个空格。

标题#

支持两种写法：

1
# ATX 风格标题（推荐）
2
###### 最多支持六级
3

4
Setext 风格标题
5
================（h1 用 =）
6
Setext 风格标题
7
----------------（h2 用 -）

引用块#

1
> 单层引用
2
>
3
> > 嵌套引用
4
>
5
> 引用中可以包含 **Markdown** 语法、列表、代码块等。

列表#

1
- 无序列表（*、+、- 均可）
2
- 嵌套列表
3
  - 子项
4

5
1. 有序列表
6
2. 第二项
7
   1. 嵌套有序列表

注意：数字后紧跟 . 可能被误识别为有序列表（如 1986.），需转义为 1986\.。

代码块#

1
```javascript
2
// 带语法高亮的围栏代码块
3
console.log('Hello Firefly!');
4
```
5

6
    // 缩进式代码块（4空格或1Tab）
7
    indent code here

表格#

1
| 左对齐 | 居中对齐 | 右对齐 |
2
| :----- | :------: | -----: |
3
| cell   |  cell    |   cell |

水平分割线#

1
---
2
***
3
___

1.2 行内元素#

元素	语法	效果
斜体	`text` 或 `_text_`	text
粗体	`text` 或 `__text__`	text
行内代码	`code`	`code`
删除线	`~~text~~`（GFM）	text
链接	`[text](url "title")`	text
图片	`![alt](url "title")`	图片
自动链接	`<https://example.com>`	自动生成链接

参考式链接#

1
[链接文本][id]
2

3
[id]: https://example.com "可选标题"

1.3 转义字符#

以下字符可用反斜杠转义：

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

1.4 内嵌 HTML#

Markdown 中可直接使用 HTML 标签：

块级标签（如 <div>）内部的 Markdown 语法不会被解析
行内标签（如 <span>）内部的 Markdown 语法正常解析

2. 代码块与 Expressive Code#

来源：[[code-examples]]

Firefly 集成 Expressive Code，提供强大的代码展示能力。

2.1 语法高亮#

支持所有主流语言的语法高亮，以及 ANSI 转义序列渲染：

Terminal window

1
标准颜色: [31m红色[0m [32m绿色[0m [33m黄色[0m
2
256色:    [38;5;82m亮绿[0m [38;5;200m亮紫[0m
3
24位真彩:  [38;2;255;128;0m橙色渐变[0m
4
字体样式:  [1m粗体[0m [2m暗淡[0m [3m斜体[0m [4m下划线[0m [7m反转[0m [9m删除线[0m

2.2 编辑器与终端框架#

1
```js title="config.js"
2
// 自动显示为编辑器框架（带文件名标签）
3
```
4

5
```bash title="安装依赖"
6
npm install
7
```
8

9
```text frame="none"
10
// frame="none" 隐藏框架
11
```

2.3 行标记与文本标记#

1
```js {1, 3-5} mark={2} ins={6} del={7}
2
// 支持按行号标记
3
// mark - 高亮行
4
// ins - 插入行（绿色）
5
// del - 删除行（红色）
6
```

还支持：

Diff 语法：+ 标记新增，- 标记删除
行内文本标记：用 // [!code highlight] 等指令标记具体文本
标签标注：为标记行添加自定义标签
正则匹配：用正则表达式匹配并标记文本

2.4 自动换行与折叠#

1
```js wrap=true preserveIndent=true
2
// 自动换行 + 保持缩进
3
```
4

5
```js collapse={2-10}
6
// 折叠指定行范围
7
```

2.5 行号控制#

1
```js showLineNumbers=false
2
// 隐藏行号
3
```
4

5
```js startLineNumber=42
6
// 从第 42 行开始编号
7
```

3. Markdown 扩展功能#

来源：[[markdown-extended]]

3.1 GitHub 仓库卡片#

1
::github{repo="CuteLeaf/Firefly"}

页面加载时自动从 GitHub API 获取仓库信息，展示为精美卡片。

3.2 提示框 / 告示框（Admonitions）#

Firefly 支持三种主题风格，配置于 src/config/siteConfig.ts：

GitHub 主题#

1
> [!NOTE]
2
> 这是注释
3

4
> [!TIP]
5
> 自定义标题
6
> 这是提示
7

8
> [!IMPORTANT]
9
> 这是重要信息
10

11
> [!WARNING]
12
> 这是警告
13

14
> [!CAUTION]
15
> 这是注意

展开收起

Obsidian 主题（最丰富）#

支持全部类型与别名：

类型	别名
NOTE	-
ABSTRACT	summary, tldr
INFO	todo
TIP	hint, important
SUCCESS	check, done
QUESTION	help, faq
WARNING	caution, attention
FAILURE	fail, missing
DANGER	error
BUG	-
EXAMPLE	-
QUOTE	cite

VitePress 主题#

与 GitHub 主题相同的 5 种类型，采用现代扁平化设计风格。

Docusaurus 语法兼容#

1
:::note
2
Docusaurus 风格语法，视觉效果复用上述三种主题。
3
:::
4

5
:::tip 自定义标题
6
带自定义标题的提示框。
7
:::

3.3 剧透文本#

1
:spoiler[这是隐藏内容，鼠标悬停可见]

支持内部 Markdown 格式化。

3.4 图片画廊网格#

1
[grid]
2
图片1
3
图片2
4
图片3
5
[/grid]

最多支持 4 张图片并排显示，自动高度匹配，支持灯箱放大查看。

4. MDX 格式文章#

来源：[[mdx-example]]

Firefly 同时支持 .md 和 .mdx 格式。MDX 允许在 Markdown 中使用 JSX 和组件导入。

4.1 MDX vs Markdown#

特性	Markdown (.md)	MDX (.mdx)
基础语法（CommonMark）	✅	✅
HTML 标签	✅	✅
组件导入	❌	✅
动态数据	❌	✅
样式定制	基础	完整

4.2 使用组件#

1
import { Icon } from 'astro-icon/components'
2

3
<Icon name="rocket" class="w-6 h-6 text-blue-500" />

4.3 JSX 表达式#

1
export const year = new Date().getFullYear()
2

3
当前年份是 {year}

4.4 自定义样式#

1
<div className="bg-blue-100 p-4 rounded-lg">
2
  注意：MDX 中使用 `className` 而非 `class`
3
</div>

建议：如果不需要组件和动态数据，优先使用 .md 格式更简洁。

本文融合自以下官方示例文章：

[[markdown-tutorial]] — Markdown 基础语法教程

[[code-examples]] — 代码块示例

[[markdown-extended]] — 扩展功能

[[mdx-example]] — MDX 格式示例

markdown + firefly 浓缩语法

Sun, 14 Jun 2026 00:00:00 GMT

列表#

Markdown 支持有序（数字）与无序（圆点）列表。

无序列表#

HTML 标签：<ul>

无序列表可使用 星号 (*)、加号 (+) 或 短横线 (-)。

有序列表#

HTML 标签：<ol>

有序列表使用数字加英文句点：

obsidian首行缩进代码css

Sat, 13 Jun 2026 00:00:00 GMT

1
/* === 段落-首行缩进2个字符 By Linzeal 2024/2/1更新 === */
2

3
/* 也包括段落中每个回车换行后的首行缩进 */
4

5
:is(
6
.markdown-source-view .cm-line:not(:is(:has(>.cm-hmd-frontmatter,>br),.HyperMD-header,.HyperMD-list-line,.HyperMD-quote,table .cm-line)), /* 编辑模式 */
7
.markdown-rendered :not(:is(blockquote)) > p /* 阅读模式 text-indent不支持each-line的办法 */
8
){
9
  text-indent: 2em !important;
10
}
11

12
.markdown-rendered :not(:is(blockquote)) > p
13
{
14
  /*text-indent: 2em each-line !important; 若支持each-line参数则用这个即可，更为简单，就无需下面的修正 */
15
}
16

17
/* 阅读模式下对每个回车换行后的首行缩进的修正 */
18
.markdown-rendered :not(:is(blockquote)) > p > br
19
{
20
  content:'';
21
  white-space:pre;
22
}
23
.markdown-rendered :not(:is(blockquote)) > p > br::after
24
{
25
  content:'\000A\0009\00A0\00A0'; /* Unicode字符编码\0009表示水平制表符，\00A0表示不换行空格，可通过增减、组合搭配这两个Unicode字符来微调回车换行后的首行缩进量 */
26
}
27

28
/* === CSS代码结束 === */

展开收起

日记 · 2026-06-13

Sat, 13 Jun 2026 00:00:00 GMT

🌤️ 2026年06月13日星期六#

[!quote] 💭 今日一句话又混了一天，爽😋

一、🌅 今日概览#

属性	内容
🌡️ 天气	晴 ☀️
💫 心情	😊 开心
📅 星期	星期六
⏰ 起床时间	09:03

二、📝 今日记录#

🌄 上午#

起床，学习了一下 python，学习完了数据容器

🌇 下午#

整了一下午的 win 11 美化，用到了 windhawk 以及 b 站一个大学卷哥的学弟二次开发的一个 mod：ZenDesktop_OneKeyDeploy_v4.0.0 ![电脑截图](./images/Pasted image 20260613235042.png)

🌙 晚上#

没学啥，聊了会天，下了暴风雨，巨吓人，随后整了一下 obsidian 的插件，easy typing 插件好用，复制了一个段落首行缩进 css 代码 [[obsidian首行缩进代码css]]，速度二刷了一下 git 重要知识，写了 git教程 [gitignore] (gitignore 详解)

三、📖 今日所学#

💡 新知识 & 收获

python 数据容器
学习了 git 开发

四、🔮 TODO & 明日计划#

📋 TODO

先把博客部署流程整完
每天把苍穹外卖写了
其次把功能测试/性能测试/接口测试学完。

🌙 晚安，今天辛苦啦，明天也要加油鸭～

Git 常用命令速查与分支操作指南

Sat, 13 Jun 2026 00:00:00 GMT

[!abstract] 摘要本文整理了 Git 日常高频命令的用法与分支管理的完整操作流程。面向二刷复习，注重快速上手和遗忘提醒。附带常见踩坑记录。
参考教程：CSDN Git 教程｜ B 站：黑马程序员 Git 全套教程

1. 基本命令（重要/易忘）#

1.1 `git init` — 初始化仓库#

作用：在当前目录创建 .git 子藏目录，使其成为一个 Git 仓库。

Terminal window

1
# 在当前目录初始化
2
git init
3

4
# 指定目录名初始化
5
git init my-project

提示

执行后当前目录下会多出一个隐藏的 .git 文件夹，不要手动修改或删除它，它是 Git 的”大脑”。

1.2 `git status` — 查看工作区状态#

作用：查看当前哪些文件被修改、暂存、未跟踪，是最常用的”侦察兵”命令。

Terminal window

1
git status
2

3
# 简洁模式（一目了然）
4
git status -s
5
# 输出示例：
6
# M  src/main.java    ← 已暂存（绿色 M 在左列）
7
#  M src/utils.java   ← 已修改未暂存（红色 M 在右列）
8
# ?? temp.txt         ← 未跟踪的新文件

状态标识速记

标识	含义
`??`	未跟踪（新文件）
`A`	新增到暂存区
`M`	已修改
`D`	已删除
`R`	重命名

1.3 `git log` — 查看提交历史#

作用：查看仓库的提交记录，默认按时间倒序。

Terminal window展开收起

1
# 基本查看
2
git log
3

4
# 单行简洁模式（最常用⭐）
5
git log --oneline
6

7
# 图形化分支结构（强烈推荐⭐⭐）
8
git log --oneline --graph --all
9

10
# 查看最近 N 条
11
git log -5
12

13
# 查看某文件的修改历史
14
git log -- path/to/file.java
15

16
# 搜索提交信息关键词
17
git log --grep="fix" --oneline

展开收起

实用组合

习惯性使用 git log --oneline --graph --all，一张图看清所有分支的走向和合并情况。

1.4 `git reset` — 版本回退#

作用：将 HEAD 指针移动到指定提交，用于撤销提交或回退版本。

Terminal window

1
# 回退到某个 commit，修改保留在暂存区
2
git reset --soft <commit-hash>
3

4
# 回退到某个 commit，修改保留在工作区（默认模式）⭐最常用
5
git reset --mixed <commit-hash>
6
# 等价于
7
git reset <commit-hash>
8

9
# 回退到某个 commit，修改全部丢弃（慎用⚠️）
10
git reset --hard <commit-hash>
11

12
# 回退最近一次提交，保留修改在工作区
13
git reset HEAD~1

--hard 慎用

--hard 会彻底丢弃工作区和暂存区的修改，无法找回。不确定时优先用 --soft 或 --mixed。

三种模式对比：

模式	HEAD 指针	暂存区	工作区	适用场景
`--soft`	✅ 移动	❌ 不动	❌ 不动	合并多个提交为一个
`--mixed`	✅ 移动	✅ 重置	❌ 不动	撤销提交，重新挑选暂存
`--hard`	✅ 移动	✅ 重置	✅ 重置	彻底回退，丢弃所有修改

1.5 `git merge` — 合并分支#

作用：将指定分支的修改合并到当前分支。

Terminal window

1
# 将 feature 分支合并到当前分支
2
git merge feature
3

4
# 合并后有冲突？解决后继续
5
git merge --continue
6

7
# 放弃本次合并
8
git merge --abort

冲突解决流程：

执行 git merge 后出现 CONFLICT 提示
打开冲突文件，找到 <<<<<<< / ======= / >>>>>>> 标记
手动选择保留的内容，删除冲突标记
git add <冲突文件> → git commit

VSCode 用户

VSCode 会高亮显示冲突区域，并提供 “Accept Current” / “Accept Incoming” / “Accept Both” 的快捷按钮，解决后直接提交即可。

1.6 `git diff` — 查看差异#

作用：比较文件在不同状态之间的差异，日常排查修改利器。

Terminal window

1
# 工作区 vs 暂存区（未 add 的改动）
2
git diff
3

4
# 暂存区 vs 最新提交（已 add 但未 commit 的改动）
5
git diff --staged
6

7
# 比较两个分支的差异
8
git diff main..feature
9

10
# 只看文件名（不看具体差异）
11
git diff --name-only main..feature

2. 分支管理 ⭐#

2.1 `git branch` 基本操作#

Terminal window

1
# 查看所有本地分支
2
git branch
3

4
# 查看所有分支（含远程）
5
git branch -a
6

7
# 创建新分支
8
git branch feature
9

10
# 删除分支（已合并的）
11
git branch -d feature
12

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

2.2 分支切换与创建#

Terminal window

1
# 切换分支
2
git checkout feature
3
# 或新版写法（推荐⭐）
4
git switch feature
5

6
# 创建并切换到新分支
7
git checkout -b feature
8
# 或新版写法（推荐⭐）
9
git switch -c feature

switch vs checkout

git checkout 职责过多（切分支、恢复文件、切换 HEAD），Git 2.23+ 引入 switch 专门用于分支切换，语义更清晰。

2.3 合并分支 ⭐#

Terminal window

1
# 切回主分支，合并 feature
2
git switch main
3
git merge feature
4

5
# 合并后删除 feature 分支
6
git branch -d feature

合并策略示意：

1
# 快进合并（Fast-Forward）— feature 直接领先于 main
2
main ──●──●          main ──●──●──● (fast-forward)
3
              └──●    feature ─────┘
4

5
# 三方合并（3-Way Merge）— 双方都有新提交
6
main  ──●──●──┐
7
               ├──● (merge commit)
8
feature ──●──●─┘

2.4 同步远程分支 ⭐#

Terminal window展开收起

1
# 查看远程仓库信息
2
git remote -v
3

4
# 拉取远程最新代码（不合并）
5
git fetch origin
6

7
# 拉取并合并到当前分支
8
git pull origin main
9

10
# 推送本地分支到远程
11
git push origin main
12

13
# 首次推送并绑定上游分支⭐
14
git push -u origin main
15
# 后续直接 git push 即可

展开收起

fetch vs pull

git fetch：只下载远程更新，不自动合并，安全可控
git pull = git fetch + git merge，一步到位但可能产生意外冲突

3. 踩坑记录#

3.1 绑定上游分支#

遇到 fatal: The current branch main has no upstream branch 报错时：

Terminal window

1
# 把本地 main 绑定到远程 study 仓库的 main 分支
2
git branch --set-upstream-to=study/main main

等价操作：首次推送使用 -u 参数：

Terminal window

1
git push -u study main

3.2 首次拉取无关历史报错#

fatal: refusing to merge unrelated histories — 两个仓库没有共同祖先时触发。

Terminal window

1
# 加 --allow-unrelated-histories 解决
2
git pull study main --allow-unrelated-histories
3

4
# 如果同时需要拉取标签
5
git pull study main --tags --allow-unrelated-histories

注意

此参数仅首次对接时需要，后续正常 pull 无需再加。

3.3 合并冲突处理#

VSCode 图形界面会高亮冲突区域
选择保留当前（Current）或传入（Incoming）的内容
确认后 git add . → git commit 提交合并结果

4. Tag 标签管理#

作用：标记版本节点（如 v1.0、正式版、里程碑），只读，不随代码频繁改动。

Terminal window展开收起

1
# 查看所有标签
2
git tag
3

4
# 创建轻量标签
5
git tag v1.0
6

7
# 创建附注标签（推荐⭐，包含作者和备注）
8
git tag -a v1.0 -m "第一个正式版本"
9

10
# 给历史提交打标签
11
git tag -a v0.9 abc1234
12

13
# 推送标签到远程
14
git push origin v1.0
15

16
# 推送所有标签
17
git push origin --tags
18

19
# 删除本地标签
20
git tag -d v1.0
21

22
# 删除远程标签
23
git push origin --delete v1.0

展开收起

--tags 参数

git pull --tags 可以在拉取代码的同时拉取所有远程标签，常用于版本同步。

5. `.gitignore` 速查#

详见 → [[gitignore详解]]

1
# 快速模板
2
.idea/
3
.vscode/
4
node_modules/
5
dist/
6
*.log
7
.env

已跟踪文件的坑

已经 git add / git commit 过的文件，即使写入 .gitignore 也不会生效。需要先解除跟踪：

Terminal window

1
git rm -r --cached <文件或目录>
2
git commit -m "解除跟踪"

Python 浓缩笔记

Sat, 13 Jun 2026 00:00:00 GMT

1、变量名没类型，其值有类型 type()

2、算数运算符

3、复合赋值运算符

4、格式化

print % 用法：
- 单个：'xxx' %
- 多个：'xxx' %(?, ?)
f'内容{变量}'：不做精度控制，也不理会类型，适用于快速格式化字符串

5、input() ==== scanf()

6、for 循环等于增强版 Java for 循环：

1
name = '邢俊杰大佬'
2
for x in name:
3
    print(x)

7、range() 用法： 3 种：range(a) 、range(a, b) 、range(a, b, c)（步长 c）

8、None 类型

如果函数没有使用 return 语句返回数据，实际上是有返回值的。 Python 中有一个特殊的字面量：None，其类型是 <class 'NoneType'>。无返回值的函数，实际上就是返回了 None。 None 表示：空的、无实际意义。可以主动使用 return None，效果等同于不写 return 语句。

None 的应用场景：

用在函数无返回值上
用在 if 判断上——在 if 判断中，None 等同于 False
一般用于在函数中主动返回 None，配合 if 判断做相关处理
用在声明无内容的变量上——定义变量但暂时不需要具体值，可以用 None 代替，如：name = None

9、⭐数据容器

列表#

列表的常用操作（方法）具有反向索引#

tuple 元组#

元组定义：定义元组使用小括号，且使用逗号隔开各个数据，数据可以是不同的数据类型。

1
# 定义元组字面量
2
(元素, 元素, ..., 元素)
3

4
# 定义元组数量
5
变量名称 = (元素, 元素, ..., 元素)
6

7
# 定义空元组
8
变量名称 = ()          # 方式一
9
变量名称 = tuple()     # 方式二

注：

元组只有一个数据时，这个数据后面要添加逗号，否则不是元组类型！
元组也支持嵌套

可以容纳多个数据
可以容纳不同类型的数据（混装）
数据是有序存储的（下标索引）
允许重复数据存在
不可以修改（增加或删除元素等）
支持 for 循环

1
test = (1, 2, 3, 4, [5, 6, 7], [8, 9, 10])
2
# test[5] -> [8, 9, 10]
3
print(test[5][2])  # 结果 10

字符串#

split 语法：字符串.split(分隔符字符串)

注意

字符串本身不变，而是得到了一个新的列表对象

1
my_str = "hello python itCSDN itlove"
2
my_str_list = my_str.split(" ")
3
print(f"将字符串{my_str}进行split切分后得到：{my_str_list}, 类型是：{type(my_str_list)}")

replace 将字符串1替换为字符串2，语法：字符串.replace(字符串1, 字符串2)

`strip` 语法：`字符串.strip()` — 不传入参数时，去除首尾空格#

集合#

特点：去重、无序、不同类型混装、支持 for 循环

定义：

集合的常用操作： #

序列#

列表、tuple、字符串

字典#

特点：键值对之间逗号间隔，任意类型，key 去重，不下标。键值对 key: value 三者结合被称为键值对。

Various Complements 插件设置中文说明

Fri, 12 Jun 2026 00:00:00 GMT

Various Complements 插件设置中文说明#

插件版本: v11.3.0 功能: 像 IDE 一样提供智能自动补全功能

📋 设置概览#

打开 Obsidian → 设置 → Community plugins → Various Complements 进行配置

1. 🔧 主设置 (Main)#

核心补全策略#

设置项	英文名	默认值	说明
分词策略	Strategy	`default`	如何拆分单词进行补全。可选：`default`(默认)、`chinese`(中文)、`arabic` 等
匹配策略	Match Strategy	`prefix`	可选：`prefix`(前缀匹配，快) 或 `partial`(部分匹配，慢10倍+)
模糊匹配	Fuzzy Match	`✅ 开启`	允许拼写错误时也能匹配，如 “appl” 匹配 “apple”
最小模糊匹配分数	Min Fuzzy Match Score	`0.5`	模糊匹配的最低相似度阈值 (0-1)，越高越严格
忽略 Emoji 匹配	Matching without Emoji	`✅ 开启`	匹配时忽略单词中的 Emoji 表情
将重音视为字母	Treat accent diacritics as alphabetic	`❌ 关闭`	如开启，`cafe` 可匹配 `café`
下划线视为单词一部分	Treat underscore as part of word	`❌ 关闭`	如开启，`my_var` 视为一个单词而非两个

补全触发行为#

设置项	英文名	默认值	说明
最大建议数量	Max number of suggestions	`5`	补全弹窗显示的最大候选词数量
短语最大单词数	Max number of words as phrase	`3`	补全时考虑的最大短语长度（单词数）
触发最小字符数	Min number of characters triggered	`0`	输入多少字符后触发补全 (0=立即)
短语触发最小单词数	Min number of words triggered phrase	`1`	触发短语补全需要的最少单词数
自动补全	Complement automatically	`✅ 开启`	输入时自动弹出补全建议
延迟毫秒数	Delay milliseconds	`0`	触发补全前的等待时间（毫秒），可避免过于频繁的触发
IME 开启时禁用建议	Disable suggestions during IME on	`❌ 关闭`	使用中文/日文输入法时禁用补全
数学公式块禁用	Disable suggestions in Math block	`❌ 关闭`	在 `$$...$$` 数学公式内禁用补全
代码块禁用	Disable suggestions in Code block	`❌ 关闭`	在 ``` 代码块内禁用补全
补全后插入空格	Insert space after completion	`❌ 关闭`	选择补全词后自动添加空格
禁用补全的首字符	First characters disable suggestions	`: /^`	以这些字符开头的行禁用补全
禁用触发的正则模式	Patterns to suppress trigger	`^~~~.`, ^ ```.	匹配这些正则的行禁用触发
自动聚焦直到循环	No auto focus until cycle	`❌ 关闭`	如开启，第一个候选词不会自动高亮

2. 🎨 外观设置 (Appearance)#

设置项	英文名	默认值	说明
显示匹配策略	Show match strategy	`❌ 关闭`	在建议中显示匹配类型（前缀/部分/模糊）
自动显示补全	Show complement automatically	`❌ 关闭`	是否自动显示补全列表
显示索引状态	Show indexing status	`❌ 关闭`	显示单词索引的加载状态
建议中的描述	Description on suggestion	`Short`	可选：`None`(无)、`Short`(简短)、`Full`(完整)

3. ⌨️ 快捷键自定义 (Key Customization)#

操作	英文名	默认键	说明
选择	select	`Enter`	选择当前高亮的补全词
选择并自定义别名	select with custom alias	(空)	选择时弹出对话框让你输入别名
选择并添加到别名	select with custom alias and add to aliases	(空)	选择并永久添加别名
选择查询别名	select with query alias	(空)	使用查询结果作为别名
向上	up	`↑`	在补全列表中向上移动
向下	down	`↓`	在补全列表中向下移动
选择第 1-9 个	select 1st ~ 9th	(空)	直接选择第 N 个候选词
打开	open	(空)	打开补全面板
补全	completion	(空)	手动触发补全
插入为文本	insert as text	(空)	将选中的链接作为纯文本插入
传播 Esc	Propagate Esc	`❌ 关闭`	按 Esc 时是否传播到父元素

4. 📄 当前文件补全 (Current File Complement)#

从当前正在编辑的文件中提取单词进行补全

设置项	英文名	默认值	说明
启用当前文件补全	Enable current file complement	`✅ 开启`	从当前文件中提取单词进行补全
最小字符数	Current file min number of characters	`0`	触发当前文件补全的最小字符数
仅补全英文	Only complement English on current file	`❌ 关闭`	只补全英文单词，忽略中文等
排除单词模式	Exclude current file word patterns	(空)	正则表达式，匹配的单词不参与补全

5. 📚 当前仓库补全 (Current Vault Complement)#

从整个 Obsidian 仓库的所有文件中提取单词进行补全

设置项	英文名	默认值	说明
启用仓库补全	Enable current vault complement	`❌ 关闭`	⚠️ 默认关闭，开启后会扫描整个仓库
最小字符数	Current vault min number of characters	`0`	触发仓库补全的最小字符数
包含路径前缀	Include current vault path prefix patterns	(空)	只包含指定路径开头的文件
排除路径前缀	Exclude current vault path prefix patterns	(空)	排除指定路径开头的文件
排除路径 Glob 模式	Exclude current vault path glob patterns	(空)	使用 Glob 模式排除文件
仅当前目录	Only files under current directory	`❌ 关闭`	只从当前文件所在目录补全
排除单词模式	Exclude current vault word patterns	(空)	正则表达式，匹配的单词不参与补全

6. 📖 自定义词典补全 (Custom Dictionary Complement)#

使用自定义词典文件进行补全（支持远程 URL）

设置项	英文名	默认值	说明
启用自定义词典	Enable custom dictionary complement	`❌ 关闭`	⚠️ 默认关闭
词典路径	Custom dictionary paths	Google 10000 英文词典 URL	支持本地路径或远程 URL，多个用逗号分隔
列分隔符	Column delimiter	`Tab`	词典文件中列之间的分隔符
单词正则模式	Custom dictionary word regex pattern	(空)	从词典中提取单词的正则表达式
隐藏建议的分隔符	Delimiter to hide suggestion	(空)	指定后该分隔符后的内容不会显示在建议中
显示/插入分隔符	Delimiter to divide display/insertion	(空)	分隔显示文本和实际插入文本
补全后光标位置符号	Caret location symbol after complement	(空)	标记补全后光标应放置的位置
显示文本后缀	Displayed text suffix	`=> ...`	建议列表中显示文本的后缀

7. 🔗 内部链接补全 (Internal Link Complement)#

补全 Obsidian 内部链接 [[...]]

设置项	英文名	默认值	说明
启用内部链接补全	Enable internal link complement	`✅ 开启`	补全 Obsidian 内部链接
使用别名建议	Suggest internal link with alias	`❌ 关闭`	在建议中显示链接别名
保持首字母大小写	Preserve first letter case	`❌ 关闭`	插入链接时保持原文件名首字母大小写
排除路径前缀	Exclude internal link path prefix patterns	(空)	排除指定路径开头的文件链接
排除路径 Glob 模式	Exclude internal link path glob patterns	(空)	使用 Glob 模式排除文件链接
排除自身链接	Exclude self internal link	`❌ 关闭`	不建议当前文件自身的链接
排除已有链接	Exclude existing in active file	`❌ 关闭`	排除当前文件中已存在的链接
排除未解析链接	Exclude unresolved internal links	`❌ 关闭`	排除指向不存在文件的链接
保存时更新链接	Update internal links on save	`✅ 开启`	保存文件时自动更新内部链接索引
插入别名转换	Insert alias transformed from displayed	`❌ 关闭`	将显示的链接名转换为别名插入
Front Matter 排除键	Front matter key for exclusion	(空)	指定 Front Matter 键来排除文件
排除的标签	Tags for exclusion internal link	(空)	排除带有指定标签的文件链接

8. 📝 Front Matter 补全 (Front Matter Complement)#

补全 YAML Front Matter 中的键值

设置项	英文名	默认值	说明
启用 Front Matter 补全	Enable front matter complement	`❌ 关闭`	补全 Front Matter 中的键和值
匹配策略	Front matter complement match strategy	`inherit`	`inherit`=继承主设置，或单独指定 `prefix`/`partial`
补全后插入逗号	Insert comma after front matter completion	`❌ 关闭`	选择 Front Matter 值后自动添加逗号

9. 🧠 智能建议优先级 (Intelligent Suggestion Prioritization)#

根据使用历史智能排序建议

设置项	英文名	默认值	说明
启用智能优先级	Enabled	`✅ 开启`	根据使用频率智能排序建议
历史文件路径	History file path	(空)	留空则使用默认路径 `.obsidian/plugins/various-complements/histories.json`
美化历史文件	Pretty print history file	`❌ 关闭`	将历史文件格式化为易读的 JSON
保留历史天数	Max days to keep history	`30`	超过指定天数的历史记录自动删除
保留历史数量	Max number of history to keep	`0`	保留的历史记录条数 (0=不限制)

10. 📱 移动端设置 (Mobile)#

设置项	英文名	默认值	说明
移动端禁用	Disable on mobile	`❌ 关闭`	在移动设备上完全禁用此插件

11. 🐛 调试设置 (Debug)#

设置项	英文名	默认值	说明
显示性能日志	Show log about performance in console	`❌ 关闭`	在开发者控制台显示性能调试信息

💡 推荐配置#

通用配置（适合大多数人）#

1
{
2
  "strategy": "default",
3
  "matchStrategy": "prefix",
4
  "fuzzyMatch": true,
5
  "maxNumberOfSuggestions": 6,
6
  "complementAutomatically": true,
7
  "enableCurrentFileComplement": true,
8
  "enableInternalLinkComplement": true,
9
  "enableCurrentVaultComplement": false,
10
  "descriptionOnSuggestion": "Short"
11
}

中文用户专用#

1
{
2
  "strategy": "chinese",
3
  "cedictPath": "./cedict_ts.u8",
4
  "disableSuggestionsDuringImeOn": true,
5
  "enableCurrentFileComplement": true
6
}

🔗 参考链接#

📌 快速上手#

保持默认设置 即可使用，插件开箱即用
按 Enter 选择补全词
按 ↑ ↓ 在建议中导航
按 Esc 关闭补全弹窗
如需更好的中文支持，将 Strategy 改为 chinese 并下载 cedict 词典

git ignore编写汇总

Sun, 07 Jun 2026 00:00:00 GMT

[!abstract] 摘要本文整理了 Git .gitignore 的核心用法，包括：基本语法与常见忽略规则、已跟踪文件导致 .gitignore 失效的原因与解决方案、批量清理 Git 缓存的完整流程，以及常见误区对照表。适合在项目初始化或清理仓库时快速查阅。

1. `.gitignore` 忽略文件/文件夹#

1.1 基本写法#

1
# 隐藏文件夹（写法与普通文件夹一致）
2
.claude/
3

4
# 常见 IDE 隐藏文件夹
5
.idea/
6
.vscode/
7
.vs/
8

9
# 构建/临时文件夹
10
dist/
11
build/
12
temp/
13
logs/
14

15
# 系统文件
16
.DS_Store
17
Thumbs.db

展开收起

注意

文件夹末尾必须加 /，否则可能只匹配文件而不匹配文件夹。

2. 已跟踪文件写 `.gitignore` 不生效？#

2.1 原因#

.gitignore 仅对未跟踪（untracked）文件生效。一旦文件被 git add / git commit 过，就变成已跟踪（tracked），.gitignore 不会自动停止追踪。

2.2 检查哪些文件仍在被跟踪#

Terminal window

1
# 查看所有 . 开头的隐藏文件夹
2
git ls-files | grep '^\.'
3

4
# 指定关键词过滤
5
git ls-files | grep -E '\.claude|\.vscode|dist|temp'

2.3 彻底解决：解除跟踪 + 提交#

Terminal window

1
# 1. 从 Git 索引移除（本地文件保留）
2
git rm -r --cached .claude/
3
git rm -r --cached .vscode/
4
git rm -r --cached dist/
5
# ...按需添加
6

7
# 2. 提交忽略规则并推送
8
git add .gitignore
9
git commit -m "停止跟踪IDE和构建文件夹"
10
git push

参数说明

-r — 递归处理文件夹
--cached — 仅从 Git 索引移除，本地文件不动

2.4 一键重置：清除所有缓存并重新追踪#

核心思路

清除 Git 所有缓存 → 重新按 .gitignore 追踪 → 本地文件完全不动

已经提交过的 .vscode、.idea、.claude 等 IDE 文件夹 + 各种无用文件夹，一次性全部取消追踪，本地文件保留，只清理 Git 记录。

Terminal window

1
# 1. 清除 Git 全部缓存（最关键）
2
git rm -r --cached .
3

4
# 2. 重新添加所有文件（自动跳过 .gitignore 里的内容）
5
git add .
6

7
# 3. 提交清理
8
git commit -m "清理：移除所有IDE缓存、无用文件夹，仅保留项目核心代码"
9

10
# 4. 推送到远程（清爽版）
11
git push

2.5 批量清理所有 `.` 开头文件夹#

Terminal window

1
# 先预览再执行（谨慎操作）
2
git ls-files | grep '^\.' | xargs git rm -r --cached

谨慎操作

以上命令会移除所有 . 开头的文件夹跟踪，执行前请先预览结果。

3. 常见误区#

场景	❌ 错误做法	✅ 正确做法
忽略文件夹	只写 `.claude` 不加 `/`	文件夹必须写 `.claude/`
已跟踪文件	只改 `.gitignore` 不执行 `git rm --cached`	必须解除跟踪后才生效
清理索引	删除本地文件夹	Git 索引里还在，必须用 `--cached` 移除

Markdown 与 Obsidian 语法学习指南

Fri, 05 Jun 2026 00:00:00 GMT

本文目标： 以 Python 入门笔记的排版风格为模板，系统学习如何用 Markdown + Obsidian 做出结构清晰、排版美观的学习笔记。

一、YAML Frontmatter（前置元数据）#

每篇笔记的最顶部，用 --- 包裹的区域，叫做 前置元数据（Frontmatter）。

它是 Obsidian 识别笔记属性的核心机制。

1.1 基本语法#

1
---
2
title: 笔记标题
3
created: 2026-06-05
4
tags:
5
  - 标签1
6
  - 标签2
7
---

1.2 常用字段速查#

字段	作用	示例
`title`	笔记标题	`Python 语法入门`
`created`	创建日期	`2026-06-05`
`tags`	标签列表	`- python`
`source`	来源链接	`https://...`
`description`	简短描述	`一篇超详细的Python教程`

注意： Frontmatter 必须在文件的最开头，--- 之前不能有任何字符（包括空行）。

二、标题（Headings）#

标题是笔记结构的骨架，Python 笔记中使用了 4 级标题来组织内容。

2.1 语法#

1
# 一级标题（笔记大标题，一般只用一次）
2
## 二、大章节
3
### 2.1 小节
4
#### 2.1.1 子小节

2.2 渲染效果对照#

语法	级别	用途
`# 标题`	H1	全文标题（建议每篇只用一个）
`## 标题`	H2	大章节分隔
`### 标题`	H3	大章节下的小节
`#### 标题`	H4	小节下的子内容

2.3 排版技巧#

Python 笔记的标题编排规律：

## 用于”第几章”：## 二、Python的基础语法

### 用于”第几节”：### 2.1 字面量

#### 用于”第几小节”：#### 2.1.1 什么是字面量

这种编号 + 标题名的格式，能让目录自动生成清晰的层级结构。

三、文本强调#

3.1 粗体与斜体#

1
**粗体文字**      → 用于强调关键概念
2
*斜体文字*        → 用于术语或轻微强调
3
***粗斜体***      → 极度强调

渲染效果：

语法	效果	用途
`粗体`	粗体	强调核心知识点
`斜体`	斜体	术语、外来词
`*粗斜体*`	粗斜体	特别重要的警告

3.2 Python 笔记中的强调规律#

原笔记中大量使用 **粗体**，规律如下：

关键词加粗：**Python** **通过缩进判断代码块的归属关系。**

注意事项加粗：**要注意，无论键盘输入什么类型的数据，获取到的数据永远都是字符串类型**

语法格式加粗：**def 函数名(传入参数)：**

四、引用块（Blockquotes）#

引用块是 Python 笔记中使用频率最高的排版元素，用于标注定义、注意事项、补充说明。

4.1 基本语法#

1
> 这是一个引用块

渲染效果：

这是一个引用块

4.2 多行引用#

1
> 第一行内容
2
>
3
> 第二行内容（空行+>可以产生段落间距）
4
>
5
> 第三行内容

第一行内容
第二行内容（空行+>可以产生段落间距）
第三行内容

4.3 嵌套引用#

1
> 外层引用
2
>
3
> > 内层引用（多一个>符号）

外层引用
内层引用（多一个>符号）

4.4 引用块的使用场景（来自 Python 笔记的总结）#

场景	示例
定义/概念	`> 变量：在程序运行时，能储存计算结果的抽象概念。`
注意事项	`> 要注意，无论键盘输入什么类型的数据，获取到的数据永远都是字符串类型`
补充说明	`> 注：先简单提出概念，方便写简易的代码，后续有详解`
运行结果	`> abc` `> 123` `> 9277万物可爱`
关键要点	`> 简单易学、全球第一、优雅、应用场景丰富`

五、代码块（Code Blocks）#

代码块是编程笔记的灵魂。

5.1 行内代码#

用一对反引号包裹：

1
使用 `print()` 函数输出内容

渲染效果：使用 print() 函数输出内容

5.2 代码块（带语言高亮）#

用三个反引号包裹，并指定语言名称：

1
```python
2
name = "Hello"
3
print(name)
4
```

渲染效果：

1
name = "Hello"
2
print(name)

5.3 常用语言标识#

语言	标识	适用场景
Python	`python`	Python 代码
Java	`java`	Java 代码
JavaScript	`javascript` / `js`	前端代码
SQL	`sql`	数据库查询
Shell	`bash` / `shell`	命令行操作
YAML	`yaml`	配置文件
纯文本	`text` / 留空	无高亮内容

5.4 Python 笔记中的代码块使用模式#

原笔记的代码块呈现三步式结构：

文字说明：解释要做什么

代码块：展示实际代码

运行结果：用图片或引用块展示输出
1
演示代码：
2
```python
3
print("Hello")
运行结果：
Hello

六、列表（Lists）#

6.1 无序列表#

1
- 项目一
2
- 项目二
3
  - 子项目（缩进2个空格）
4
  - 子项目
5
- 项目三

渲染效果：

项目一
项目二
- 子项目（缩进2个空格）
- 子项目
项目三

6.2 有序列表#

1
1. 第一步
2
2. 第二步
3
3. 第三步

渲染效果：

第一步
第二步
第三步

6.3 Python 笔记中列表的典型用法#

用于列举要点：

1
> •简单易学
2
> •全球第一
3
> •优雅
4
> •应用场景丰富

•简单易学 •全球第一 •优雅 •应用场景丰富

用于注意事项：

1
> • **条件需提供布尔类型结果，True继续，False停止**
2
> • **空格缩进不能忘**
3
> • **请规划好循环终止条件，否则将无限循环**

• 条件需提供布尔类型结果，True继续，False停止 • 空格缩进不能忘 • 请规划好循环终止条件，否则将无限循环

七、分割线（Horizontal Rules）#

用于大章节之间的视觉分隔。

7.1 语法#

1
---

渲染效果：

7.2 使用建议#

Python 笔记中的分割线使用规律：

在每个 ## 大章节结束后加一条 ---

用来分隔不同主题的内容块

不要过度使用，否则页面会显得碎片化

八、图片（Images）#

8.1 基本语法#

1
![替代文字](图片地址)

8.2 外部图片（网络链接）#

1
![](https://example.com/image.png)

8.3 Obsidian 本地图片（推荐）#

1
![[image.png]]

Obsidian 特有语法： 使用 ![[]] 双括号嵌入本地图片，优势：

图片存在本地，不依赖网络

支持拖拽插入

可以在 Obsidian 中直接预览

修改图片文件名时自动更新引用

8.4 图片存放建议#

1
你的Vault/
2
├── attachments/       ← 建议的图片存放目录
3
│   ├── python_01.png
4
│   └── python_02.png
5
├── notes/
6
│   └── 学习笔记.md    ← 引用: ![[attachments/python_01.png]]

九、表格（Tables）#

9.1 基本语法#

1
| 列标题1 | 列标题2 | 列标题3 |
2
|---------|---------|---------|
3
| 内容1   | 内容2   | 内容3   |
4
| 内容4   | 内容5   | 内容6   |

列标题1	列标题2	列标题3
内容1	内容2	内容3
内容4	内容5	内容6

9.2 对齐方式#

1
| 左对齐 | 居中对齐 | 右对齐 |
2
|:-------|:--------:|-------:|
3
| 左     |   中     |     右 |

左对齐	居中对齐	右对齐
左	中	右

9.3 适用场景#

用表格来呈现对比性信息效果最佳：

数据类型对比（string vs int vs float）

函数/方法速查表

运算符一览

不同容器的特点对比

十、Obsidian 独有功能#

10.1 内部链接（Wiki-links）#

1
[[笔记名称]]               ← 链接到其他笔记
2
[[笔记名称|显示文字]]       ← 自定义显示文字
3
[[文件夹/笔记名称]]        ← 链接到指定文件夹下的笔记

10.2 标签（Tags）#

1
在笔记任意位置写 #标签名 即可
2

3
例如：#python #学习笔记 #编程入门

标签 vs 目录：

标签是跨文件夹的，同一标签可以出现在不同目录的笔记中

建议建立标签体系，如：#语言/python、#类型/教程

10.3 ⭐Callout 高亮框（Obsidian 增强语法）#

1
> [!note] 笔记标题
2
> 这是一个普通的笔记框
3

4
> [!tip] 提示
5
> 这是一个提示框
6

7
> [!warning] 警告
8
> 这是一个警告框
9

10
> [!danger] 危险
11
> 这是一个危险提示框

推荐使用 Callout

Callout 比普通引用块更醒目，适合标注重要的注意事项、定义和警告。

十一、实战模板：如何复刻 Python 笔记的排版#

以下是基于 Python 笔记风格的通用学习笔记模板：

1
---
2
title: [学科名] 语法及入门
3
created: 2026-06-05
4
tags:
5
  - 学科名
6
  - 笔记
7
---
8

9
> 前言：
10
> 本篇笔记记录了 [学科名] 的核心语法与基础知识
11

12
## 一、概述
13

14
### 1.1 基本概念
15

16
简要介绍核心概念的定义。
17

18
> **关键定义：** 用引用块突出重要定义
19

20
### 1.2 应用场景
21

22
- 场景一
23
- 场景二
24
- 场景三
25

26
---
27

28
## 二、基础语法
29

30
### 2.1 核心语法点
31

32
用文字简要说明：
33

34
```python
35
# 示例代码
36
print("Hello World")

展开收起

运行结果：

Hello World

2.2 注意事项#

• 要点一：解释说明
• 要点二：解释说明
• 要点三：解释说明

三、进阶内容#

概念	说明	示例
概念A	说明A	`示例A`
概念B	说明B	`示例B`

1
---
2

3
## 十二、排版速查卡
4

5
| 排版需求 | 语法 | 效果 |
6
|----------|------|------|
7
| 加粗 | `**文字**` | **文字** |
8
| 斜体 | `*文字*` | *文字* |
9
| 行内代码 | `` `代码` `` | `代码` |
10
| 代码块 | ` ```语言 ` | 带高亮的代码块 |
11
| 引用 | `> 内容` | 灰色引用块 |
12
| 无序列表 | `- 项目` | • 项目 |
13
| 有序列表 | `1. 项目` | 1. 项目 |
14
| 分割线 | `---` | 水平线 |
15
| 表格 | `\|列\|列\|` | 表格 |
16
| 图片 | `![[文件]]` | 嵌入图片 |
17
| 链接 | `[[笔记名]]` | 可点击链接 |
18
| 标签 | `#标签名` | 可索引标签 |
19

20
---
21

22
> **总结：** 做好 Obsidian 笔记的核心公式 =
23
>
24
> **Frontmatter（元数据）** + **标题层级（骨架）** + **引用块（重点标注）** + **代码块（实例演示）** + **表格（对比总结）** + **分割线（章节分隔）**
25
>
26
> 掌握这 6 个元素，你就能做出像 Python 笔记一样结构清晰、排版美观的学习笔记！

展开收起

MBTI 十六型人格完全指南

Fri, 05 Jun 2026 00:00:00 GMT

MBTI（Myers-Briggs Type Indicator） 是基于荣格心理类型理论发展而来的人格评估工具，将人格分为 16 种类型。它通过四个维度、八个偏好来描述人们获取能量、感知信息、做出决策和生活方式的差异。

一、MBTI 的起源与发展#

1.1 理论渊源#

时间	事件
1921年	瑞士心理学家荣格（Carl Jung）发表《心理类型》，提出人格类型理论
1940s	美国凯瑟琳·布里格斯（Katharine Briggs）和女儿伊莎贝尔·迈尔斯（Isabel Myers）开始研发量表
1962年	第一版 MBTI 量表正式出版
1980s	MBTI 在企业管理和职业规划领域广泛流行
至今	全球每年超过 200万人使用，成为最流行的人格测评工具之一

1.2 核心思想#

荣格认为：人的行为虽然千差万别，但可以归纳为若干有规律可循的心理偏好。
MBTI 并不衡量能力高低，而是揭示你天生倾向于如何做事、思考和与世界互动。

二、四个维度解析#

MBTI 通过 四个二分维度 来定义人格，每个维度有两个对立的偏好，组合起来形成 2×2×2×2 = 16 种人格类型。

2.1 维度一：精力来源（E / I）#

偏好	全称	核心特征
E	Extraversion（外向）	从社交互动中获取能量；喜欢广交朋友；行动先于思考
I	Introversion（内向）	从独处反思中获取能量；喜欢深度交流；思考先于行动

关键理解： E/I 不是”话多vs话少”，而是能量来源的差异。
一个 I 型人也可以在社交场合表现得很活跃，但结束后需要独处来”充电”。
一个 E 型人也可以享受安静，但长时间独处会感到”无聊”想要找人互动。

2.2 维度二：信息获取（S / N）#

偏好	全称	核心特征
S	Sensing（感觉）	关注具体事实和细节；信任亲身经验；注重当下现实
N	Intuition（直觉）	关注整体模式和可能性；信任直觉灵感；注重未来潜力

关键理解： S 型人是务实的观察者，N 型人是想象的探索者。
面对一朵花：S 型人关注”花瓣是什么颜色、有几片”；N 型人思考”这朵花让我联想到什么、它的生长模式有何规律”。

2.3 维度三：决策方式（T / F）#

偏好	全称	核心特征
T	Thinking（思考）	依据逻辑和客观原则做决定；追求公平公正；注重因果分析
F	Feeling（情感）	依据价值观和他人感受做决定；追求和谐共情；注重人际影响

关键理解： T 不等于”冷酷无情”，F 不等于”不理性”。
T 型人也有感情，只是做决定时优先考虑逻辑；F 型人也能理性分析，只是做决定时优先考虑人情。
面对朋友迟到：T 型人想”这违反了约定，应该指出”；F 型人想”他可能遇到困难了，先关心一下”。

2.4 维度四：生活方式（J / P）#

偏好	全称	核心特征
J	Judging（判断）	喜欢有计划、有条理；追求”做完决定”的掌控感；按部就班
P	Perceiving（感知）	喜欢灵活、随性；追求”保持开放”的自由感；随机应变

关键理解： J 不等于”完美主义”，P 不等于”拖延症”。
J 型人的书桌通常整洁，喜欢提前做计划；P 型人的书桌可能”乱中有序”，喜欢保留选择空间。
面对旅行：J 型人提前做好行程表；P 型人到了目的地再决定今天去哪。

三、八个认知功能（进阶理解）#

四个维度只是表面，MBTI 的真正深度在于八个认知功能（Cognitive Functions），它们解释了每种人格类型内在的心理运作机制。

3.1 八大认知功能一览#

功能	符号	类型	描述
外倾感觉	Se	感知	对当下感官刺激高度敏感，善于捕捉环境细节
内倾感觉	Si	感知	重视过去经验和内在身体感受，记忆力强，追求稳定
外倾直觉	Ne	感知	善于发现事物之间的关联和可能性，头脑风暴能力强
内倾直觉	Ni	感知	擅长洞察本质和预判未来，常有”灵光一现”的顿悟
外倾思维	Te	判断	重视外部逻辑和效率，善于组织、管理和执行
内倾思维	Ti	判断	重视内在逻辑一致性，善于分析原理、建立模型
外倾情感	Fe	判断	关注他人情感和社会和谐，善于社交和照顾他人情绪
内倾情感	Fi	判断	重视内在价值观和真实感受，有强烈的个人道德准则

3.2 功能栈（Function Stack）#

每种 MBTI 类型都有一个由 4 个认知功能组成的功能栈，按优先级排列：

主导功能（Dominant）：最核心、最自然的心理过程

辅助功能（Auxiliary）：支持主导功能的第二优势

第三功能（Tertiary）：发展较晚，相对不成熟

劣势功能（Inferior）：最不擅长，压力下容易暴露弱点

四、十六型人格详解#

4.1 分析师（NT 型）—— 理性与策略#

INTJ — 建筑师#

“万物皆有逻辑，我要构建最优解。“

维度	偏好	功能栈
精力	I（内向）	主导：Ni（内倾直觉）
信息	N（直觉）	辅助：Te（外倾思维）
决策	T（思考）	第三：Fi（内倾情感）
生活	J（判断）	劣势：Se（外倾感觉）

核心特质：

独立思考的战略家，擅长将复杂系统化繁为简
有远见卓识，善于制定长期计划并坚定执行
对能力不足和低效率缺乏耐心
朋友圈极小但极深

适合领域： 科学研究、战略咨询、软件架构、投资分析

INTP — 逻辑学家#

“我不是在质疑你，我是在质疑一切。“

维度	偏好	功能栈
精力	I（内向）	主导：Ti（内倾思维）
信息	N（直觉）	辅助：Ne（外倾直觉）
决策	T（思考）	第三：Si（内倾感觉）
生活	P（感知）	劣势：Fe（外倾情感）

核心特质：

永不停歇的思想实验者，热爱理论和抽象问题
对”为什么”比”怎么做”更感兴趣
在感兴趣的领域能展现惊人的深度专注
可能忽略日常琐事和社交礼节

适合领域： 理论物理、编程开发、哲学研究、数据科学

ENTJ — 指挥官#

“目标明确，执行高效，其他都是噪音。“

维度	偏好	功能栈
精力	E（外向）	主导：Te（外倾思维）
信息	N（直觉）	辅助：Ni（内倾直觉）
决策	T（思考）	第三：Se（外倾感觉）
生活	J（判断）	劣势：Fi（内倾情感）

核心特质：

天生的领导者和组织者，善于整合资源达成目标
直接果断，不惧冲突，对效率有极致追求
可能显得强势和不近人情
高度自信，对未来有清晰的愿景

适合领域： 企业高管、创业、法律、政治

ENTP — 辩论家#

“规则就是用来打破的，旧的不去新的不来。“

维度	偏好	功能栈
精力	E（外向）	主导：Ne（外倾直觉）
信息	N（直觉）	辅助：Ti（内倾思维）
决策	T（思考）	第三：Fe（外倾情感）
生活	P（感知）	劣势：Si（内倾感觉）

核心特质：

思维敏捷的创新者，擅长从多角度看问题
喜欢智力挑战和思想碰撞，享受辩论过程
对新想法充满热情，但可能三分钟热度
不喜欢被规则和传统束缚

适合领域： 创业创新、市场营销、咨询顾问、媒体评论

4.2 外交官（NF 型）—— 理想与共情#

INFJ — 提倡者#

“我能看到你灵魂深处的样子。“

维度	偏好	功能栈
精力	I（内向）	主导：Ni（内倾直觉）
信息	N（直觉）	辅助：Fe（外倾情感）
决策	F（情感）	第三：Ti（内倾思维）
生活	J（判断）	劣势：Se（外倾感觉）

核心特质：

最稀有的人格类型之一（约占人口 1-2%）
有深刻的洞察力，能理解他人未说出口的感受
追求有意义的人生，有强烈的使命感
外表温和内心坚定，有自己的原则底线

适合领域： 心理咨询、写作创作、社会工作、教育培训

INFP — 调停者#

“世界可能不完美，但我要让它更好一点。“

维度	偏好	功能栈
精力	I（内向）	主导：Fi（内倾情感）
信息	N（直觉）	辅助：Ne（外倾直觉）
决策	F（情感）	第三：Si（内倾感觉）
生活	P（感知）	劣势：Te（外倾思维）

核心特质：

内心世界极其丰富的理想主义者
有强烈的个人价值观，忠于自己的信念
善于通过文字和艺术表达情感
可能过于理想化，面对现实时容易失望

适合领域： 文学创作、艺术设计、心理咨询、公益事业

ENFJ — 主人公#

“每个人都有潜力，我来帮你发现它。“

维度	偏好	功能栈
精力	E（外向）	主导：Fe（外倾情感）
信息	N（直觉）	辅助：Ni（内倾直觉）
决策	F（情感）	第三：Se（外倾感觉）
生活	J（判断）	劣势：Ti（内倾思维）

核心特质：

天生的激励者和导师，善于发现他人的潜力
有极强的感染力和号召力，是团队的灵魂人物
过于关注他人需求，可能忽视自身需要
在意他人评价，追求被认可

适合领域： 教育管理、人力资源、公共关系、宗教领袖

ENFP — 竞选者#

“生活是一场冒险，每一天都有无限可能！“

维度	偏好	功能栈
精力	E（外向）	主导：Ne（外倾直觉）
信息	N（直觉）	辅助：Fi（内倾情感）
决策	F（情感）	第三：Te（外倾思维）
生活	P（感知）	劣势：Si（内倾感觉）

核心特质：

充满热情和创造力的自由灵魂
善于社交，能让身边的人感到被接纳和理解
兴趣广泛但可能不够深入，容易分心
对重复性工作缺乏耐心

适合领域： 创意策划、新闻传媒、演艺表演、创业

4.3 守卫者（SJ 型）—— 秩序与责任#

ISTJ — 物流师#

“言出必行，这是我的原则。“

维度	偏好	功能栈
精力	I（内向）	主导：Si（内倾感觉）
信息	S（感觉）	辅助：Te（外倾思维）
决策	T（思考）	第三：Fi（内倾情感）
生活	J（判断）	劣势：Ne（外倾直觉）

核心特质：

可靠、负责、有条不紊的执行者
重视传统和规则，做事有始有终
不喜欢意外和变化，偏好可预测的环境
用行动而非言语来表达关心

适合领域： 财务会计、项目管理、行政管理、审计

ISFJ — 守卫者#

“我在你身后默默守护，你不用知道。“

维度	偏好	功能栈
精力	I（内向）	主导：Si（内倾感觉）
信息	S（感觉）	辅助：Fe（外倾情感）
决策	F（情感）	第三：Ti（内倾思维）
生活	J（判断）	劣势：Ne（外倾直觉）

核心特质：

温暖而忠诚的照顾者，善于记住他人的喜好和需求
低调务实，不求回报地付出
可能过度牺牲自己，不善于拒绝
重视和谐，避免冲突

适合领域： 医疗护理、教育、社会服务、行政助理

ESTJ — 总经理#

“规则清晰，分工明确，结果说话。“

维度	偏好	功能栈
精力	E（外向）	主导：Te（外倾思维）
信息	S（感觉）	辅助：Si（内倾感觉）
决策	T（思考）	第三：Ne（外倾直觉）
生活	J（判断）	劣势：Fi（内倾情感）

核心特质：

天生的组织者和管理者，善于建立秩序
重视效率和结果，直接了当
尊重传统和社会规范
可能显得固执，不易接受新观点

适合领域： 企业管理、军事、执法、政府机关

ESFJ — 执政官#

“让我来照顾大家，让每个人都开心。“

维度	偏好	功能栈
精力	E（外向）	主导：Fe（外倾情感）
信息	S（感觉）	辅助：Si（内倾感觉）
决策	F（情感）	第三：Ne（外倾直觉）
生活	J（判断）	劣势：Ti（内倾思维）

核心特质：

社交能力极强的照顾者，是团队的”粘合剂”
善于营造温暖和谐的氛围
高度在意他人评价，可能为了取悦他人忽略自身
重视传统和归属感

适合领域： 人力资源、客户服务、活动策划、医疗护理

4.4 探险家（SP 型）—— 自由与体验#

ISTP — 鉴赏家#

“给我工具和空间，我能拆解和修复一切。“

维度	偏好	功能栈
精力	I（内向）	主导：Ti（内倾思维）
信息	S（感觉）	辅助：Se（外倾感觉）
决策	T（思考）	第三：Ni（内倾直觉）
生活	P（感知）	劣势：Fe（外倾情感）

核心特质：

动手能力极强的实践者，善于分析和修理事物
冷静沉着，危机时刻表现出色
享受当下，不喜欢被束缚
不善于表达情感，可能显得疏离

适合领域： 工程技术、法医鉴定、飞行员、机械师

ISFP — 探险家#

“美在细节中，我在体验中感受生命。“

维度	偏好	功能栈
精力	I（内向）	主导：Fi（内倾情感）
信息	S（感觉）	辅助：Se（外倾感觉）
决策	F（情感）	第三：Ni（内倾直觉）
生活	P（感知）	劣势：Te（外倾思维）

核心特质：

有艺术天赋的安静探索者，用感官体验世界
重视个人空间和自由，不喜欢被控制
外表随和内心有强烈的个人价值观
善于活在当下，享受生活的美好细节

适合领域： 艺术设计、摄影、美食、时尚

ESTP — 企业家#

“人生苦短，先干了再说！“

维度	偏好	功能栈
精力	E（外向）	主导：Se（外倾感觉）
信息	S（感觉）	辅助：Ti（内倾思维）
决策	T（思考）	第三：Fe（外倾情感）
生活	P（感知）	劣势：Ni（内倾直觉）

核心特质：

行动力超强的实践者，善于把握眼前机会
魅力四射，是社交场合的焦点
喜欢冒险和刺激，讨厌无聊和平淡
可能冲动行事，缺乏长远规划

适合领域： 销售、体育、急救、创业

ESFP — 表演者#

“人生就是舞台，我要尽情表演！“

维度	偏好	功能栈
精力	E（外向）	主导：Se（外倾感觉）
信息	S（感觉）	辅助：Fi（内倾情感）
决策	F（情感）	第三：Te（外倾思维）
生活	P（感知）	劣势：Ni（内倾直觉）

核心特质：

热情洋溢的社交达人，能让任何场合变得有趣
享受感官体验，对美、美食、音乐有天生的感受力
乐于助人，用实际行动表达关心
可能逃避严肃话题，不喜欢长期规划

适合领域： 演艺、公关、旅游、活动主持

五、十六型人格速查表#

类型	名称	维度组合	核心标签	人口占比（约）
INTJ	建筑师	I-N-T-J	战略家	2.1%
INTP	逻辑学家	I-N-T-P	思想家	3.3%
ENTJ	指挥官	E-N-T-J	领导者	1.8%
ENTP	辩论家	E-N-T-P	创新者	3.2%
INFJ	提倡者	I-N-F-J	引路人	1.5%
INFP	调停者	I-N-F-P	理想者	4.4%
ENFJ	主人公	E-N-F-J	导师	2.5%
ENFP	竞选者	E-N-F-P	自由魂	8.1%
ISTJ	物流师	I-S-T-J	执行者	11.6%
ISFJ	守卫者	I-S-F-J	守护者	13.8%
ESTJ	总经理	E-S-T-J	管理者	8.7%
ESFJ	执政官	E-S-F-J	照顾者	12.3%
ISTP	鉴赏家	I-S-T-P	工匠	5.4%
ISFP	探险家	I-S-F-P	艺术家	8.8%
ESTP	企业家	E-S-T-P	冒险家	4.3%
ESFP	表演者	E-S-F-P	开心果	8.5%

数据来源： 基于全球多国统计的综合估算，不同地区分布有差异。SJ 型（守护者）总体占比最高，NF 型（外交官）总体占比最低。

六、MBTI 的实际应用#

6.1 职业规划#

MBTI 不是限制你”只能做什么”，而是帮助你理解什么样的工作环境和方式最能发挥你的优势。

人格倾向	适合的工作环境特点
E 型	团队协作多、社交频繁、节奏快
I 型	独立工作空间、深度思考时间、少打扰
S 型	明确的任务目标、可操作的流程、实际成果
N 型	创新空间大、允许试错、关注未来趋势
T 型	标准清晰、公平竞争、以数据说话
F 型	重视人文关怀、团队氛围好、有意义感
J 型	计划明确、角色清晰、有截止日期
P 型	灵活自由、多变有趣、自主决定节奏

6.2 人际关系#

理解 MBTI 可以帮助你：

减少冲突：明白对方不是”故意找茬”，而是思维方式不同

改善沟通：根据对方类型调整表达方式

增进理解：接受差异而非试图改变对方

常见的互补配对：

配对组合	互补方式
INTJ + ENFP	远见 + 热情，理性 + 感性互补
ISTJ + ENFP	秩序 + 自由，传统 + 创新互补
INTP + ENTJ	理论 + 执行，深度 + 广度互补
ISFJ + ESFP	守护 + 活力，稳定 + 冒险互补

注意： 任何类型之间都可以建立良好的关系，MBTI 只是帮助理解差异，而非预测兼容性。

6.3 团队协作#

一个高效团队通常需要覆盖多种认知偏好：

1
理想团队配置：
2

3
[NT 型] ——→ 提供战略思维和创新方案
4
[NF 型] ——→ 提供愿景激励和团队凝聚力
5
[ST 型] ——→ 提供执行力和质量把控
6
[SF 型] ——→ 提供人际协调和细节关注

七、MBTI 的常见误解#

7.1 常见误区 vs 正确理解#

误解 ❌	正确理解 ✅
MBTI 是科学定论	MBTI 是自我探索的工具，不是精确科学
你的类型永远不会变	人格会随年龄和经历发展，偏好可能微调
I 型人就是社恐	I 型人可以很善于社交，只是需要独处恢复能量
T 型人没有感情	T 型人有丰富的情感，只是决策时优先逻辑
某些类型比其他类型更好	每种类型都有独特优势，没有优劣之分
MBTI 能决定你的人生	MBTI 是参考，不是限制，你永远有选择权
P 型人就是懒/拖延	P 型人追求灵活性，不等于缺乏动力
J 型人就是控制狂	J 型人偏好结构化，不等于控制欲强

7.2 正确使用 MBTI 的态度#

MBTI 是一把镜子，不是一把枷锁。

用它来理解自己，而非给自己贴标签

用它来理解他人，而非评判他人

用它来探索可能性，而非限制可能性

用它来改善沟通，而非制造对立

八、如何找到自己的类型#

8.1 自我测评步骤#

Step 1： 了解四个维度的含义（参考本文第二章）
Step 2： 在每个维度上，识别自己更自然、更舒适的偏好
Step 3： 组合四个字母，得出你的类型
Step 4： 阅读该类型的详细描述，感受是否”像在照镜子”

8.2 推荐测评资源#

平台	特点	费用
16Personalities	界面友好，中文支持好，结果详细	免费（基础版）
Official MBTI	官方认证版本，最为权威	付费
荣格八维测试	测认知功能，更深入准确	免费

8.3 测评注意事项#

• 在放松的状态下作答，不要”理想化自己”
• 选择自然而然的偏好，而非你认为”应该”的选择
• 第一次测出的结果不一定准确，多测几次取最一致的结果
• 如果两个偏好都很接近（如 51% vs 49%），说明你可能是两栖型，两边都能切换

九、MBTI 与其他性格理论的关系#

理论	创始人	核心思路	与MBTI的关系
荣格心理类型	Carl Jung	8种认知功能	MBTI的直接理论基础
大五人格	多位学者	开放性、尽责性、外向性、宜人性、神经质	更被学术界认可的替代模型
九型人格	Oscar Ichazo	9种核心动机和恐惧	从动机角度切入，与MBTI互补
DISC	William Marston	支配、影响、稳健、谨慎	更简单，适合职场快速评估

建议： 将 MBTI 作为自我认知的起点而非终点，结合多种工具全面了解自己。

十、十六型人格的经典语录#

INTJ： “我不讨厌人，我只是觉得大多数人效率太低。”
INTP： “这个问题有 47 种可能的解释……”
ENTJ： “这不是我的计划，这是唯一正确的计划。”
ENTP： “你错了，但没关系，让我解释为什么。”
INFJ： “我知道你没有说出口的那句话是什么。”
INFP： “这个世界需要更多的温柔。”
ENFJ： “你比你想象的更有潜力！”
ENFP： “等一下，我刚想到了一个超棒的新点子！”
ISTJ： “日程表上写的是 9 点，不是 9 点零 1 分。”
ISFJ： “你饿不饿？我给你带了吃的。”
ESTJ： “先把事情做完，再谈感受。”
ESFJ： “大家都吃好了吗？需要我帮忙吗？”
ISTP： “别说话，让我拆开看看里面什么样。”
ISFP： “我觉得这个颜色能传达出一种……孤独感。”
ESTP： “计划？什么计划？直接上！”
ESFP： “今晚谁要一起出去玩？！”

最后的话：
MBTI 是一个帮助你认识自己的框架，但它永远无法完全定义你。每个人都是独一无二的，远比四个字母丰富得多。
“了解自己是所有智慧的开端。” —— 亚里士多德

博客部署教程

Fri, 05 Jun 2026 00:00:00 GMT

动态博客 vs 静态博客：最通俗、最清晰的对比#

你现在用的 Astro 就是静态博客 ，而你平时可能用过的 WordPress 就是动态博客 。

一句话总结区别

静态博客：提前把所有页面生成好，用户访问时 直接给文件
动态博客：用户访问时 现场生成页面 ，每次都要查数据库、拼页面

1. 核心原理差异（最关键）#

静态博客（Astro、Hexo、Hugo）你写文章 → 执行构建命令 → 工具 一次性生成所有 HTML、CSS、图片 → 部署到服务器/CDN → 用户访问 → 直接拿现成页面。无数据库、无后台运行。

动态博客（WordPress、Typecho、Ghost）你在后台写文章 → 存进 数据库 → 用户访问 → 服务器 现场运行代码 → 从数据库读文章 → 拼接成 HTML → 发给用户。必须运行服务器 + 依赖数据库。

2–5. 速度 / 安全 / 维护 / 功能#

对比维度	静态博客	动态博客
速度	极快 — 直接下载现成文件	较慢 — 查库→渲染→返回，高流量易卡
安全	几乎不会被黑 — 无数据库、无登录后台、无可攻击脚本	容易被攻击 — 有后台入口、有数据库、漏洞多
维护	几乎 0 维护 — 不用更新服务器、打补丁、管数据库	需定期维护 — 更新程序、修复漏洞、备份数据库
功能	适合博客、文档、简单网站；不适合实时评论、会员系统	适合功能复杂网站 — 论坛、商城、用户登录、后台管理

Vercel / Netlify / Cloudflare Pages 全对比#

[!info] 优先级速选主打国内访客 → Cloudflare Pages；看重开发体验 → Vercel；老牌稳扎 → Netlify 全部免备案、绑自己域名免费 SSL、Git 推送自动部署 Astro
基准：GitHub Pages 国内最慢、抽风打不开是常态，下面三家都优于 Github Pages 速度排序：Cloudflare Pages ＞ Netlify ＞ Vercel

1. Cloudflare Pages（最推荐，国内访问最优）#

核心特点

免费政策无敌：无限带宽、无限访问量，每月 500 次构建，永久免费无流量封顶
全球 330+ 边缘 CDN 节点（含香港、日韩），国内平均延迟 80~200ms，基本秒开，远胜另外两家
免备案：域名改 DNS 指向 CF 即可，自动签发 HTTPS 证书
深度兼容 Astro，git push 自动打包部署；可搭配 Workers 做简易评论、友链接口

缺点

本地预览、构建日志界面不如 Vercel 美观；CLI 工具 Wrangler 上手略繁琐

适合：个人 Astro 博客、国内访客居多、零成本、怕流量超标 → 首选

2. Vercel（开发体验天花板，国内原生一般）#

核心特点

开发体验业内第一：部署预览、在线日志、一键回滚、图片自动优化，全框架原生适配
免费版：每月 100GB 流量、6000 分钟构建时长，普通博客一年都用不完
自定义域名免备案，自动 SSL；常用套路：Vercel 托管源码 + Cloudflare 做 DNS 代理加速

缺点

xxx.vercel.app 默认域名国内容易被污染打不开，必须绑自有域名 + 套 CF 加速才能稳 流量大了容易触发付费账单

适合：经常改博客源码、折腾新功能、优先开发体验，愿意套 CF 做加速

3. Netlify（JAMstack 开创者，老牌折中选择）#

核心特点

对 Astro/Hugo/Hexo 兼容性最稳，没有框架偏心，支持表单、无服务函数、拖拽上传
免费额度：每月 100GB 带宽、300 分钟构建；域名免备案绑定、自动 SSL
国内速度介于 Vercel 和 CF 之间，裸用比原生 Vercel 稳

缺点

免费构建时长偏少，频繁改文章容易耗尽额度；更新迭代慢，生态不如另外两家

适合：老旧静态项目、不想折腾 CDN、兼顾国内外访客

关键对比表#

项目	Cloudflare Pages	Vercel	Netlify
国内裸连速度	⭐⭐⭐⭐⭐ 秒开	⭐⭐ 偏慢易抽风	⭐⭐⭐ 中等稳定
免费带宽	无限	每月 100GB	每月 100GB
免费构建	月 500 次	月 6000 分钟	月 300 分钟
域名备案	全部免备案	全部免备案	全部免备案
Astro 适配	完美	原生最优	兼容性最强
额外扩展	Workers 做后端/评论	Edge Function	Netlify Function
最优用法	直接 Pages 部署	源码放 Vercel，域名套 CF DNS	裸跑/套 CF 均可

落地部署方案（3 选 1）#

方案	路线	特点
方案 1（首选，90% 博主）	Astro → Cloudflare Pages 直接部署	一步到位，国内最快、零成本、永久免费，友链/评论可 Workers 拓展
方案 2（偏爱 Vercel）	Vercel 部署 + Cloudflare 做域名 DNS 代理	用 CF 全球节点加速 Vercel 源站，兼顾 Vercel 好用 + CF 国内快
方案 3（稳妥懒人）	Netlify 直接部署	不折腾 CDN，简单一键部署，日常写博客够用

针对你的实际情况：部署全流程#

[!abstract] 背景 0 基础 · Obsidian 记笔记 · 零花费 · 访客仅亲友 · Astro 博客 · 已有域名
核心逻辑：Obsidian 写笔记 → Astro 读取笔记生成网页 → Git 存源码 → 三大平台关联 Git 自动上线，全程不花钱、无流量扣费风险

第一阶段：本地环境搭建（不上网、只在电脑跑通）#

[!goal] 阶段目标本地 Obsidian 写的 Markdown 笔记，直接在 Astro 博客预览成网页，不用上传任何平台、不用域名

流程概述

安装基础软件：Git、Node.js（Astro 运行必备），保留现有 Obsidian 笔记库
初始化 Astro 空白博客项目：电脑生成 Astro 文件夹，选用简约博客主题
打通 Obsidian ↔ Astro 关联：把 Obsidian 笔记文件夹和 Astro 文章目录绑定，实现 Obsidian 新增/修改笔记，Astro 自动读取内容，不用复制粘贴
本地调试预览：启动 Astro 本地服务，浏览器查看笔记变成博客页面效果，调整首页、友链、排版
初次本地构建：执行构建，Astro 把全部笔记打包成静态网页文件（dist 文件夹），即最终上传的成品
初识 Git 本地版本管理：项目文件夹开启 Git，首次把 Astro+Obsidian 笔记提交本地仓库（先不推送 GitHub），为第二阶段做铺垫

[!success] 本阶段结束 本地写完 Obsidian 随笔/技术笔记，立刻能在本地博客查看网页效果

第二阶段：分三步部署三大境外托管平台#

[!info] 通用前置注册 GitHub 账号，把本地完整项目推送到 GitHub 远程仓库（源码永久免费存 GitHub）域名提前转入 Cloudflare 做 DNS 解析（后续三个平台通用加速，一次配置终身用）

步骤 1：首选部署 Cloudflare Pages（永久无限流量，最贴合零成本需求）

注册 Cloudflare 账号，进入 Pages 面板，新建项目，授权关联 GitHub 博客仓库
平台自动识别 Astro 框架，一键保存部署，生成免费 pages.dev 临时域名
后台绑定自有域名，系统自动签发免费 HTTPS 证书，网站正式上线
后续更新：Obsidian 改笔记 → 本地 Git 提交 → 推送 GitHub → CF 自动检测、自动构建、自动更新

优势

不限流量，一辈子不会超额扣费，完美匹配极少访客场景

步骤 2：备选部署 Vercel（开发体验好，备用站点）

Vercel 用 GitHub 快捷登录，导入同一个仓库，自动适配 Astro 配置完成首次部署
域名方案：①直接绑自有域名；②域名 DNS 留在 Cloudflare，套 CF CDN 加速 Vercel 源站
更新逻辑同上：Git 推送 → Vercel 自动构建更新；免费 100GB/月，亲友访问永远用不完

步骤 3：最后部署 Netlify（备用备选，全平台收尾）

Netlify 登录 → 导入同一份 GitHub 仓库，填写 Astro 构建目录，一键部署
绑定自有域名，开启 SSL；免费 100GB 流量 + 月度构建次数，更新频率完全够用

[!success] 第二阶段全部结束 一套源码，同时在 3 个境外平台上线同一个博客，任意平台宕机可切换访问，全程零开销

4 个陌生名词通俗解释#

名词	大白话
构建（Build）	Astro 把 Markdown 笔记 + 样式代码一次性编译打包成浏览器能打开的 HTML/CSS 成品网页的过程。本地构建生成 dist 文件夹；云端构建是平台收到 GitHub 新代码后自动打包
流量	用户打开网站时，从服务器下载网页、图片产生的数据大小（单位 GB）。CF Pages 无限免费；Vercel/Netlify 每月免费 100GB，个人亲友访问几乎消耗不到 1GB
PV	页面访问量。1 个人打开 1 次博客 = 1 个 PV。5 个好友各点 2 次 = 10 PV。只有自己+家人，每月几十 PV，免费额度绰绰有余
CDN	内容分发网络 — 全球各地的缓存服务器集群，把博客网页存到离访客近的节点。国内家人打开博客，不用去美国源站，直接从香港/日本节点获取，速度变快。Cloudflare 自带全球 CDN

最终日常使用闭环#

1
Obsidian 写随笔/技术笔记
2
  → 本地 Git 保存改动
3
    → 推送 GitHub
4
      → CF / Vercel / Netlify 自动构建 + 自动更新线上博客
5
        → 亲友通过域名打开浏览

Python 语法及入门（超全超详细）

Fri, 05 Jun 2026 00:00:00 GMT

前言：本篇博客超级详细，请尽量使用电脑端结合目录阅读阅读时请打开右侧 “只看目录” 方便阅读

二、Python的基础语法#

2.1字面量#

2.1.1 什么是字面量#

在代码中，被写下来的固定的值（数据），叫做字面量

1
"abcd"
2

3
1
4

5
3.6
6
python运行

2.1.2 字面量类型#

同时也是值（数据）类型

2.1.3 什么是字符串#

注：先简单提出概念，方便写简易的代码，后续字符串有详解

字符串（string），又称文本，是由任意数量的字符如中文、英文、各类符号、数字等组成。所以叫做字符的串

如：
“abcde”
“世界真美好”
“123456大揭秘”
都是字符串

Python 中，字符串需要用双引号（ “字符串内容”）包围起来

被引号包围起来的，都是字符串

注：实际使用字符串时，无论是单引号，双引号，还是三引号都可以

即：字符串有三种不同的定义方式

三引号定义法，表示在一堆三个双引号的范围内，均是字符串（ 可以换行 ），如下：

2.2 基础Python语句体验Python特点#

2.2.1 print#

print 相当于C语言中的 printf ，用法些许类似

如：

1
print("abc")
2

3
print(123)
4

5
print("9277万物可爱")
6
python运行

运行结果：

abc
123
9277万物可爱

需要注意的是，单独输出常数和变量时，不需要使用引号

2.2.2 Python 语句格式与C的区别#

首先，python语句不需要以分号结尾，而是以每一行作为区分，有点像每一行末尾处都加了分号（当然，实际不是，也不相同）

代码缩进：在C中，代码的缩进只影响代码的可读性和美观，不影响实际使用
而在python中，代码缩进控制着不同函数相互间的嵌套和归属
Python 通过缩进判断代码块的归属关系。

大括号格式：Kernighan和Ritchie格式 (Kb&R格式)
当大括号内需要有多行语句，左侧的大括号与语句同行，不再另一分行

1
stu_score_dict = {    #回车符对字典间的元素无影响
2

3
    "王力鸿": {
4

5
        "语文": 77,
6

7
        "数学": 66,
8

9
        "英语": 33
10

11
    }, "周杰轮": {
12

13
        "语文": 88,
14

15
        "数学": 86,
16

17
        "英语": 55
18

19
    }, "林俊节": {
20

21
        "语文": 99,
22

23
        "数学": 96,
24

25
        "英语": 66
26

27
    }
28

29
}
30

31
print(f"学生的考试信息是：{stu_score_dict}")
32
python运行

展开收起

由上图可以看出左侧大括号并未独自占一行

注：Python语句和C语句之间还有很多区别，后续会逐步发掘

2.3 注释#

注释：在程序代码中对程序代码进行解释说明的文字。
作用：注释不是程序， 不能被执行 ，只是对程序代码进行解释说明，让别人可以看懂程序代码的作用，能够大大增强程序的可读性。

2.3.1 单行注释#

单行注释：通过 # 号定义，在#号右侧的所有内容均作为注释

以 #开头，#右边的所有文字当作说明，而不是真正要执行的程序，起辅助说明作用

注：#号和注释内容一般建议以一个空格隔开

单行注释一般用于对一行或一小部分代码进行解释

2.3.2 多行注释#

以一对三个双引号引起来 """注释内容""" 来解释说明一段代码的作用使用方法

注：多行注释可以换行

多行注释一般对：Python文件、类或方法进行解释

2.3.3 关于注释的面试题#

1. 单行注释中能否使用多行注释？

可以，但实际使用时敲下回车键会跳转下一行并自动蹦出# 实际没有三引号的太多关系

2. 多行注释中能否使用单行注释？

可以，但无论使用还是不使用，结果都完全一致

3. 多行注释中能否使用多行注释？

不可以，三引号之间会就近匹配

2.4 变量#

2.4.1 什么是变量#

变量： 在程序运行时 ，能储存计算结果或能表示值的抽象概念。

简单的说，变量就是在程序运行时，记录数据用的

2.4.2 变量的定义格式#

如：

1
a = 10python运行

待处理位置#

print语句如何输出多份内容？

print(内容1, 内容2,…, 内容N)

和那个加号的区别

2.5 数据类型（初识）#

2.5.1 入门款三种输入类型#

目前在入门阶段，我们主要接触如下三类数据类型：

string、int、float这三个英文单词，就是类型的标准名称。

2.5.2 type() 语句#

当某个数据编写的令人迷惑时，问题来了，如何验证数据的类型呢？

我们可以通过type()语句来得到数据的类型：
语法：
type(被查看类型的数据)

使用方式：

1. 在print语句中，直接输出类型信息：

1
print(type("云边有个小卖部"))
2

3
print(type(123))
4

5
print(type(11.345))
6
python运行

运行结果：

2. 用变量存储type()的结果（返回值）：

1
type_1 = type("云边有个小卖部")
2

3
type_2 = type(123)
4

5
type_3 = type(11.345)
6

7
print(type_1)
8

9
print(type_2)
10

11
print(type_3)
12
python运行

运行结果：

2.5.3 变量有类型么#

答：变量无类型

我们通过type(变量)可以输出类型，这是查看变量的类型还是数据的类型？

查看的是：变量存储的数据的类型。因为，变量无类型，但是它存储的数据有。

2.6 类型转换#

数据类型之间，在特定的场景下，是可以相互转换的，如字符串转数字、数字转字符串等

2.6.1 常见的转换语句#

同前面学习的 type() 语句一样，这三个语句，都是带有结果的（返回值）

我们可以用 print 直接输出

或用变量存储结果值

2.6.2 类型转换注意事项#

类型转换不是万能的，毕竟强扭的瓜不甜，我们需要注意：

1. 任何类型，都可以通过str()，转换成字符串
2. 字符串内必须真的是数字，才可以将字符串转换为数字

浮点数转整数会丢失精度，也就是小数部分

2.7 标识符#

是用户在编程的时候所使用的一系列名字，用于给变量、类、方法等命名。

2.7.1 标识符命名规则#

Python中，标识符命名的规则主要有3类：

• 内容限定
• 大小写敏感
• 不可使用关键字

标识符命名规则1 —— 内容限定

标识符命名中，只允许出现：

•英文
•中文
•数字
•下划线（_）

这四类元素。

其余任何内容都不被允许。

注意： 1. 不推荐 使用中文
2.数字不可以开头

标识符命名规则2 —— 大小写敏感

以定义变量为例：
Andy = “安迪1”
andy = “安迪2”
字母a的大写和小写，是完全能够区分的。

标识符命名规则3 —— 不可使用关键字

Python中有一系列单词，称之为关键字

关键字在Python中都有特定用途

我们不可以使用它们作为标识符

常见的关键字有：

2.7.2 变量的命名规范#

变量命名规范 —— 见名知意

变量的命名要做到：

•明了：尽量做到，看到名字，就知道是什么意思

a = “张三” name = ”张三”
b = 11 age = 11

•简洁：尽量在确保“明了”的前提下，减少名字的长度

a_person_name = “张三” name = “张三”

很明显，大多数情况下，都是右侧的命名规范更合适一些

变量命名规范 —— 下划线命名法

多个单词组合变量名，要使用下划线做分隔。

firstnumber = 1
studentnickname = “小明”

first_number = 1
student_nickname = “小明”

很明显，下面的两个变量命名更合适一些

2.8 运算符#

2.8.1 算术运算符#

算术运算符的演示：

2.8.2 赋值运算符#

2.8.3 复合赋值运算符#

433

2.9 字符串拓展#

引号的嵌套：

• 可以使用转移字符（\）来将引号解除效用，变成普通字符串
• 单引号内可以写双引号或双引号内可以写单引号

2.9.1 字符串拼接#

使用“+”号连接字符串变量或字符串字面量即可

1
name = "阿蛮"
2

3
print("这位青年的名字叫做" + name + "，他今年18岁了")
4
python运行

字符串无法和非字符串变量进行拼接因为类型不一致，无法接上

1
name = "阿蛮"
2

3
age = 18
4

5
print("这位青年的名字叫做" + name + "年龄周岁是" + age)
6
python运行

2.9.2 字符串格式化#

当变量过多时，我们会发现上述的字符串拼接并不好用，由此引出字符串格式化这个方法。

1
name = "CSDN"
2

3
message = "学IT就来%s" % name
4

5
print(message)
6
python运行

其中的，%s
•% 表示：我要占位
•s 表示：将变量变成字符串放入占位的地方
所以，综合起来的意思就是：我先占个位置，等一会有个变量过来，我把它变成字符串放到占位的位置

多个变量占位， 变量要用括号括起来， 并按照占位的顺序填入：

数字也能用%s占位吗？
可以的哦，这里是将数字转换成了字符串哦
也就是数字57，变成了字符串”57”被放入占位的地方

Python中，其实支持非常多的数据类型占位， 最常用的是如下三类：

如下代码，完成字符串、整数、浮点数，三种不同类型变量的占位（演示）：

2.9.3 格式化的精度控制#

我们可以使用辅助符号”m.n”来控制数据的宽度和精度
•m，控制宽度，要求是数字（很少使用）,若设置的宽度小于数字自身，不生效
•.n，控制小数点精度，要求是数字，会进行小数的四舍五入
示例：
•%5d：表示将整数的宽度控制在5位，如数字11，被设置为5d，就会变成：[空格][空格][空格]11，用三个空格补足宽度。
•%5.2f：表示将宽度控制为5，将小数点精度设置为2
小数点和小数部分也算入宽度计算。如，对11.345设置了%7.2f 后，结果是：[空格][空格]11.35。2个空格补足宽度，小数部分限制2位精度后，四舍五入为.35
（此处需要注意的是 小数点本身也是占一个宽度的 ，然后有些朋友可能下去也试了 print(“%4.2f” % 11.345) 这段代码，发现输出是11.35，带上小数点是有5个宽度的，这是怎么回事呢？简单解释就是编译器在格式化时，如果格式化代码出现问题，会根据语义进行了代码优化，不然你试试下面这个代码 print(“%1.2f” % 11.345) ，会发现输出依然是11.35，足以证实）
%.2f：表示不限制宽度，只设置小数点精度为2，如11.345设置%.2f后，结果是11.35

体验代码：

2.9.4 字符串格式化方法二#

通过语法：f”内容{变量}“的格式来快速格式化

演示代码：

这种写法不做精度控制，也不理会类型，适用于快速格式化字符串

2.9.5 表达式的格式化#

什么是表达式？

表达式：一条具有明确执行结果的代码语句
如：
1 + 1、5 * 2，就是表达式，因为有具体的结果，结果是一个数字
又或者，常见的变量定义：
name = “张三” age = 11 + 11
等号右侧的都是表达式呢，因为它们有具体的结果，结果赋值给了等号左侧的变量。

演示代码：

在无需使用变量进行数据存储的时候，可以直接格式化表达式，简化代码哦

2.10 数据输入 input()函数#

•使用input()语句可以从键盘获取输入
•使用一个变量接收（存储）input语句获取的键盘输入数据即可
• 要注意，无论键盘输入什么类型的数据，获取到的数据永远都是字符串类型

1
print("请问你是谁")
2

3
name = input ()
4

5
print(f"Get!!! 你是{name}")
6
python运行

绿色字体内容是需要我们主动从键盘输入的数据，input 接收的便是我们输入的内容

input()语句其实是可以在要求使用者输入内容前，输出提示内容的哦，方式如下：

1
name = input ("请问你是谁 ")
2

3
print(f"Get!!! 你是{name}")
4
python运行

三、Python判断语句#

3.1 布尔类型 bool#

布尔（bool）表达现实生活中的逻辑，即真和假
•True表示真
•False表示假。
True本质上是一个数字记作1，False记作0

布尔类型也是字面量，也可以用变量存储

3.2 比较运算符#

布尔类型的数据，不仅可以通过定义得到，也可以通过比较运算符进行内容比较得到。

比较运算的表达式返回值是布尔类型

1
5
2

3
print(f"10 > 5 的结果是{result},类型是{type(result)}")
4
python运行

3.3 if语句#

3.3.1 if语句的基础语法格式#

归属于 if 判断的代码语句块，需在前方填充 4 个空格缩进
Python 通过缩进判断代码块的归属关系。

演示代码：

1
age = int(input())  #将字符串转换为整型
2

3
print(f"我今年已经{age}岁了")
4

5
if age >= 18 :
6

7
    print("我已经成年了")
8

9
    print("即将步入大学生活")
10

11
print("时间过得真快")
12
python运行

如果age = 18

如果age = 10

3.3.2 if语句的注意事项#

•判断条件的结果一定要是布尔类型
•不要忘记判断条件后的：引号
•归属于if语句的代码块，需在前方填充4个空格缩进

3.4 if else 语句#

if 条件：
满足条件的执行语句1
满足条件的执行语句2
…省略…
else：
不满足条件的执行语句1
不满足条件的执行语句2
…省略…

代码演示：

•if和其代码块，条件满足时执行
•else搭配if的判断条件，当不满足的时候执行

if else语句的注意事项：
•else不需要判断条件，当if的条件不满足时，else执行
•else的代码块，同样要4个空格作为缩进

3.5 if elif else语句#

使用场景：某些场景下，判断条件不止一个，可能有多个。

elif 类似于C中的else if

if 条件一：
满足条件一的执行语句1
满足条件一的执行语句2
…省略…
elif 条件二：
满足条件二的执行语句1
满足条件二的执行语句2
…省略…
elif 条件三：
满足条件三的执行语句1
满足条件三的执行语句2
…省略…
else：
不满足条件的执行语句1
不满足条件的执行语句2
…省略…

演示代码：

用input语句精简代码：

1
print("欢迎来到一曲无忧动物园")
2

3

4

5
# 判断身高
6

7
if int(input("请输入你的身高（cm）:")) < 120:
8

9
    print("您的身高小于120cm，可以免费游玩。")
10

11

12

13
# 判断日期
14

15
elif int(input("请输入今天的日期（1-30）:")) == 1:
16

17
    print("今天是1号免费日，可以免费游玩。")
18

19

20

21
# 判断VIP级别
22

23
elif int(input("请输入你的vip级别（1-5）:")) > 3:
24

25
    print("您的vip级别大于3，可以免费游玩。")
26

27

28

29
# 所有条件都不满足
30

31
else:
32

33
    print("不好意思，所有条件都不满足，需要购票10元。")
34

35

36

37
print("祝您游玩愉快。")
38
python运行

展开收起

注意事项
•elif可以写多个
•判断是互斥且有序的，上一个满足后面的就不会判断了
•可以在条件判断中，直接写input语句，节省代码量

3.6 判断语句的嵌套#

3.6.1 语法格式#

if 条件一：
条件一满足时的执行语句1
条件一满足时的执行语句2
if 条件二：
条件二满足时的执行语句1
条件二满足时的执行语句2

第二个if，属于第一个if内，只有第一个if满足条件，才会执行第二个if

3.6.2 嵌套的关键点#

嵌套的关键点，在于：空格缩进
通过空格缩进，来决定语句之间的：层次关系

3.6.3 演示代码#

四、Python的循环语句#

4.1 while循环#

4.1.1while循环的基础语法#

while 条件：
执行语句1
执行语句2
…省略…

每次进入循环后，将执行语句全部执行完毕后再次来到判断，如果条件依然成立，则继续进入循环，以此类推，直到条件不成立，跳出循环

注意事项：
• 条件需提供布尔类型结果， True 继续， False 停止
• 空格缩进不能忘
• 请规划好循环终止条件，否则将无限循环

4.1.2 演示代码#

1
i = 0
2

3
while i < 5:
4

5
    print("小美，我喜欢你")
6

7
    i += 1
8
python运行

4.1.3 while循环的嵌套#

和判断语句的嵌套类似，这里不再长篇介绍

演示代码：

注意事项
•注意条件的控制，避免无限循环
•多层嵌套，主要空格缩进来确定层次关系

4.2 for循环#

！！！注意！！！
python中的for循环与C语言中的for循环差别巨大，请勿混淆

4.2.1 for循环的语法格式#

从待处理数据集中：逐个取出数据， 赋值给临时变量

演示代码：

1
# 定义字符串name
2

3
name = "itCSDN"
4

5
# for循环处理字符串
6

7
for x in name:
8

9
       print(x)
10
python运行

可以看出，for循环是将字符串的内容：依次取出
所以，for循环也被称之为：遍历循环

同while循环不同，for循环是无法定义循环条件的。
只能从被处理的数据集中，依次取出内容进行处理。
所以，理论上讲，Python的for循环无法构建无限循环（被处理的数据集不可能无限大）

• 要注意，循环内的语句，需要有空格缩进

4.2.2 range 语句#

for循环语句，本质上是遍历：可迭代对象。

尽管除字符串外，其它可迭代类型目前没学习到，但不妨碍我们通过学习range语句，获得一个简单的数字序列（可迭代类型的一种）。

语法1：

range(num)

获取一个从0开始，到num结束的数字序列（不含num本身）

如range(5)取得的数据是：[0, 1, 2, 3, 4]

语法2：

range(num1,num2)

获得一个从num1开始，到num2结束的数字序列（不含num2本身）

如，range(5, 10)取得的数据是：[5, 6, 7, 8, 9]

语法3：

range(num1,num2,step)

获得一个从num1开始，到num2结束的数字序列（不含num2本身）

数字之间的步长，以step为准（step默认为1）

如，range(5, 10, 2)取得的数据是：[5, 7, 9]

代码演示：

1
print("输出7内的偶数")
2

3
for i in range(0,7,2):
4

5
    print(i)
6
python运行

4.2.3 变量的作用域#

变量的作用域指变量的有效范围

1. for循环中的变量叫做临时变量，其作用域限定为：循环内
2. 这种限定：
•是编程规范的限定，而非强制限定
•不遵守也能正常运行，但是不建议这样做
•如需访问临时变量，可以预先在循环外定义它

如果在for循环外部访问临时变量：

•实际上是可以访问到的

•在编程规范上，是不允许、不建议这么做的

4.2.4 for循环的嵌套#

for循环嵌套模式与while循环嵌套以及判断语句的嵌套都类似，注意事项如下：

•需要注意缩进，嵌套for循环同样通过缩进确定层次关系
•for循环和while循环可以相互嵌套使用

4.3 continue 和 break#

Python提供continue和break关键字
用以对循环进行临时跳过和直接结束

和C语言中continue和break的用法和作用类似

4.3.1 continue#

continue关键字用于：中断本次循环，直接进入下一次循环
continue可以用于： for循环和while循环，效果一致

当continue出现在嵌套循环中时，continue关键字只可以控制：它所在的循环临时中断

代码演示：

1
for i in range(1,3):
2

3
    print(f"第{i}天：今晚的晚霞很漂亮")
4

5
    for j in range(5,7):
6

7
        print("今天还是去咖啡店买点面包吧")
8

9
        if j == 6:
10

11
            continue
12

13
        print(f"下午{j}点了，晚风吹拂")
14
python运行

可以看到，j == 6时，下面的print语句始终没有执行，而是 跳了过去继续循环

4.3.2 break#

break关键字用于：直接结束所在循环
break可以用于： for循环和while循环，效果一致

当break出现在嵌套循环中时，break关键字同样只可以控制：它所在的循环永久中断

代码演示：

1
for i in range(1,5):
2

3
    if i == 3 :
4

5
        break
6

7
    print(i)
8
python运行

五、函数#

函数：是组织好的，可重复使用的，用来实现特定功能的代码段。

我们使用过的：input()、print()、str()、int()等都是Python的内置函数

•将功能封装在函数内，可供随时随地重复利用
•提高代码的复用性，减少重复代码，提高开发效率

5.1 函数的定义#

函数的定义：
def 函数名(传入参数)：
函数体
return 返回值

函数的调用：
函数名(参数)

注意事项：
① 参数如不需要，可以省略
② 返回值如不需要，可以省略
③ 函数必须先定义后使用

5.2 函数的参数#

传入参数的数量是不受限制的。
•可以不使用参数
•也可以仅使用任意N个参数

•函数定义中，提供的x和y，称之为：形式参数（形参），表示函数声明将要使用2个参数
• 参数之间使用逗号进行分隔
•函数调用中，提供的5和6，称之为：实际参数（实参），表示函数执行时真正使用的参数值
• 传入的时候，按照顺序传入数据，使用逗号分隔

总结：

•函数定义中的参数，称之为形式参数
•函数调用中的参数，称之为实际参数
•函数的参数数量不限，使用逗号分隔开
•传入参数的时候，要和形式参数一一对应，逗号隔开

5.3 函数的返回值#

5.3.1 return 返回值#

什么是函数的返回值函数在执行完成后，返回给调用者的结果

返回值的应用语法：
使用关键字：return 来返回结果
然后可以用变量来接收这个结果变量 = 函数（参数）

注意事项：
函数体在遇到return后就结束了，所以写在return后的代码不会执行。

5.3.2 None类型#

思考：如果函数没有使用return语句返回数据，那么函数有返回值吗？
实际上是：有的。
Python中有一个特殊的字面量：None，其类型是：<class ‘NoneType’>
无返回值的函数，实际上就是返回了：None这个字面量
None表示：空的、无实际意义的意思
函数返回的None，就表示，这个函数没有返回什么有意义的内容。
也就是返回了空的意思。

None可以主动使用return返回，效果等同于不写return语句： return None

None的应用场景：

None作为一个特殊的字面量，用于表示：空、无意义，其有非常多的应用场景。
•用在函数无返回值上
•用在if判断上
• 在 if 判断中， None 等同于 False
• 一般用于在函数中主动返回 None ，配合 if 判断做相关处理
•用于声明无内容的变量上
• 定义变量，但暂时不需要变量有具体值，可以用 None 来代替
例如：name = None

5.4 函数的说明文档#

函数是纯代码语言，想要理解其含义，就需要一行行的去阅读理解代码，效率比较低。

我们可以给函数添加说明文档，辅助理解函数的作用。

语法如下：

• 用于解释参数
• 用于解释返回值
通过多行注释的形式，对函数进行说明解释
•内容应写在函数体之前

在PyCharm编写代码时，可以通过鼠标悬停，查看调用函数的说明文档

5.5 函数的嵌套调用#

所谓函数嵌套调用指的是一个函数里面又调用了另外一个函数

执行过程：

如果函数A中，调用了另外一个函数B，那么先把函数B中的任务都执行完毕之后才会回到上次函数A执行的位置

注：其实函数调用非常简单，和正常使用函数无太大区别，多写几段代码就明白了

5.6 变量的作用域#

变量作用域指的是变量的作用范围（变量在哪里可用，在哪里不可用）
主要分为两类：局部变量和全局变量

5.6.1 局部变量#

所谓局部变量是定义在函数体内部的变量，即只在函数体内部生效
局部变量的作用：在函数体内部，临时保存数据，即当函数调用完成后，则销毁局部变量

演示代码：

变量a是定义在`testA`函数内部的变量，在函数外部访问则立即报错.

5.6.2 全局变量#

所谓全局变量，指的是在函数体内、外都能生效的变量

思考：如果有一个数据，在函数A和函数B中都要使用，该怎么办？

答：将这个数据存储在一个全局变量里面

当全局变量和局部变量发生冲突时，优先使用局部变量

5.6.3 global 关键字#

☆ 使用 global关键字可以在函数内部声明变量为全局变量, 如下所示

若不声明，则num = 100 因为：当全局变量和局部变量发生冲突时，优先使用局部变量

六、数据容器#

6.1 数据容器入门数据容器是什么#

什么是数据容器？
一种可以存储多个元素的Python数据类型

学习数据容器，就是为了批量存储或批量使用多份数据

Python中的数据容器：
一种可以容纳多份数据的数据类型，容纳的每一份数据称之为1个元素
每一个元素，可以是任意类型的数据，如字符串、数字、布尔等。

数据容器根据特点的不同，如：
•是否支持重复元素
•是否可以修改
•是否有序，等
分为5类，分别是：
列表（list）、元组（tuple）、字符串（str）、集合（set）、字典（dict）

6.2 list 列表#

6.2.1 列表的定义#

基本语法：

1
字面量
2
[元素1,元素2,元素3,元素4, ...]
3

4
定义变量
5
变量名称 = [元素1,元素2,元素3,元素4, ...]
6

7
定义空变量
8
变量名称 = []
9
变量名称 = list()

列表内的每一个数据，称之为元素
以 [ ] 作为标识
列表内每一个元素之间用, 逗号隔开
元素的数据类型没有任何限制，甚至元素也可以是列表，这样就定义了嵌套列表

演示代码：

1
name1_list = ['欧阳无双','上官婉儿','tom','black']
2

3
print(name1_list)
4
python运行

也可以嵌套：

1
name2_list = [['red','green'],['bule','white'],name1_list]
2

3
print(name2_list)
4
python运行

6.2.2 列表的下标索引#

如图，列表中的每一个元素，都有其位置下标索引，从前向后的方向，从0开始，依次递增

我们只需要按照下标索引，即可取得对应位置的元素。

或者，可以反向索引，如图，从后向前，下标索引为：-1、-2、-3，依次递减。

如果列表是嵌套的列表，同样支持下标索引

1
#取出嵌套列表的元素
2

3
my_list2 = [[1,2,3],[4,5,6]]
4

5
print(my_list2[1][1])
6
python运行

嵌套列表时，被嵌套的列表可以看作一个元素，第一个下标就是确定元素是列表[1,2,3],再用一个下标取出这个被嵌套的列表中的元素

总结：
1. 列表的下标索引是什么？
列表的每一个元素，都有编号称之为下标索引
从前向后的方向，编号从0开始递增
从后向前的方向，编号从-1开始递减
2. 如何通过下标索引取出对应位置的元素呢？
列表[下标]，即可取出
3. 下标索引的注意事项：
•要注意下标索引的取值范围，超出范围无法取出元素，并且会报错

6.2.3 列表的常用操作(方法)#

演示代码：

1、在列表的尾部追加 ''' 单个 ''' 元素语法：列表.append(元素)

1
mylist = ["itCSDN", "itlove", "python"]
2

3
mylist.append("CSDN程序员")
4

5
print(f"列表在追加了元素后，结果是：{mylist}")
6
python运行

2、在列表的尾部追加 ''' 一批 ''' 元素语法：列表.extend(另一个数据容器)

将另一个数据容器的内容取出，依次加到列表尾部

1
mylist = ["itCSDN", "itlove", "python"]
2

3
mylist2 = [1, 2, 3]
4

5
mylist.extend(mylist2)
6

7
print(f"列表在追加了一个新的列表后，结果是：{mylist}")
8
python运行

3、在指定下标位置插入新元素语法：列表.insert(下标,元素)

在指定的下标位置，插入指定的元素，其余元素向后移动

1
mylist = ["itCSDN", "itlove", "python"]
2

3
"best"
4

5
print(f"列表插入元素后，结果是：{mylist}")
6
python运行

4、删除列表指定下标元素语法：del 列表[下标]

与pop的区别：仅仅能完成删除操作

1
mylist = ["itCSDN", "itlove", "python"]
2

3
del mylist[2]
4

5
print(f"列表删除元素后结果是：{mylist}")
6
python运行

5、删除指定下标元素语法：列表.pop(下标)

与del的区别：不仅能把元素删掉，还能把删除元素作为返回值去得到

1
mylist = ["itCSDN", "itlove", "python"]
2

3
element = mylist.pop(2)
4

5
print(f"通过pop方法取出元素后列表内容：{mylist}, 取出的元素是：{element}")
6
python运行

6、删除某元素在列表中的第一个匹配项语法：列表.remove(元素)

1
mylist = ["itCSDN", "itlove", "python"]
2

3
mylist.remove("itlove")
4

5
print(f"通过remove方法移除元素后，列表的结果是：{mylist}")
6
python运行

7、清空列表语法：列表.clear()

1
mylist = ["itCSDN", "itlove", "python"]
2

3
mylist.clear()
4

5
print(f"列表被清空了，结果是：{mylist}")
6
python运行

8、统计列表内某元素的数量语法：列表.count(元素)

1
mylist = ["itCSDN", "itlove", "itlove", "itlove", "python"]
2

3
count = mylist.count("itlove")
4

5
print(f"列表中itlove的数量是：{count}")
6
python运行

9、查找某元素在列表中的下标索引语法：列表.index(元素)

1
mylist = ["itCSDN", "itlove", "python"]
2

3
index = mylist.index("itlove")
4

5
print(f"itlove在列表中的下标索引值是：{index}")
6
python运行

如果被查找的元素不存在，会报错

10、统计列表中全部的元素数量语法：len(列表)

1
mylist = ["itCSDN", "itlove", "python"]
2

3
count = len(mylist)
4

5
print(f"列表的元素数量总共有：{count}个")
6
python运行

6.2.4 总结列表的特点#

•可以容纳多个元素（上限为2**63-1、9223372036854775807个）
•可以容纳不同类型的元素（混装）
•数据是有序存储的（有下标序号）
•允许重复数据存在
•可以修改（增加或删除元素等）

6.2.5 列表的遍历#

既然数据容器可以存储多个元素，那么，就会有需求从容器内依次取出元素进行操作。
将容器内的元素依次取出进行处理的行为，称之为：遍历、迭代。

列表的遍历——while循环

index = 0
while index < len(列表) ：
元素 = 列表[index]
对元素进行处理
index += 1

列表的遍历——for循环

对比while，for循环更加适合对列表等数据容器进行遍历。

for 临时变量 in 数据容器：
对临时变量进行处理

for循环和while对比
•for循环更简单，while更灵活
•for用于从容器内依次取出元素并处理，while用以任何需要循环的场景

6.3 tuple 元组#

元组一旦定义完成，就不可修改

6.3.1 元组的定义#

元组定义：定义元组使用 小括号 ，且使用逗号隔开各个数据，数据可以是不同的数据类型。

1
#定义元组字面量
2
(元素，元素，......，元素)
3

4
#定义元组数量
5
变量名称 = (元素，元素，...... ，元素)
6

7
#定义空元组
8
变量名称 = ()          方式一
9
变量名称 = tuple()     方式二

注：1、元组只有一个数据时，这个数据后面要添加逗号，否则不是元组类型！

2、元组也支持嵌套

演示代码：

1
t2 = ("Hello",)
2

3
print(f"t2的类型是：{type(t2)}，t2的内容是：{t2}")
4
python运行

6.3.2 元组的相关操作#

元组由于不可修改的特性，所以其操作方法非常少。

元组的三种方法和列表相对应的这三种方法操作一致，这里就不再讲解，若有疑问，请私信博主或者移步前文列表方法查看

6.3.3 元组的遍历#

元组同样支持while循环和for循环的遍历操作

用法和列表遍历一致，请移步前文列表遍历处查看

6.3.4总结元组的特点#

•可以容纳多个数据
•可以容纳不同类型的数据（混装）
•数据是有序存储的（下标索引）
•允许重复数据存在
•不可以修改（增加或删除元素等）
•支持for循环

多数特性和list一致，不同点在于不可修改的特性。

但如果元组中嵌套的有列表，那么列表中的元素可以修改（列表list的本质没有改变，所以不违背元组不可以修改的原则）

演示代码：

1
t4 = (1,2,['青灯古刹','刹那芳华'])
2

3
t4[2][0] = '黄粱一梦'
4

5
t4[2][1] = '大梦初醒'
6

7
print(t4)
8
python运行

6.4 str 字符串#

字符串是字符的容器，一个字符串可以存放任意数量的字符。
同元组一样，字符串是一个：无法修改的数据容器。

6.4.1 字符串的下标索引#

和其它容器如：列表、元组一样，字符串也可以通过下标进行访问
•从前向后，下标从0开始
•从后向前，下标从-1开始

6.4.2 字符串的常用操作（方法）#

1、根据下标索引取出特定位置字符语法：字符串[下标]

1
str = "mountain and sea"
2

3
str1 = str[3]
4

5
str2 = str[-2]
6

7
print(f"从字符串{str}取下标为3的元素，值是{str1}，取下标为-2的元素，值是{str2}")
8
python运行

2、查找给定字符的第一个匹配项的下标语法：字符串.index(字符串)

1
str = "mountain and sea"
2

3
value = str.index("and")
4

5
print(f"在字符串{str}中查找“and”，其起始下标是{value}")
6
python运行

3、将字符串1替换为字符串2 语法：字符串.replace(字符串1,字符串2)

注意：不是修改字符串本身，而是得到了一个新字符串

1
str = "itmountain and itsea"
2

3
new_str = str.replace("it","程序")
4

5
print(f"将字符串 {str}，进行替换得到 {new_str}")
6
python运行

4、按照指定的分隔符字符串，将字符串划分为多个字符串，并存入列表对象中

语法：字符串.spilt(分隔符字符串)

注意：字符串本身不变，而是得到了一个新的列表对象

1
my_str = "hello python itCSDN itlove"
2

3
my_str_list = my_str.split(" ")
4

5
print(f"将字符串{my_str}进行split切分后得到：{my_str_list}, 类型是：{type(my_str_list)}")
6
python运行

5、字符串的规整操作(移除首尾的空格和换行符或指定字符串)

语法1：字符串.strip() 不传入参数时，去除首尾空格

1
my_str = "  itCSDN and itlove  "
2

3
new_my_str = my_str.strip() # 不传入参数，去除首尾空格
4

5
print(f"字符串{my_str}被strip后，结果：{new_my_str}")
6
python运行

语法2：字符串.strip(字符串)

注意：传入的是”12”，其实就是：“1”和”2”都会移除，是按照单个字符

1
my_str = "12itCSDN and itlove21"
2

3
new_my_str = my_str.strip("12")
4

5
print(f"字符串{my_str}被strip('12')后，结果：{new_my_str}")
6
python运行

6、统计字符串内某字符或字符串的出现次数语法：字符串.count(字符串)

1
my_str = "itCSDN and itlove"
2

3
count = my_str.count("it")
4

5
print(f"字符串{my_str}中it出现的次数是：{count}")
6
python运行

7、统计字符串的字符个数语法：len(字符串)

1
my_str = "itCSDN and itlove"
2

3
num = len(my_str)
4

5
print(f"字符串{my_str}的长度是：{num}")
6
python运行

6.4.3 总结字符串的特点#

作为数据容器，字符串有如下特点：
•只可以存储字符串
•长度任意（取决于内存大小）
•支持下标索引
•允许重复字符串存在
•不可以修改（增加或删除元素等）
•支持for循环

6.5 序列#

序列是指：内容连续、有序，可使用下标索引的一类数据容器
列表、元组、字符串，均可以可以视为序列。

6.5.1 序列的常用操作——切片#

序列支持切片，即：列表、元组、字符串，均支持进行切片操作
切片：从一个序列中，取出一个子序列

语法：序列[起始下标:结束下标:步长]

表示从序列中，从指定位置开始，依次取出元素，到指定位置结束，得到一个新序列：

•起始下标表示从何处开始，可以留空，留空视作从头开始
•结束下标（不含）表示何处结束，可以留空，留空视作截取到结尾
•步长表示，依次取元素的间隔
• 步长 1 表示，一个个取元素
• 步长 2 表示，每次跳过 1 个元素取
• 步长 N 表示，每次跳过 N-1 个元素取
• 步长为负数表示，反向取（注意，起始下标和结束下标也要反向标记）

注意，此操作不会影响序列本身，而是会得到一个新的序列（列表、元组、字符串）

注：可以用此方法倒序字符串等序列（步长设为-1）

可以看到，这个操作对列表、元组、字符串是通用的

同时非常灵活，根据需求，起始位置，结束位置，步长（正反序）都是可以自行控制的

6.6 set 集合#

6.6.1 集合的特点#

•集合内不允许重复元素（去重）
•集合内元素是无序的（不支持下标索引）

6.6.2 集合的定义#

结合集合特点进行代码演示：

1
my_set_empty = set()        # 定义空集合
2

3
print(f"my_set_empty的内容是：{my_set_empty}, 类型是：{type(my_set_empty)}")
4

5
my_set = {"CSDN程序员社区", "CSDN灌水乐园", "itCSDN", "CSDN灌水乐园", "CSDN程序员社区", "itCSDN"}
6

7
print(f"my_set的内容是：{my_set}, 类型是：{type(my_set)}")
8
python运行

6.6.3 集合的常用操作#

1、添加新元素语法：集合.add(元素)

1
my_set = {"CSDN程序员社区", "CSDN灌水乐园", "itCSDN"}
2

3
my_set.add("Python")
4

5
my_set.add("CSDN程序员社区")
6

7
print(f"my_set添加元素后结果是：{my_set}")
8
python运行

注意1：当集合本身就含有被添加的元素时，则添加无效（去重）
注意2：因为集合本身没有顺序，所以被添加元素位置随机

2、移除集合内指定的元素语法：集合.remove(元素)

1
my_set = {"CSDN程序员社区", "CSDN灌水乐园", "itCSDN"}
2

3
my_set.remove("CSDN程序员社区")
4

5
print(f"my_set移除黑马程序员后，结果是：{my_set}")
6
python运行

3、从集合中随机取出一个元素，原集合此元素会被删除语法：集合.pop()

1
my_set = {"CSDN程序员社区", "CSDN灌水乐园", "itCSDN"}
2

3
element = my_set.pop()
4

5
print(f"集合被取出元素是：{element}, 取出元素后：{my_set}")
6
python运行

4、清空集合语法：集合.clear()

1
my_set = {"CSDN程序员社区", "CSDN灌水乐园", "itCSDN"}
2

3
my_set.clear()
4

5
print(f"集合被清空啦，结果是：{my_set}")
6
python运行

5、取两个集合的差集（得到一个新集合）语法：集合1.difference(集合2)

1
set1 = {1, 2, 3}
2

3
set2 = {1, 5, 6}
4

5
set3 = set1.difference(set2)
6

7
print(f"取出差集后的结果是：{set3}")
8

9
print(f"取差集后，原有set1的内容：{set1}")
10

11
print(f"取差集后，原有set2的内容：{set2}")
12
python运行

6、消除两个集合的差集，集合1被修改，集合2不变语法：集合1.difference_update(集合2)

1
set1 = {1, 2, 3}
2

3
set2 = {1, 5, 6}
4

5
set1.difference_update(set2)
6

7
print(f"消除差集后，集合1结果：{set1}")
8

9
print(f"消除差集后，集合2结果：{set2}")
10
python运行

7、 得到一个新的集合，内含两个集合的所有元素，原有的两个集合不变

语法：集合1.union(集合2)

1
set1 = {1, 2, 3}
2

3
set2 = {1, 5, 6}
4

5
set3 = set1.union(set2)
6

7
print(f"2集合合并结果：{set3}")
8

9
print(f"合并后集合1：{set1}")
10

11
print(f"合并后集合2：{set2}")
12
python运行

8、统计集合的去重后的元素数量语法：len(集合)

1
set1 = {1, 2, 3, 4, 5, 1, 2, 3, 4, 5}
2

3
num = len(set1)
4

5
print(f"集合内的元素数量有：{num}个")
6
python运行

6.6.4 集合的遍历#

集合同样支持使用for循环遍历
要注意：集合 不支持下标索引 ，所以也就 不支持使用 while 循环。

1
set1 = {1, 2, 3, 4, 5}
2

3
for element in set1:
4

5
    print(f"集合的元素有：{element}")
6
python运行

6.6.5 集合的特点#

经过上述对集合的学习，可以总结出集合有如下特点：

•可以容纳多个数据
•可以容纳不同类型的数据（混装）
•数据是无序存储的（不支持下标索引）
•不允许重复数据存在
•可以修改（增加或删除元素等）
•支持for循环

6.7 字典#

6.7.1 字典的定义#

通过 key 找出对应的 value

字典的定义，同样使用{}，不过存储的元素是一个个的：键值对，如下语法：

•使用{}存储原始，每一个元素是一个键值对
•每一个键值对包含Key和Value（用冒号分隔）
•键值对之间使用逗号分隔
•Key和Value可以是任意类型的数据（key不可为字典）
•Key不可重复，重复会对原有数据覆盖
•字典不可用下标索引，而是通过Key检索Value

键值对 key ：value 三者结合被称为键值对

字典同集合一样，不可以使用下标索引
但是字典可以通过Key值来取得对应的Value

演示代码：

1
# 定义字典
2

3
my_dict1 = {"王力鸿": 99, "周杰轮": 88, "林俊节": 77}
4

5
# 定义空字典
6

7
my_dict2 = {}
8

9
my_dict3 = dict()
10

11
print(f"字典1的内容是：{my_dict1}, 类型：{type(my_dict1)}")
12

13
print(f"字典2的内容是：{my_dict2}, 类型：{type(my_dict2)}")
14

15
print(f"字典3的内容是：{my_dict3}, 类型：{type(my_dict3)}")
16
python运行

展开收起

1
# 从字典中基于Key获取Value
2

3
my_dict1 = {"王力鸿": 99, "周杰轮": 88, "林俊节": 77}
4

5
score = my_dict1["王力鸿"]
6

7
print(f"王力鸿的考试分数是：{score}")
8

9
score = my_dict1["周杰轮"]
10

11
print(f"周杰轮的考试分数是：{score}")
12
python运行

6.7.2 字典的嵌套#

字典的Key和Value可以是任意数据类型（Key不可为字典）
那么，就表明，字典是可以嵌套的

演示代码：

1
# 定义嵌套字典
2

3
stu_score_dict = {    #回车符对字典间的元素无影响
4

5
    "王力鸿": {
6

7
        "语文": 77,
8

9
        "数学": 66,
10

11
        "英语": 33
12

13
    }, "周杰轮": {
14

15
        "语文": 88,
16

17
        "数学": 86,
18

19
        "英语": 55
20

21
    }, "林俊节": {
22

23
        "语文": 99,
24

25
        "数学": 96,
26

27
        "英语": 66
28

29
    }
30

31
}
32

33
print(f"学生的考试信息是：{stu_score_dict}")
34

35

36

37
# 从嵌套字典中获取数据
38

39
# 看一下周杰轮的语文信息
40

41
score = stu_score_dict["周杰轮"]["语文"]
42

43
print(f"周杰轮的语文分数是：{score}")
44

45
score = stu_score_dict["林俊节"]["英语"]
46

47
print(f"林俊节的英语分数是：{score}")
48
python运行

展开收起

6.7.3 字典的常用操作#

1、获取指定Key对应的Value值语法：字典[key]

1
my_dict1 = {"王力鸿": 99, "周杰轮": 88, "林俊节": 77}
2

3
score = my_dict1["王力鸿"]
4

5
print(f"王力鸿的考试分数是：{score}")
6
python运行

2、添加或更新键值对语法：字典[key] = Value

1
my_dict = {"周杰轮": 99, "林俊节": 88, "张学油": 77}
2

3
# 新增元素
4

5
my_dict["张信哲"] = 66
6

7
print(f"字典经过新增元素后，结果：{my_dict}")
8

9
#更新元素
10

11
my_dict["周杰轮"] = 33
12

13
print(f"字典经过更新后，结果：{my_dict}")
14
python运行

3、取出Key对应的Value并在字典内删除此Key的键值对语法：字典.pop(key)

1
my_dict = {"周杰轮": 99, "林俊节": 88, "张学油": 77}
2

3
score = my_dict.pop("周杰轮")
4

5
print(f"字典中被移除了一个元素，结果：{my_dict}, 周杰轮的考试分数是：{score}")
6
python运行

4、清空字典语法：字典.clear

1
my_dict = {"周杰轮": 99, "林俊节": 88, "张学油": 77}
2

3
my_dict.clear()
4

5
print(f"字典被清空了，内容是：{my_dict}")
6
python运行

5、获取字典的全部Key，可用于for循环遍历字典语法：字典.key

1
my_dict = {"周杰轮": 99, "林俊节": 88, "张学油": 77}
2

3
keys = my_dict.keys()
4

5
print(f"字典的全部keys是：{keys}")
6

7
# 遍历字典
8

9
# 方式1：通过获取到全部的key来完成遍历
10

11
for key in keys:
12

13
    print(f"字典的key是:{key}")
14

15
    print(f"字典的value是：{my_dict[key]}")
16
python运行

展开收起

6、计算字典内的元素数量

1
my_dict = {"周杰轮": 99, "林俊节": 88, "张学油": 77}
2

3
num = len(my_dict)
4

5
print(f"字典中的元素数量有：{num}个")
6
python运行

6.7.4 字典的遍历#

方法1：通过获取到全部的key来完成遍历

1
my_dict = {"周杰轮": 99, "林俊节": 88, "张学油": 77}
2

3
keys = my_dict.keys()
4

5
print(f"字典的全部keys是：{keys}")
6

7
# 遍历字典
8

9
# 方式1：通过获取到全部的key来完成遍历
10

11
for key in keys:
12

13
    print(f"字典的key是:{key}")
14

15
    print(f"字典的value是：{my_dict[key]}")
16
python运行

展开收起

方法2：直接对字典进行for循环，每一次循环都是直接得到key

1
my_dict = {"周杰轮": 99, "林俊节": 88, "张学油": 77}
2

3
for key in my_dict:
4

5
    print(f"字典的key是:{key}")
6

7
    print(f"字典的value是：{my_dict[key]}")
8
python运行

6.7.5 字典的特点#

经过上述对字典的学习，可以总结出字典有如下特点：

•可以容纳多个数据
•可以容纳不同类型的数据
•每一份数据是KeyValue键值对
•可以通过Key获取到Value，Key不可重复（重复会覆盖）
•不支持下标索引
•可以修改（增加或删除更新元素等）
•支持for循环，不支持while循环

6.8 数据容器对比总结#

基于各类数据容器的特点，它们的应用场景如下：
•列表：一批数据，可修改、可重复的存储场景
•元组：一批数据，不可修改、可重复的存储场景
•字符串：一串字符串的存储场景
•集合：一批数据，去重存储场景
•字典：一批数据，可用Key检索Value的存储场景

•列表使用：[]
•元组使用：()
•字符串使用：""
•集合使用：{}
•字典使用：{}和键值对

6.9 数据容器的通用操作及相互转换#

1
my_list = [1, 2, 3, 4, 5]
2

3
my_tuple = (1, 2, 3, 4, 5)
4

5
my_str = "abcdefg"
6

7
my_set = {1, 2, 3, 4, 5}
8

9
my_dict = {"key1": 1, "key2": 2, "key3": 3, "key4": 4, "key5": 5}
10
python运行

6.9.1 数据容器的遍历#

此处不再讲，前面非常详细、

6.9.2 容器内最大元素语法：max(数据容器名)#

1
# max最大元素
2

3
print(f"列表 最大的元素是：{max(my_list)}")
4

5
print(f"元组 最大的元素是：{max(my_tuple)}")
6

7
print(f"字符串最大的元素是：{max(my_str)}")
8

9
print(f"集合 最大的元素是：{max(my_set)}")
10

11
print(f"字典 最大的元素是：{max(my_dict)}")
12
python运行

6.9.3 容器内最小元素语法：min(数据容器名)#

1
# min最小元素
2

3
print(f"列表 最小的元素是：{min(my_list)}")
4

5
print(f"元组 最小的元素是：{min(my_tuple)}")
6

7
print(f"字符串最小的元素是：{min(my_str)}")
8

9
print(f"集合 最小的元素是：{min(my_set)}")
10

11
print(f"字典 最小的元素是：{min(my_dict)}")
12
python运行

6.9.4 计算容器内元素个数语法：len(数据容器名)#

1
# len元素个数
2

3
print(f"列表 元素个数有：{len(my_list)}")
4

5
print(f"元组 元素个数有：{len(my_tuple)}")
6

7
print(f"字符串元素个数有：{len(my_str)}")
8

9
print(f"集合 元素个数有：{len(my_set)}")
10

11
print(f"字典 元素个数有：{len(my_dict)}")
12
python运行

6.9.5 数据容器转列表语法：list(数据容器名)#

字典转列表时会丢掉value值

1
# 类型转换: 容器转列表
2

3
print(f"列表转列表的结果是：{list(my_list)}")
4

5
print(f"元组转列表的结果是：{list(my_tuple)}")
6

7
print(f"字符串转列表结果是：{list(my_str)}")
8

9
print(f"集合转列表的结果是：{list(my_set)}")
10

11
print(f"字典转列表的结果是：{list(my_dict)}")
12
python运行

6.9.6 数据容器转元组语法：tuple(数据容器名)#

字典转元组时会丢掉value值

1
# 类型转换: 容器转元组
2

3
print(f"列表转元组的结果是：{tuple(my_list)}")
4

5
print(f"元组转元组的结果是：{tuple(my_tuple)}")
6

7
print(f"字符串转元组结果是：{tuple(my_str)}")
8

9
print(f"集合转元组的结果是：{tuple(my_set)}")
10

11
print(f"字典转元组的结果是：{tuple(my_dict)}")
12
python运行

6.9.7 数据容器转字符串语法：str(数据容器名)#

1
# 类型转换: 容器转字符串
2

3
print(f"列表转字符串的结果是：{str(my_list)}")
4

5
print(f"元组转字符串的结果是：{str(my_tuple)}")
6

7
print(f"字符串转字符串结果是：{str(my_str)}")
8

9
print(f"集合转字符串的结果是：{str(my_set)}")
10

11
print(f"字典转字符串的结果是：{str(my_dict)}")
12
python运行

6.9.8 数据容器转集合语法：set(数据容器名)#

1
# 类型转换: 容器转集合
2

3
print(f"列表转集合的结果是：{set(my_list)}")
4

5
print(f"元组转集合的结果是：{set(my_tuple)}")
6

7
print(f"字符串转集合结果是：{set(my_str)}")
8

9
print(f"集合转集合的结果是：{set(my_set)}")
10

11
print(f"字典转集合的结果是：{set(my_dict)}")
12
python运行

6.9.9 容器排序可正序也可倒序#

1
# 进行容器的排序
2

3
my_list = [3, 1, 2, 5, 4]
4

5
my_tuple = (3, 1, 2, 5, 4)
6

7
my_str = "bdcefga"
8

9
my_set = {3, 1, 2, 5, 4}
10

11
my_dict = {"key3": 1, "key1": 2, "key2": 3, "key5": 4, "key4": 5}
12
python运行

1、正序排列语法：sorted(数据容器名)

1
print(f"列表对象的排序结果：{sorted(my_list)}")
2

3
print(f"元组对象的排序结果：{sorted(my_tuple)}")
4

5
print(f"字符串对象的排序结果：{sorted(my_str)}")
6

7
print(f"集合对象的排序结果：{sorted(my_set)}")
8

9
print(f"字典对象的排序结果：{sorted(my_dict)}")
10
python运行

2、逆序排列语法：sorted(数据容器名,reverse = True)

1
print(f"列表对象的反向排序结果：{sorted(my_list, reverse=True)}")
2

3
print(f"元组对象的反向排序结果：{sorted(my_tuple, reverse=True)}")
4

5
print(f"字符串对象反向的排序结果：{sorted(my_str, reverse=True)}")
6

7
print(f"集合对象的反向排序结果：{sorted(my_set, reverse=True)}")
8

9
print(f"字典对象的反向排序结果：{sorted(my_dict, reverse=True)}")
10
python运行

结尾留言#

尊敬的读者，您好！

当你将这篇博客看完并加以实践后，Python的语法到这里也告了一段落

后续博主会不定时对这篇文章加以补充并往后续写Python新的内容

微信名片

苍穹外卖项目学习笔记

Thu, 15 Jan 2026 00:00:00 GMT

DAY 1（2026.1.15）#

一个request对应一个THREAD,所以参考threadLocal，可以用一个工具类用于维护该请求，并写方法。 @Builder注解详解

1
public class BaseContext {
2

3
    public static ThreadLocal<Long> threadLocal = new ThreadLocal<>();
4

5
    public static void setCurrentId(Long id) {
6
        threadLocal.set(id);
7
    }
8

9
    public static Long getCurrentId() {
10
        return threadLocal.get();
11
    }
12

13
    public static void removeCurrentId() {
14
        threadLocal.remove();
15
    }
16

17
}

展开收起

学习jwt相关实现逻辑，需要JWTutil工具类的parse JWT方法和注解：@Component ：可被当成springbean @Slf4j：日志可扫描学习了Swagger的配置(可以用Knife4j依赖整合)：

1
@Configuration
2
@Slf4j
3
public class WebMvcConfiguration extends WebMvcConfigurationSupport {
4

5
  @Autowired
6
  private JwtTokenAdminInterceptor jwtTokenAdminInterceptor;
7

8
  /**
9
   * 注册自定义拦截器
10
   *
11
   * @param registry
12
   */
13
  protected void addInterceptors(InterceptorRegistry registry) {
14
      log.info("开始注册自定义拦截器...");
15
      registry.addInterceptor(jwtTokenAdminInterceptor)
16
              .addPathPatterns("/admin/**")
17
              .excludePathPatterns("/admin/employee/login");
18
  }
19

20
  /**
21
   * 通过knife4j生成接口文档
22
   * @return
23
   */
24
  @Bean
25
  public Docket docket() {
26
      ApiInfo apiInfo = new ApiInfoBuilder()
27
              .title("苍穹外卖项目接口文档")
28
              .version("2.0")
29
              .description("苍穹外卖项目接口文档")
30
              .build();
31
      Docket docket = new Docket(DocumentationType.SWAGGER_2)
32
              .apiInfo(apiInfo)
33
              .select()
34
              .apis(RequestHandlerSelectors.basePackage("com.sky.controller"))
35
              .paths(PathSelectors.any())
36
              .build();
37
      return docket;
38
  }
39

40
  /**
41
   * 设置静态资源映射
42
   * @param registry
43
   */
44
  protected void addResourceHandlers(ResourceHandlerRegistry registry) {
45
      registry.addResourceHandler("/doc.html").addResourceLocations("classpath:/META-INF/resources/");
46
      registry.addResourceHandler("/webjars/**").addResourceLocations("classpath:/META-INF/resources/webjars/");
47
  }
48
}

展开收起

DAY 2#

注解：@jsonformat注解用于实体类和前端json的转换；序列化：java->json 反序列化：json->java 需要在web配置类新增拦截器

1
public class JacksonObjectMapper extends ObjectMapper {
2

3
    public static final String DEFAULT_DATE_FORMAT = "yyyy-MM-dd";
4
    //public static final String DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm:ss";
5
    public static final String DEFAULT_DATE_TIME_FORMAT = "yyyy-MM-dd HH:mm";
6
    public static final String DEFAULT_TIME_FORMAT = "HH:mm:ss";
7

8
    public JacksonObjectMapper() {
9
        super();
10
        //收到未知属性时不报异常
11
        this.configure(FAIL_ON_UNKNOWN_PROPERTIES, false);
12

13
        //反序列化时，属性不存在的兼容处理
14
        this.getDeserializationConfig().withoutFeatures(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
15

16
        SimpleModule simpleModule = new SimpleModule()
17
                .addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
18
                .addDeserializer(LocalDate.class, new LocalDateDeserializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
19
                .addDeserializer(LocalTime.class, new LocalTimeDeserializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)))
20
                .addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_TIME_FORMAT)))
21
                .addSerializer(LocalDate.class, new LocalDateSerializer(DateTimeFormatter.ofPattern(DEFAULT_DATE_FORMAT)))
22
                .addSerializer(LocalTime.class, new LocalTimeSerializer(DateTimeFormatter.ofPattern(DEFAULT_TIME_FORMAT)));
23

24
        //注册功能模块 例如，可以添加自定义序列化器和反序列化器
25
        this.registerModule(simpleModule);
26
    }
27
}

展开收起

pagehelper用于辅助分页，先用pageStarpage方法，返回Page类型

1
public PageResult pageQuery(EmployeePageQueryDTO employeePageQueryDTO) {
2
    PageHelper.startPage(employeePageQueryDTO.getPage(),employeePageQueryDTO.getPageSize());
3
    Page<Employee> page= employeeMapper.pageQuery(employeePageQueryDTO);
4
    long total = page.getTotal();
5
    List<Employee> result = page.getResult();
6

7
    return new PageResult(
8
            total,
9
            result
10
    );
11
}

学习了markdown语法—https://blog.csdn.net/u014061630/article/details/81359144 学习了mysql基础语法—https://blog.csdn.net/qq_45173404/article/details/115712758 pathVariable注解

DAY 3（学习时长3小时）#

热部署devtools # HTTP协议中的各种请求头、请求类型的作用以及用途 servlet视频 servletCSDN 工作原理 Servlet接口定义了Servlet与servlet容器之间的契约。这个契约是：Servlet容器将Servlet类载入内存，并产生Servlet实例和调用它具体的方法。但是要注意的是，在一个应用程序中，每种Servlet类型只能有一个实例。

1
public interface Servlet {
2
   void init(ServletConfig var1) throws ServletException;
3
     ServletConfig getServletConfig();
4
   void service(ServletRequest var1, ServletResponse var2) throws ServletException, IOException;
5
     String getServletInfo();
6
     void destroy();}

BeanUtils的copyProperties方法记得在DTO与Entity之间复用完成了分类管理和员工管理CRUD；

DAY 4#

学习了如何对公共字段进行复用处理SpringAOP #

需要一个切入类，内有两个方法：定义切入点，定义切入逻辑方法（参数为调用切入点的方法）自定义注解 @Target指定对什么方法可以用该注解 @Retention指定什么时候执行注解 @Aspect（ Pointcut 和 Advice 组成） @Pointcut execution包含’切点表达式’(“*返回包的对应类.方法.(参数) &&@anotation(注解路径)”) @Joinpoint注解结合aspect使用反射

1
public class Text04 {
2
  public static void main(String[] args) throws ClassNotFoundException {
3
    Class clz = Class.forName("java.util.HashMap");
4

5
    //获取类名
6
    System.out.println("完全限定名："+clz.getName());
7
    System.out.println("简单的类名："+clz.getSimpleName());
8

9
    //获取包名
10
    System.out.println("package"+clz.getPackage().getName());
11
    System.out.println();
12

13
    //获取成员变量
14
    Field[] fieldArray =clz.getDeclaredFields();
15
    System.out.println("成员变量(字段)");
16
    for(Field field:fieldArray) {
17
      System.out.println(field);
18
    }
19
    System.out.println();
20

21
    //获取成员方法
22
    Method[] methodArray = clz.getDeclaredMethods();
23
    System.out.println("成员方法");
24
    for(Method method:methodArray) {
25
      System.out.println(method);
26
    }
27
  }
28
}

展开收起

切面类实现逻辑

1
public class AutoFillAspect {
2
    @Pointcut("execution(* com.sky.mapper.*.*(..)) && @annotation(com.sky.annotation.AutoFill)")
3
    public void autoFillPointCut(){
4
            }
5
    @Before("autoFillPointCut()")
6
    public void autoFill(JoinPoint joinPoint) {
7
        log.info("开始进行公共字段数据填充");
8
        // 判断当前数据对象是插入还是更新操作
9
        MethodSignature signature = (MethodSignature)joinPoint.getSignature();
10
        AutoFill autoFill = signature.getMethod().getAnnotation(AutoFill.class);
11
        OperationType value = autoFill.value();
12
        // 获取方法参数
13
        Object[] args = joinPoint.getArgs();
14
        if (args == null || args.length == 0) {
15
            return;
16
        }        Object entity = args[0];
17
        LocalDateTime now = LocalDateTime.now();
18
        Long currentId = BaseContext.getCurrentId();
19
        if (value == OperationType.INSERT) {
20
            try {
21
                entity.getClass().getMethod(AutoFillConstant.SET_CREATE_TIME, LocalDateTime.class).invoke(entity, now);
22
                entity.getClass().getMethod(AutoFillConstant.SET_UPDATE_TIME, LocalDateTime.class).invoke(entity, now);
23
                entity.getClass().getMethod(AutoFillConstant.SET_CREATE_USER, Long.class).invoke(entity, currentId);
24
                entity.getClass().getMethod(AutoFillConstant.SET_UPDATE_USER, Long.class).invoke(entity, currentId);
25
            } catch (Exception e) {
26
                e.printStackTrace();
27
            }
28
           } else if (value == OperationType.UPDATE) {
29
try {
30
                entity.getClass().getMethod(AutoFillConstant.SET_UPDATE_TIME, LocalDateTime.class).invoke(entity, now);
31
                entity.getClass().getMethod(AutoFillConstant.SET_UPDATE_USER, Long.class).invoke(entity, currentId);
32
            } catch (Exception e) {
33
                e.printStackTrace();
34
            }
35
        }
36
        // 根据操作类型，为对应的属性赋值
37
        log.info("结束进行数据填充");
38
    }
39
}

展开收起

DAY 5 1.20#

Mybatis简单复习MYBATIS：视频：Mybatis $#区分 xml全限定名对应，id为对应方法，resultType为返回类型的全限定类名。 typeAliases: 在mapper.xml中需要使用parameterType和resultType属性来配置SQL语句的输入参数类型和输出参数类型，类必须要写上全限定名，比如一个SQL的返回值映射为Student类，则resultType属性要写com.yogurt.po.Student，这太长了，所以可以用别名来简化书写，比如

1
<typeAliases>
2
    <typeAlias type="com.yogurt.po.Student" alias="student"/>
3
</typeAliases>

在xml写id<时，需要进行转义字符，或CDATA(纯文本)

条件查询实例：

1
<select id="pageQuery" resultType="com.sky.entity.Employee">
2
    select * from employee
3
    <where>
4
        <if test="name != null and name !=''">
5
            and name like concat('%',#{name},'%')
6
        </if>
7
    </where>
8
    order by create_time desc
9
</select>

Classpath：maven工程中，类路径指的是 src/main/java，或者是 src/main/resource 下的路径就是类路径。

JAVA基础精简版

DAY 6#

StringBuffer与StringBuilder的区别 # 配置文件详解半小时入门MINIO

DAY 7（2026.1.24找寒假工休息几天）#

日志框架日志 SLF4J日志门面 # concat 函数 lombok注解

DAY8 (1.28 下班9.30点-)#

minio启动：.\minio.exe server D:\minio\data —console-address “127.0.0.1:9000” —address “127.0.0.1:9005”

# MyBatis XML映射文件编写全指南

resultmap用于替换resulttype，以便处理实体类属性和数据库字段不对应名字。适用于驼峰命名以外情况# resultMap 用法

三种mybatis查询方式：1、传参配合@Param绑定字段，2、传入实体类对象，3、传入map类对象键值对；

标签：choose 配合多选一的条件，与标签when 配合，作用与switch case

insert into db(xxx) values/value (xxx/x) 标签属性useGeneratedkeys true KeyProperty用于返回插入后的主键ID值。

update DB set xx=? where xx=？配合IF标签写动态Sql

delete from db where xx in （???） foreach标签：collection对应数组，item数组元素类型，separator分隔符。open close对应始终(open close非必选，若用(内使用foreach，不写）多个传参到mybatis本质是传送MAP集合，键为argX和paramX

# Serializable是什么

DAY 9 1.29 19.43#

todo复习Pagehelper :PageHelper拦截的是org.apache.ibatis.executor.Executor的query方法，其传参的核心原理是通过ThreadLocal进行的。当我们需要对某个查询进行分页查询时，我们可以在调用Mapper 进行查询前调用一次PageHelper.startPage(..)，这样PageHelper会把分页信息存入一个ThreadLocal变量中。在拦截到Executor的query方法执行时会从对应的ThreadLocal中获取分页信息，获取到了，则进行分页处理，处理完了后又会把ThreadLocal中的分页信息清理掉，以便不影响下一次的查询操作。所以当我们使用了PageHelper.startPage(..)后，每次将对最近一次的查询进行分页查询，如果下一次查询还需要进行分页查询，需要重新进行一次PageHelper.startPage(..)。这样就做到了在引入了分页后可以对原来的查询代码没有任何的侵入性。此外，在进行分页查询时，我们的返回结果一般是一个java.util.List，PageHelper分页查询后的结果会变成com.github.pagehelper.Page类型，其继承了java.util.ArrayList，所以不会对我们的方法声明造成影响。com.github.pagehelper.Page中包含有返回结果的分页信息，包括总记录数，总的分页数等信息，所以一般我们需要把返回结果强转为com.github.pagehelper.Page类型。以下是一个简单的使用PageHelper进行分页查询的示例代码。 https://blog.csdn.net/itcats_cn/article/details/81586724 @EnableTransactionManagement事务管理器完成菜品管理泛型撤销推送

DAY 10 1.30 22:00#

git回滚 git git之push -force # DTO、VO、Entity的区别完成菜品管理 @RequestBody是用于处理json传参过来的，而分页查询DTO是通过使用url传参

DAY11 2.1 22：10#

# 抽象类和接口区别抽象类是属于类，接口是所有抽象方法的集合 # PageHelper使用与原理介绍 # ThreadLocal 线程安全

DAY 12 3.15#

Redis命令五大数据类型： hash ：hset 操作field list ：lpush set ：sadd 有序set：zadd 操作对象 string：set key value 学习了docket配置，学习redistemplate操作redis，写营业状态接口。 # HttpClient的介绍与使用 get：gethttpclient

1
public void test() throws IOException {
2
    //创建httpclient对象
3
    CloseableHttpClient httpClient = HttpClients.createDefault();
4
    //创建httpget对象与 url
5
    HttpGet getstatus = new HttpGet("http://localhost:8080/user/shop/status");
6
    //发送请求
7
    CloseableHttpResponse response = httpClient.execute(getstatus);
8
    System.out.println(response.getStatusLine().getStatusCode());
9
    System.out.println(EntityUtils.toString(response.getEntity()));
10
    //关闭资源
11
    response.close();
12
    httpClient.close();
13
}

post（以login为例）

MDX 格式文章示例

Fri, 02 Jan 1970 00:00:00 GMT

Tip

Firefly 支持 MDX 和 Markdown 两种类型的文章，你可以在文章中混合使用两种格式，如果没有特别复杂内容和需求，推荐使用 Markdown 格式就够了。

Markdown 和 MDX 的区别#

Markdown (MD) 是一种轻量级标记语言，允许用户使用纯文本格式编写文档，然后将其转换为格式化的HTML。它因其简洁易用的语法而广受欢迎，特别适合编写文档和博客文章。
MDX 是一种扩展了 Markdown 语法的格式，允许在 Markdown 文档中无缝地插入 JSX 代码。通过 MDX，用户可以在文档中嵌入 React 组件，从而实现更丰富的交互性和动态性。

特性	Markdown	MDX
基础语法	支持 (CommonMark)	支持 (CommonMark)
HTML 标签	支持	支持 (作为 JSX)
组件导入	不支持	支持 (import)
动态数据	不支持	支持 (JS 表达式)
样式定制	有限 (class/style)	灵活 (className/CSS-in-JS)

使用组件#

这是一个图标组件：

1
import { Icon } from 'astro-icon/components'
2

3
<div class="flex items-center gap-2 my-4">
4
  <Icon name="fa7-solid:rocket" class="text-4xl text-red-500" />
5
  <span>火箭发射！</span>
6
</div>

火箭发射！

使用 JSX#

你也可以直接写 HTML/JSX：

1
<div className="p-4 bg-blue-100 dark:bg-blue-900 rounded-lg my-4">
2
  这是一个自定义样式的 div 块，使用了 Tailwind CSS 类。
3
</div>

这是一个自定义样式的 div 块，使用了 Tailwind CSS 类。

简单的变量导出#

1
export const year = new Date().getFullYear()
2

3
今年是 {year} 年。

今年是 2026 年。

更多信息，请查看 MDX 文档

Firefly

Firefly 简单使用指南

文章的 Front-matter#

文章文件的放置位置#

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 使用示例#

示例 1：使用文件名作为 URL#

示例 2：自定义 Slug#

示例 3：其他语言文件名使用Slug#

Slug 使用建议#

注意事项#

Firefly 博客官方指南

目录#

1. Markdown 基础语法#

1.1 块级元素#

段落与换行#

标题#

引用块#

列表#

代码块#

表格#

水平分割线#

1.2 行内元素#

参考式链接#

1.3 转义字符#

1.4 内嵌 HTML#

2. 代码块与 Expressive Code#

2.1 语法高亮#

2.2 编辑器与终端框架#

2.3 行标记与文本标记#

2.4 自动换行与折叠#

2.5 行号控制#

3. Markdown 扩展功能#

3.1 GitHub 仓库卡片#

3.2 提示框 / 告示框（Admonitions）#

GitHub 主题#

Obsidian 主题（最丰富）#

VitePress 主题#

Docusaurus 语法兼容#

3.3 剧透文本#

3.4 图片画廊网格#

4. MDX 格式文章#

4.1 MDX vs Markdown#

4.2 使用组件#

4.3 JSX 表达式#

4.4 自定义样式#

markdown + firefly 浓缩语法

列表#

无序列表#

有序列表#

obsidian首行缩进代码css

日记 · 2026-06-13

🌤️ 2026年06月13日 星期六#

一、🌅 今日概览#

二、📝 今日记录#

🌄 上午#

🌇 下午#

🌙 晚上#

三、📖 今日所学#

四、🔮 TODO & 明日计划#

Git 常用命令速查与分支操作指南

1. 基本命令（重要/易忘）#

1.1 git init — 初始化仓库#

1.2 git status — 查看工作区状态#

1.3 git log — 查看提交历史#

1.4 git reset — 版本回退#

1.5 git merge — 合并分支#

1.6 git diff — 查看差异#

2. 分支管理 ⭐#

2.1 git branch 基本操作#

2.2 分支切换与创建#

2.3 合并分支 ⭐#

2.4 同步远程分支 ⭐#

3. 踩坑记录#

3.1 绑定上游分支#

3.2 首次拉取无关历史报错#

3.3 合并冲突处理#

4. Tag 标签管理#

5. .gitignore 速查#

🌤️ 2026年06月13日星期六#

1.1 `git init` — 初始化仓库#

1.2 `git status` — 查看工作区状态#

1.3 `git log` — 查看提交历史#

1.4 `git reset` — 版本回退#

1.5 `git merge` — 合并分支#

1.6 `git diff` — 查看差异#

2.1 `git branch` 基本操作#

5. `.gitignore` 速查#

列表的常用操作（方法）具有反向索引#

`strip` 语法：`字符串.strip()` — 不传入参数时，去除首尾空格#

1. `.gitignore` 忽略文件/文件夹#

2. 已跟踪文件写 `.gitignore` 不生效？#

2.5 批量清理所有 `.` 开头文件夹#