github实战指南00-命令在哪里执行？

00 - 命令在哪里执行？

这是最基础但最重要的问题，很多人卡在这里。

一、三种窗口的区别

你在电脑上可能看到这三种窗口：

复制代码

┌─────────────────────────────────────────────────────────┐
│  1. Git Bash         ← ✅ 推荐新手用这个                   │
│     蓝色标题栏，有 Git 标志                               │
│     输入的是 Linux 风格命令                               │
├─────────────────────────────────────────────────────────┤
│  2. CMD（命令提示符）  ← ⚠️ 能用但有些命令不一样             │
│     黑色窗口，标题写"命令提示符"                           │
│     输入的是 Windows 风格命令                             │
├─────────────────────────────────────────────────────────┤
│  3. PowerShell        ← ⚠️ 能用但语法有差异                 │
│     蓝色窗口，标题写"Windows PowerShell"                  │
│     输入的是 PowerShell 风格命令                          │
└─────────────────────────────────────────────────────────┘

推荐：用 Git Bash

复制代码

为什么？
1. 我写的文档里的命令都是 Linux/Unix 语法
2. Git Bash 原生支持这些语法
3. 和公司里用的 Linux 服务器命令一致
4. 不会出奇怪的编码问题

二、怎么打开 Git Bash

方法一：开始菜单搜索

复制代码

1. 按 Windows 键
2. 输入 "Git Bash"
3. 点击打开

方法二：右键菜单（最方便）

复制代码

1. 在桌面或文件夹空白处
2. 右键 → "Open Git Bash here"（在 Git Bash 中打开）
3. 直接在当前目录打开终端

方法三：VS Code 内置终端（最推荐日常使用）

复制代码

1. 打开 VS Code
2. 按 Ctrl + `（反引号，Tab 键上面那个）
3. 或者菜单栏 → 终端 → 新建终端
4. 点击终端右上角的下拉箭头 ▼
5. 选择 "Git Bash"

三、VS Code 配置 Git Bash 为默认终端

这样每次打开 VS Code 都自动用 Git Bash：

复制代码

1. 打开 VS Code
2. 按 Ctrl + Shift + P（打开命令面板）
3. 输入 "Terminal: Select Default Profile"
4. 选择 "Git Bash"
5. 以后按 Ctrl + ` 就直接是 Git Bash 了

四、Git Bash vs CMD 的命令差异

同一个操作，两种窗口的命令不一样：

bash 复制代码

# ===== 查看当前目录 =====
# Git Bash
pwd

# CMD
cd

# ===== 查看目录内容 =====
# Git Bash
ls -la

# CMD
dir

# ===== 进入目录 =====
# Git Bash
cd /g/ltch

# CMD
cd G:\ltch

# ===== 创建目录 =====
# Git Bash
mkdir -p my-project/src

# CMD
mkdir my-project\src

# ===== 查看文件内容 =====
# Git Bash
cat file.txt

# CMD
type file.txt

# ===== 清屏 =====
# 两者都能用
clear      # Git Bash
cls        # CMD

# ===== 复制内容 =====
# Git Bash
cat file.txt | clip    # 复制到剪贴板

# CMD
clip < file.txt

# ===== 路径写法 =====
# Git Bash（正斜杠）
cd /g/ltch/git_learn
ls /c/Users/你的用户名/.ssh/

# CMD（反斜杠）
cd G:\ltch\git_learn
dir C:\Users\你的用户名\.ssh\

五、快速对照表

复制代码

┌─────────────────┬──────────────────┬──────────────────┐
│ 操作             │ Git Bash          │ CMD / PowerShell  │
├─────────────────┼──────────────────┼──────────────────┤
│ 当前目录         │ pwd              │ cd               │
│ 列出文件         │ ls -la           │ dir              │
│ 进入目录         │ cd /c/path       │ cd C:\path       │
│ 创建目录         │ mkdir -p a/b     │ mkdir a\b        │
│ 查看文件         │ cat file.txt     │ type file.txt    │
│ 清屏             │ clear            │ cls              │
│ 路径分隔符       │ /（正斜杠）        │ \（反斜杠）        │
│ 环境变量         │ echo $HOME       │ echo %USERPROFILE│
│ 复制到剪贴板     │ cat x \| clip    │ clip < x         │
└─────────────────┴──────────────────┴──────────────────┘

六、Windows 下 Git 命令的常见坑

坑1：换行符问题

bash 复制代码

# Windows 用 CRLF（\r\n），Linux 用 LF（\n）
# Git 可能会自动转换，导致 diff 显示整个文件都改了

# 解决：配置 Git 不自动转换
git config --global core.autocrlf true

# 或者在 .gitattributes 中指定
# * text=auto
# *.sh text eol=lf
# *.bat text eol=crlf

坑2：中文文件名乱码

bash 复制代码

# Git Bash 默认可能显示中文文件名乱码

# 解决：
git config --global core.quotepath false

坑3：路径太长

bash 复制代码

# Windows 路径最长 260 字符，Git 项目路径太长会报错

# 解决：启用长路径支持（需要管理员权限）
# 在 PowerShell（管理员）中运行：
New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" `
  -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force

坑4：文件权限问题

bash 复制代码

# Windows 没有 Unix 文件权限概念
# Git 会用特殊方式处理

# 如果遇到权限相关的 diff
git config --global core.fileMode false

七、推荐的日常操作方式

方式一：VS Code 终端（最推荐）

复制代码

1. 用 VS Code 打开项目文件夹
2. Ctrl + ` 打开终端（自动用 Git Bash）
3. 直接输入 git 命令
4. 左侧可以看文件变化
5. 按 Ctrl+Shift+G 打开 Git 面板

优点：

终端 + 编辑器 + 文件管理一体化
可以直接在编辑器里看 diff、解决冲突
有 Git 图形界面（Source Control 面板）

方式二：独立 Git Bash 窗口

复制代码

1. 在项目文件夹右键 → Open Git Bash here
2. 输入 git 命令

优点：

独立窗口，不占 VS Code 资源
适合只做 Git 操作

方式三：Git GUI（不推荐）

复制代码

Git 自带的图形界面
git gui

功能太简陋，不如用 VS Code

八、验证你的环境

请在 Git Bash 中运行以下命令，确认一切正常：

bash 复制代码

# 1. 检查 Git 版本
git --version
# 应该输出：git version 2.xx.x

# 2. 检查用户名和邮箱
git config --global user.name
git config --global user.email

# 3. 检查 SSH 密钥
ls ~/.ssh/
# 应该看到 id_ed25519 和 id_ed25519.pub

# 4. 测试 GitHub 连接
ssh -T git@github.com
# 应该输出：Hi xxx! You've successfully authenticated...

如果以上都通过，你的环境就配好了，可以开始实战了！

九、总结

复制代码

✅ 用 Git Bash 或 VS Code 内置终端（选 Git Bash）
✅ 路径用正斜杠 / 不用反斜杠 \
✅ 配置 core.autocrlf true 解决换行符问题
✅ 配置 core.quotepath false 解决中文乱码
✅ 遇到问题先看 Git Bash 的报错信息

配置好终端后，开始第一章 ：01-GitHub账号配置与SSH密钥