Skip to content

windows.cn.md

Latest commit

 

History

History
1224 lines (751 loc) · 40.7 KB

windows.cn.md

File metadata and controls

1224 lines (751 loc) · 40.7 KB

电脑设置教程

以下的教程将会帮助你为接下来在Le Wagon AI Software Development course全栈开发训练营中做好准备：

请仔细阅读并按顺序执行指令。如果你在哪一步卡住了，不用犹豫，可以举手咨询老师:raising_hand:

让我们开始吧 🚀

GitHub账户

你有注册好GitHub账户嘛？如果还没有，现在注册。

👉 上传一张照片 并在你的GitHub账户中设置你的名称。这一步很重要，因为我们将使用一个带有你头像的内部dashboard。请现在立即做这一步，然后再去继续下面的步骤。

启用双因素认证（2FA）。当您尝试登录时，GitHub将向您发送带有代码的短信。这对于安全性很重要，也很快将成为贡献GitHub上的代码的必要条件。

开始设置的条件

在开始之前，很重要的一件事是先看看你的电脑设置有没有满足这些条件！这样才能保证配置成功。请花点时间仔细阅读所有的文字。如果有问题，不要犹豫向老师提问哦。

Windows 10 或者 Windows 11

你的电脑必须是 Windows 10 或者 Windows 11才可以开始配置。

检查windows版本的方式：

  • 按下 Windows + R
  • 输入 winver
  • 按下 Enter

✔️ 如果窗口里的前几个词就是Windows 10 或者 Windows 11的话，你可以直接到下一步了！:+1:

❌ 如果你的电脑没有提示Windows 10 或者 Windows 11，那你现在就需要更新到Windows 10:point_down:

更新到Windows 10
  • 从Microsoft下载Windows 10
  • 下载后就可以安装它。应该会花掉差不多1小时的时间，这取决于你的电脑。
  • 安装结束后，运行上面的命令:point_up:来检查你有没有Windows 10。

ℹ️ Windows 11更新正在滚动，意思就是有些电脑可能还不能更新到11。

⚠️ 如果Windows 10已经装好了，你不需要更新到11来继续配置。

最近的更新

确认好你的电脑是Windows 10或者11之后，你就可以安装最近的更新了。

打开Windows更新：

  • 按下 Windows + R
  • 输入 ms-settings:windowsupdate
  • 按下 Enter
  • 点击 检查更新(Check updates)

✔️ 如果你看到一个绿色的勾勾，然后还有一条“You're up to date（已经是最新版本）”的信息，那你就可以继续下一步了👍

⚠️ 如果你看到一个红色的感叹号，然后还有一条“Update available（有可更新版本）”，那就请安装它，然后重复以上步骤直到电脑提示你所有的东西都是最新版本➿

❌ 如果出现关于无法更新的错误提示，叫老师来看看。

启用Windows Update Service（Windows更新服务）来修复更新

有些软件可能会禁用我们想用的更新服务。所以更新的时候你的电脑就会报错。可以这样修复它！（如果你的电脑系统语言是中文，你可以找到下面英文按键的对应中文按键。如果找不到，可以问问老师！）

  • 按下 Windows + R
  • 输入 services.msc
  • 按下 Enter
  • 双击 Windows Update Service
  • 把它从 Startup 改成 Automatic
  • 点击 Start
  • 点击 Ok 现在，我们再来试试更新吧！

最低版本需求

有些我们需要的工具已经在Windows 10的1903或之后的版本中发布了。所以请保证你最少要这个版本！

  • 按下 Windows + R
  • 输入 winver
  • 按下 Enter

检查版本号:

✔️ 如果你是1903或以上的版本, 你就可以继续下一步了:+1:

❌ 如果低于1903, 请问老师。

虚拟化

我们需要保证你电脑的虚拟化选项是激活的。

对于大多数电脑来说，这个选项已经被激活了。不过还是检查一下吧:

  • 按下 Windows + R
  • 输入 taskmgr
  • 按下 Enter
  • 点击 Performance
  • 点击 CPU

task_manager.jpg

 

    ❌ 如果这一行没有出现，或者显示禁用了，请让老师来帮你激活虚拟化。

    ✔️ 如果被激活了的话，那在图表下方会显示状态 "Virtualization: Enabled"。

🔧 可能的解决方案

激活虚拟化

 

要激活它，我们需要访问电脑的 BIOS / UEFI。

  • 按下 Windows + R
  • 输入 shutdown.exe /r /o /t 1
  • 按下 Enter
  • 等待电脑关机
  • 点击 Troubleshoot
  • 点击 Advanced Options
  • 点击 UEFI Firmware Settings
  • 点击 Restart

在这儿，你需要激活你处理器的虚拟化选项：

  • 大多数时候，在高级设置里面，CPU设置，或者北桥（Northbridge）设置里面
  • 电脑不一样，选项的名称可能也不一样：
    • 因特尔（Intel）: Intel VT-x, Intel Virtualization Technology, Virtualization Extensions, Vanderpool...
    • AMD: SVM Mode 或者 AMD-V
  • 在激活后请保存，然后重启电脑

Windows的Linux子系统

WSL是一个用来运行Ubuntu的开发环境。你可以在这儿了解更多关于WSL的信息。

ℹ️ 接下来的步骤是要看你的Windows系统版本的。请执行你对应系统版本的步骤哦👇

Windows 11

如果你是Windows 11，我们就在Windows终端用一个命令来安装WSL 2和Ubuntu。

⚠️ 在下面的步骤中，请使用 Ctrl + Shift + Enter来用管理员权限执行Windows终端，而不是只点击 Ok或者敲击Enter。

  • 按下 Windows + R
  • 输入 powershell
  • 按下 Ctrl + Shift + Enter

⚠️ 在这一步，你可能需要确认UAC权限升级。

一个蓝色的终端窗口会出现：

  • 复制下面的命令(Ctrl + C)
  • 单击右键把它们复制到PowerShell窗口（Ctrl + V 不能再这里使用)
  • 按下Enter执行这些命令
wsl --install

✔️ 如果这个命令执行好后没有任何错误，那就重启电脑然后继续下面步骤👍

❌ 如果你看到了错误信息（或者你在窗口里看到红色的字），请叫老师来帮忙。

Windows 10

安装WSL 1

如果你是Windows 10，你首先要用PowerShell终端来安装WSL 1。

⚠️ 在下面的步骤中，请使用 Ctrl + Shift + Enter来用管理员权限执行Windows终端，而不是只点击 Ok或者敲击Enter。

  • 按下 Windows + R
  • 输入 powershell
  • 按下 Ctrl + Shift + Enter

⚠️ 在这一步，你可能需要确认UAC权限升级。

一个蓝色的终端窗口会出现：

  • 复制下面的命令(Ctrl + C)
  • 单击右键把它们复制到PowerShell窗口（Ctrl + V 不能再这里使用)
  • 按下Enter执行这些命令
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

✔️ 如果这个命令执行好后没有任何错误，那就重启电脑然后继续下面步骤👍

❌ 如果你看到了错误信息（或者你在窗口里看到红色的字），请叫老师来帮忙。

升级到WSL 2

如果你是Windows 10，你需要把WSL升级到2。

等你的电脑重启好，你就可以下载WSL2安装包。

  • 打开下载页面
  • 下载安装包"WSL2 Linux kernel update package"
  • 点击Next（下一步）
  • 点击Finish（完成）

Update WSL from version 1 to 2

✔️ 如果没有错误提示的话，那你现在就可以使用WSL 2了！

❌ 如果出现了这个错误：This update only applies to machines with the Windows Subsystem for Linux, 那就在软件上右击，然后选择uninstall(卸载); 然后你再安装一次，这次应该可以正常地安装。

把WSL 2设置成Windows默认的Linux子系统

如果你用的是Windows 10的话，我们就需要把WSL默认版本设成2。

现在WSL 2已经安装好了，那就把它设置成默认的WSL吧：

  • 按下 Windows + R
  • 输入 cmd
  • 按下 Enter

在弹出的窗口里面，输入:

wsl --set-default-version 2

✔️ 如果你看到“The operation completed successfully（成功完成设置）”，那你就可以关掉这个终端，然后继续跟着下面的指示👍

❌ 如果出现了关于虚拟化的信息，请叫老师来帮忙。

激活Windows虚拟机平台功能

完成这些步骤，然后确保最后你激活了虚拟机平台和Windows的Linux子系统。

激活Windows的Hyper-V功能

完成这些步骤，然后确保你激活了Hyper-V。

ℹ️ 如果你的电脑是Windows 10 Home edition，那你的操作系统上就没有Hyper-V的功能。这不会妨碍什么，你继续下面的步骤就好:ok_hand:

Ubuntu

安装

ℹ️ 接下来的步骤是要看你的Windows系统版本的。请执行你的版本对应的步骤👇

Windows 11

如果你是Windows 11，那重启你的电脑后，你就应该能看到一个终端窗口告诉你说WSL正在恢复Ubuntu的安装过程。结束后，Ubuntu就会打开。

Windows 10

如果你是Windows 10，那我们在Microsoft商店安装Ubuntu吧：

  • 点击Start
  • 输入Microsoft Store
  • 点击列表中的微软的Windows商店
  • 在搜索栏里搜索Ubuntu
  • 选择没有数字的版本，就只是一个单词"Ubuntu"
  • 点击安装

⚠️ 不要安装Ubuntu 18.04 LTS或者Ubuntu 20.04!

卸载不正确版本的Ubuntu

要卸载不正确的版本，你只需要打开Windows 10的已安装软件的列表：

  • 按下Windows + R
  • 输入ms-settings:appsfeatures
  • 按下Enter

找到那个软件，然后点击卸载按钮。

旦安装完成了，安装按钮就会变成启动按钮：点击启动。

第一次启动

第一次启动的时候，你会需要填写一些信息：

  • 选择一个用户名:
    • 一个词
    • 全小写
    • 不要特殊字符
    • 举个例子: lewagon或者你的firstname
  • 选择一个密码
  • 确认你的密码

⚠️ 你输入密码的时候，屏幕上不会显示你在输入任何东西，这是正常的。这是一个安全措施，保证别人不会看到你的密码内容以及长度。所以输入完成后，敲击回车键（Enter）即可。

现在安装好了，你就可以关掉Ubuntu窗口了。

检查Ubuntu的WSL version

  • 按下Windows + R
  • 输入cmd
  • 按下Enter

输入下面的命令：

wsl -l -v

✔️ 如果Ubuntu WSL版本是2，你就可以进入下一步了👍

❌ 如果Ubuntu WSL的版本是1，你需要把它换成2。

把Ubuntu WSL V1换成V2

在命令提示字元窗口，输入：

wsl --set-version Ubuntu 2

✔️ 几秒之后，你应该会收到这条转换完成的信息：The conversion is complete.

❌ 如果不行的话，我们就需要检查并确保Ubuntu文件没有被压缩。

检查没有被压缩的文件
  • 按下Windows + R
  • 输入%localappdata%\Packages
  • 按下Enter
  • 打开这个文件夹CanonicalGroupLimited.UbuntuonWindows...
  • 右击LocalState文件夹
  • 点击Properties（属性）
  • 点击Advanced（高级）
  • 确保Compress content（压缩内容）选项没有被选，然后点击Ok。

只对这个文件夹应用修改，然后再试试换Ubuntu WSL的版本。

❌ 如果转换还是不行，叫老师来帮忙。

你现在可以关掉这个终端窗口了。

Visual Studio Code

在Windows上，我们会用Visual Code Studio来编辑代码，因为它和Ubuntu终端配合得很好~

想让它们一体化的话，你需要卸载其他的代码编辑器，比如SublimeText，因为它们会干扰VSCoed和WSL的一体化。

安装

然后，就会开始自动下载了。

  • 打开你刚下载的文件。
  • 安装它的时候需要改变一下选项:
    • 把VS Code注册成一个支持文件类型的编辑器
    • 其他选项不用变

VS Code install

链接VS Code和Ubuntu

  • 首次启动VS Code之后:
    • 把它加在你的任务栏上；你会经常用到它！
    • 在VS Code的右下角，应该有一个框框提示你它检测到了WSL
    • 接受VS Code WSL插件的安装

⚠️ 要用VS Code，这个插件必须要安装！

Windows终端

安装

ℹ️ 接下来的步骤是要看你的Windows系统版本的。

如果你是Windows 11，那么你的Windows终端已经装好了。直接进入下一步吧:point_down:

如果你是Windows 10，那我们来装Windows终端吧，一个真正的现代终端：

  • 点击Start
  • 输入Microsoft Store
  • 点击列表上的``Mircosoft Store`
  • 搜索Windows Terminal
  • 选择Windows Terminal"
  • 点击安装

⚠️ 不要安装Windows Terminal Preview，安装Windows Terminal就好了！

卸载错误版本的Windows Terminal

要下载错误版本的Windows Terminal的话，你需要去到Windows 10的已装软件列表：

  • 按下Windows + R
  • 输入ms-settings:appsfeatures
  • 按下Enter

找到需要卸载的软件，然后点击卸载（uninstall）按钮。

当安装完成之后，安装（Install） 按钮就会变成启动（Launch）按钮：点击这个按钮吧！

Ubuntu作为默认终端

让我们把Ubuntu变成Windows终端应用的默认终端吧！

点击Ctrl + ,

它会打开设置：

Windows Terminal Settings

  • 把默认的profile改成"Ubuntu"
  • 点击"Save"
  • 点击"Open JSON file"

你需要改动的是被红色圈起来的部分：

Windows Terminal JSON settings file

首先，我们要让Ubuntu从Ubuntu主目录启动，而不是Windows的主目录：

  • 找到"name": "Ubuntu",
  • 把下面这行加在后面：
"commandline": "wsl.exe ~",

⚠️ 别忘了这行最后有个逗号哟！

然后，我们把Windows和Ubuntu之间复制粘贴的警告禁用了吧：

  • 找到"defaultProfile": "{2c4de342-...}"这行
  • 在它后面加上这行：
"warning.multiLinePaste": false,

⚠️ 别忘了这行最后有个逗号哟！

现在按这两个键Ctrl + S保存一下。

✔️ 好咯, 你的Windows终端就设置好了！:+1:

这个终端有标签页的功能：你可以通过点击当前标签页旁边的**+**来打开一个新的标签页。

**从现在开始，每次我们说终端的时候，就是在指这个终端。**不用使用其他的terminal了。

VS Code 插件

安装

现在我们来给 VS Code 安装一些有用的插件吧。

复制粘贴下面的命令到终端：

code --install-extension ms-vscode.sublime-keybindings
code --install-extension emmanuelbeziat.vscode-great-icons
code --install-extension MS-vsliveshare.vsliveshare
code --install-extension shopify.ruby-lsp
code --install-extension dbaeumer.vscode-eslint
code --install-extension Rubymaniac.vscode-paste-and-indent
code --install-extension alexcvzz.vscode-sqlite
code --install-extension anteprimorac.html-end-tag-labels
code --install-extension marcoroth.herb-lsp
code --install-extension rayhanw.erb-helpers

你安装的就是下面这些插件：

VS Code AI Features

VS Code includes many powerful AI features, which are a great tool once you already know how to code.

That said, relying on AI too early can hide important concepts and make debugging harder to understand. Once you’re comfortable with the fundamentals, you’ll know when and how to use AI effectively — without letting it do the thinking for you.

For the start of the bootcamp, we’ll disable these features. At the right point in the course, we’ll reenable them so you can put them to good use.

In VS Code:

  1. Let's open the VS Code "Command Palette": type Ctrl-Shift-P (Windows / Linux) or Cmd-Shift-P (macOS).
  2. This will open the Command Palette: a small text box at the top of your screen. Start typing aifeatures until you see "Chat: Learn How to Hide AI features". Click on it. The Command Palette at the top of the screen
  3. This will open the settings, and will show you the option "Disable and hide built-in AI features ...". Tick the checkbox in front of that option. Check the disable option

Later, if you want to reenable the AI features, you can follow the same instructions to untick the checkbox.

Command line tools

Zsh & Git

我们将使用zsh来代替默认的bash shell。

我们也会使用git，它是一个用来进行版本控制的命令行软件。

下面来安装这些工具吧：

  • 打开终端
  • 复制粘贴下面的命令：
sudo apt update
sudo apt install -y curl git imagemagick jq unzip vim zsh

这些指令会问你的密码：输入你的密码。

⚠️ 当你输入你的密码的时候，屏幕上不会有任何的显示，这是正常的。这是一个安全保护的设置，来隐藏你整个密码，包括它的长度。你可以放心的输入你的密码，结束后按下Enter就可以了。

安装GitHub CLI

现在我们来安装GitHub官方命令行界面（CLI) (Command Line Interface)。这是一个用来在终端里和你的GitHub账户交互的一个软件。

在你的终端里，复制粘贴以下代码，并在需要的时候，输入你的密码:

sudo apt remove -y gitsome # gh command can conflict with gitsome if already installed
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install -y gh

你可以运行以下的命令，来检查gh是否成功安装了：

gh --version

✔️ 如果你看到了gh version X.Y.Z (YYYY-MM-DD)，你就可以继续下一步啦！:+1:

❌ 如果没有看到话，问问老师。

Oh-my-zsh

让我们一起安装zsh插件Oh My Zsh.

在终端terminal里执行以下指令：

sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

如果终端里出现询问"Do you want to change your default shell to zsh?", 可以输入Y

在你的终端的最后，你会看到以下内容:

带有OhMyZsh的Ubuntu终端

✔️ 如果你的终端成功显示了上面，你就可以继续下一步了👍

❌ 如果安装失败的话，请询问你的老师

把你的默认浏览器链接到Ubuntu

为了保证你可以在Ubuntu终端和浏览器进行交互，你需要设置你的默认浏览器。

⚠️ 你需要执行下面的至少一组命令：

用Google Chrome作为默认浏览器

 

运行下面的命令:

  ls /mnt/c/Program\ Files\ \(x86\)/Google/Chrome/Application/chrome.exe

如果你看到了错误信息，比如ls: cannot access... 那就运行下面的命令：

  echo "export BROWSER=\"/mnt/c/Program Files/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc

如果没有错误信息，就运行下面这一行:

  echo "export BROWSER=\"/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'\"" >> ~/.zshrc
用Mozilla Firefox作为默认浏览器

 

运行下面的命令:

  ls /mnt/c/Program\ Files\ \(x86\)/Mozilla\ Firefox/firefox.exe

如果你看到了错误信息，比如ls: cannot access... 那就运行下面的命令：

 echo "export BROWSER=\"/mnt/c/Program Files/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc

如果没有错误信息，就运行下面这一行:

  echo "export BROWSER=\"/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Mozilla Firefox/firefox.exe'\"" >> ~/.zshrc
用Microsoft Edge作为默认浏览器

 

运行下面的命令:

  echo "export BROWSER=\"/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe\"" >> ~/.zshrc
  echo "export GH_BROWSER=\"'/mnt/c/Program Files (x86)/Microsoft/Edge/Application/msedge.exe'\"" >> ~/.zshrc

重启你的终端。

然后请保证在终端运行下面这行命令后，会返回"Browser defined 👌"这句话：

[ -z "$BROWSER" ] && echo "ERROR: please define a BROWSER environment variable ⚠️" || echo "Browser defined 👌"

如果没有返回这句话，那在上面的列表中选一个浏览器，然后运行对应的命令。

如果没有的话，

✔️ 如果你看到那条信息，你就可以继续 👍

❌ 如果没有，那在上面的列表中选一个浏览器，然后运行对应的命令。然后别忘记重置你的终端：

exec zsh

有问题的话，别犹豫问老师。

GitHub CLI

CLI是Command-line Interface（命令行界面）的首字母缩写。

在这一章节里面，我们会安装GitHub CLI。这样我们就可以直接在终端和Github互动。

你之前执行的命令应该已经安装了GitHub CLI。

首先你需要登陆。复制粘贴下面的命令到终端，敲击回车：

⚠️ 不要更改下面指令中的email — 尽管user:email看起来像是你真实邮件地址的占位符，但实际上并不是——请不要替换它。

gh auth login -s 'user:email' -w --git-protocol ssh

gh会问你几个问题：

  • Generate a new SSH key to add to your GitHub account?（生成新的SSH密钥，然后添加到Github账号上？） 敲击回车，让gh帮你生成。

    如果你以前生成过SSH密钥，那你就会看到这个问题Upload your SSH public key to your GitHub account?（上传公共密钥到Github账户上上吗？） 上下移动箭头>，让它停在你想选的SSH公钥前面，然后敲击回车。

  • Enter a passphrase for your new SSH key (Optional)（输入新的SSH密钥的密码（非必填））:

    • 对大多数学生来说： 直接按下Enter跳过即可。训练营中不需要密码，而且每次使用密钥时都会提示你输入。不过有一个风险，如果有人偷了你的电脑，他们就可以向GitHub推送代码。
    • 如果安全对你来说非常重要： 输入一个你选择的密码，然后按Enter。非常 重要的是，如果你输入了密码，请立即把它记在某个地方，不要丢失或遗忘。你会经常需要输入它。

  • Title for your SSH key。你可以把它留在建议的 "GitHub CLI"，按Enter。

然后你会看到下面的文字输出：

! First copy your one-time code: 0EF9-D015
- Press Enter to open github.com in your browser...

复制那段验证码（code）(在上面的例子中是0EF9-D015 ），然后敲击Enter。

你的浏览器就会打开一个页面让你授权GitHub CLI使用你的GitHub账号。同意，并等待一会儿。

回到终端，再次敲击回车，然后就应该好啦:tada:

检查一下你有没有链接好：

gh auth status

如果你看到Logged in to github.com as <你的GitHub用户名> ，那就可以了。

❌ 如果没有，问问老师。

Dotfiles (标准配置)

黑客很喜欢把他们的shell和工具变得很酷炫。

让我们用Le Wagon提供的一个超棒的默认配置文件来开始吧：lewagon/dotfiles.

因为你的配置是私人的，所以你需要保存在自己的代码库里（repository/repo）。

Fork的意思是：在你的GitHub账号上建一个新的代码库，和原始的那一个是一模一样的（可以想象成你在复制粘贴这个代码库）。这样，你在你的GitHub上就会有一个新的代码库： $GITHUB_USERNAME/dotfiles。我们需要fork，因为每个人都需要在那些文件里加上一些特定信息（比如你的名字）。

打开终端，运行下面的命令：

export GITHUB_USERNAME=`gh api user | jq -r '.login'`
echo $GITHUB_USERNAME

✔️ 你应该能看到你的GitHub用户名在终端里显示出来了。

❌ 如果没有的话，现在就停下，找老师帮忙。看起来之前的步骤(gh auth)有一些问题。

现在就可以fork代码库（repo)，然后克隆到你自己的电脑上了：

mkdir -p ~/code/$GITHUB_USERNAME && cd $_
gh repo fork lewagon/dotfiles --clone

Dotfiles安装器

运行dotfiles安装器：

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh install.sh

用下面的命令检查一下你GitHub账号录入的电子邮箱。你需要在其中选一个（如果你有好几个的话），然后再进入下一个步骤：

gh api user/emails | jq -r '.[].email'

✔️ 如果你看到了你的注册邮箱列表，你就可以继续下一步啦👍

❌ 如果没有的话，请在运行上面☝️ 这个指令之前，重新授权GitHub。

git安装器

运行git安装器：

cd ~/code/$GITHUB_USERNAME/dotfiles && zsh git_setup.sh

☝️ 这会提示填写你的全名（FirstName LastName）和你的邮箱。

⚠️ 注意啦，你需要填gh api ...命令列出的其中一个电子邮箱。不然，Kitt就没办法跟进你的学习进程。 你选择的电子邮件将公开显示在互联网上。💡 如果您不希望您的电子邮件出现在您可能会贡献的公共存储库中，请选择 @users.noreply.github.com 地址。

现在运行下面的命令来重置你的终端：

exec zsh

这将重新加载你的shell，使其能够读取新的配置。

禁用SSH密码输入

每次跟远程的代码库交流的时候都问你要密码是件很烦的事。所以呀，你需要给oh my zsh加上一个ssh-agent插件：

首先，打开.zshrc文件：

code ~/.zshrc

然后：

  • 找到plugins=开始的这一行
  • 在插件（plugin）列表里加上ssh-agent

这个列表现在看起来应该是这样的：

plugins=(gitfast last-working-dir common-aliases zsh-syntax-highlighting history-substring-search pyenv ssh-agent)

✔️ 按下Ctrl + S 保存.zshrc文件，然后关掉你的代码编辑器。

rbenv

让我们安装rbenv，一个帮助我们安装和管理ruby环境的软件。

首先，我们需要清理你可能已经安装过的Ruby:

rvm implode && sudo rm -rf ~/.rvm
# If you got "zsh: command not found: rvm", carry on.
# It means `rvm` is not on your computer, that's what we want!
rm -rf ~/.rbenv

然后在终端里运行:

sudo apt install -y build-essential tklib zlib1g-dev libssl-dev libffi-dev libxml2 libxml2-dev libxslt1-dev libreadline-dev libyaml-dev
git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
exec zsh

Ruby

安装

现在，你已经准备好了去安装最新ruby版本并把它设置为默认版本。

运行下方这个指令，它会花费一些时间（5-10分钟）

rbenv install 3.3.5

当Ruby安装好后，运行下面这个指令来告诉系统使用3.3.5这个版本作为默认版本。

rbenv global 3.3.5

然后重置你的终端，然后检查Ruby版本：

exec zsh
ruby -v

✔️ 如果你有看到ruby 3.3.5，那么你可以继续下一步+1:

❌ 如果没有的话，询问一下老师。

安装一些gems

点击这里，如果你在 🇨🇳 中国的话

⚠️ 如果你在中国的话，你应该使用以下命令来安装gem。

# China only!
gem sources --remove https://rubygems.org/
gem sources -a https://gems.ruby-china.com/
gem sources -l
# *** CURRENT SOURCES ***
# https://gems.ruby-china.com/
# Ruby-china.com must be in the list now

在ruby的世界里，我们将外部的库称之为gems：他们是一些你可以下载并在你的电脑上运行的ruby代码。让我们一起安装一些!

首先，我们将更新bundler，它是用于安装 gem 的工具：

gem update bundler

在你的终端里，复制粘贴下面的指令：

gem install colored faker http pry-byebug rake rails:8.1.1 rest-client rspec rubocop-performance sqlite3:2.8.1 activerecord:8.1.1 ruby-lsp

✔️ 如果你看到 xx gems installed，那么一切正常 👍

❌ 如果你遇到了以下的报错：

ERROR: While executing gem ... (TypeError)
incompatible marshal file format (can't be read)
format version 4.8 required; 60.33 given

运行以下的指令：

rm -rf ~/.gemrc

然后，重新运行安装gems的指令。

⚠️ 永远不要使用sudo gem install来安装一个gem！即使你偶然发现了一个网络上的答案（或者终端提示）叫你这么做。

Node.js

Node.js是一个JavaScript运行环境以在终端运行JavaScript代码。让我们一起用nvm，一个Node.js的版本管理器，来安装Node.js。

在终端里，运行以下指令：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh

重启你的终端并执行下方指令：

nvm -v

你应该会看到你的nvm的版本。如果没有的话，问一下你的老师。

现在，让我们来安装node：

nvm install 20.17.0

当这个指令执行结束之后，运行：

node -v

如果看到v20.17.0，那么你安装成功了:heavy_check_mark: 然后，你就可以运行下面这个命令了：

nvm cache clear

❌ 如果没有看到版本的话，问一下你的老师。

yarn

让我们一起来安装yarn:

corepack enable
yarn set version stable
exec zsh

⚠️ 如果你看到任何错误信息，请尝试运行 npm install -g corepack 然后再次运行上面的命令。

重启终端并运行：

yarn -v

你应该会看到你yarn的版本。如果没有的话，问一下你的老师。

SQLite

几周后，我们就会开始学习数据库和SQL. SQLite是一个数据库引擎，它可以在单文件数据库上执行SQL查询。现在来安装它吧：

在终端，执行下面的命令：

sudo apt-get install sqlite3 libsqlite3-dev pkg-config

然后执行下面的命令：

sqlite3 -version

✔️ 如果你看到了版本号，那你就可以继续下一步了 👍

❌ 如果没有，问问老师吧！

PostgreSQL

有的时候，SQLite功能会不够用。这个时候我们就需要使用一个更高级的工具，叫做PostgreSQL。这是一个开源的、强大的、生产环境可用的数据库系统。

让我们现在安装它。

运行下方指令:

sudo apt install -y postgresql postgresql-contrib libpq-dev build-essential
sudo /etc/init.d/postgresql start
sudo -u postgres psql --command "CREATE ROLE \"`whoami`\" LOGIN createdb superuser;"

你可以把PostgreSQL配置成自动启动，这样每次你打开新的终端时，你就不需要执行sudo /etc/init.d/postgresql start：

sudo echo "`whoami` ALL=NOPASSWD:/etc/init.d/postgresql start" | sudo tee /etc/sudoers.d/postgresql
sudo chmod 440 /etc/sudoers.d/postgresql
echo "sudo /etc/init.d/postgresql start" >> ~/.zshrc

打开一个新的终端。

✔️ 如果你看到一行字说* Starting postgresql (via systemctl): postgresql.service还是* Starting PostgreSQL 14 database server，那你就可以进行下一步了 👍

❌ 如果没有的话， 请让老师来帮助你。

最后检查

让我们来看看你是否已经成功安装好了所有软件。

在终端，运行下面两行命令：

exec zsh
curl -Ls https://web-dev-challenge-lewagon-image.oss-cn-shanghai.aliyuncs.com/setup/check.rb > _.rb && ruby _.rb || rm _.rb

✔️ 如果出现了一个绿色的Awesome! Your computer is now ready!，那么你的工作台已经设置好了 👍

如果没有的话，问一下你的老师。

Kitt

⚠️ 如果你已经收到了一封来自Le Wagon邀请你去注册Kitt(我们的学习平台)的邮件并且你也注册完成了的话，你可以安全的跳过这一章节。如果你还没有注册完成的话，请跟随邮件里的教程，完成注册。

如果你不确定你要做什么，可以查看这个链接。如果你已经登录了的话，你可以跳过这个章节。如果你没有登录的话，你需要点击Enter Kitt as a Student。如果你可以成功的登录，你也可以安全的跳过这一步。不然的话，你可以询问一下老师你是否有收到过相关的邮件，或者直接跟着执行下面的教程。

前往kitt.lewagon.com/onboarding，注册成为Le Wagon的一名校友。选择你的batch，用gitHub账户登录并填写你的信息。

你的老师将会验证你的确属于这个batch。你可以在完成了注册表单后去询问老师去做验证。

当你的老师验证成功后，请前往你的邮箱收件箱。你应该会有两封邮件：

  • 一封来自Slack,邀请你加入Le Wagon Alumni Slack社群（在这儿你可以与你的伙伴和所有之前的学员交流）。点击Join并填写相应的个人信息。

  • 一封来自GitHub,要求你加入lewagon团队。接受它，不然的话你将没有办法看到有关讲座和课程的文件。

Slack

从slack.com上下载Slack的本地应用。

启动程序并注册进入lewagon-alumni的组织。

确保你在上面上传了照片。

你也可以在你的iPhone或者Android设备上登录Slack!

这么做的意义是，你可以一直开着Slack，于是你就可以分享有用的链接/寻求帮助/决定哪儿里吃饭/等等。

至于远程的ticket，你将可以用Slack语音或者视频电话来获取帮助。为了确保所有都可以正常工作，在你的电脑上启动Slack应用程序，然后跟着这里的步骤（tl;dr 输入/call --test然后在任何的channel里按下Enter键）。

等测试结束之后，你应该至少会在麦克风和相机处，看到绿色“All clear”消息。如果没有的话，问一下你的老师。

设置

打开Slack应用程序并登入lewagon-alumni组织。

确保你已经上传了你的头像照片 👇

如何上传一张头像照片

之后你可以全天开着Slack，这样你可以在上面分享有用的链接/寻求帮助/决定去那儿吃饭/...

为了确保视频电话可以正常工作，让我们一起测试摄像头和麦克风：

  • 打开Slack应用程序。
  • 点击右上方的个人照片。
  • 从菜单中选择 首选项(Preferences)。
  • 点击左侧栏中的 音频和视频(Audio & video)。
  • 在 故障排除(Troubleshooting)下面，点击 运行音频、视频和屏幕共享测试(Run an audio, video and screensharing test)。该测试将在一个新窗口中打开。
  • 检查你使用的扬声器、麦克风和摄像机设备是否出现在选项中，然后点击 开始测试(Start test)。

在Slack检查麦克风和摄像头

✔️ 当测试结束以后，你应该会看到你的摄像头和麦克风有绿色的"Succeed"信息。👍

❌ 如果测试失败的话，请联系你的老师.

你也可以在手机上安装Slack应用并登入lewagon-alumni!

Ubuntu文件系统

在Windows和Ubuntu之间交换文件

我们需要一个简单的方法在Windows和Ubuntu之间交换文件。

想这样的话，你需要建一些可以从Windows的File Explorer访问Ubuntu文件目录的快捷键。

你需要做下面这些步骤:

  • 打开Ubuntu终端
  • 打开Windows File Explorer (或者使用快捷键Win + E)
  • 在地址栏，输入\\wsl$\（如果不行的话，就输入\\wsl$\Ubuntu）
  • 现在你就有Ubuntu文件系统的访问权限了
  • 看一下Ubuntu的文件系统，看看有哪些目录是你会想用的
  • 拖拽想要的文件夹到地址栏，就可以创建快捷键了

从Ubuntu终端打开Windows File Explorer

另一个交换文件的方法是从Ubuntu终端打开WindowsFile Explorer。

你需要做下面这些步骤：

  • 打开Ubuntu终端
  • 进入你想看的目录
  • 运行explorer.exe .命令（或者，使用wslview .）
  • 如果你看到一条输入输出的报错，那就在Windows PowerShell运行wsl --shutdown然后再重新打开Ubuntu终端

在Ubuntu文件系统里找到方向

你可能想搞清楚Ubuntu文件系统里的Windows目录到底在哪儿。或者Windows文件系统里的Ubuntu目录在哪儿。

要把一个Windows路径变成Ubuntu路径（或者反过来），你需要做：

  • 打开Ubuntu终端
  • 使用wslpath "C:\Program Files"命令来把Windows路径变成Ubuntu路径
  • 使用wslpath -w "/home"命令来把Ubuntu路径变成Windows路径
  • 还有，wslpath -w $(pwd)命令会返回当前Ubuntu路径的Windows路径

设置完成啦!

现在你的电脑已经完成Le Wagon网页开发课程的设置啦 💪 👏

享受你的编程之旅，你会掌握它的！ 🚀