Skim’s Blog

Complete Debian 13 Development Environment Setup

Wed, 07 Oct 2026 00:00:00 GMT

😀

This guide describes how I set up a complete development environment on a Debian 13 (Trixie) x86_64 server.

The goal is to have one server that can handle:

C / C++ development

Haskell development

Python development

Java development

Web development

Docker containers

AI-assisted coding

Local LLMs

General software development

📝 Complete Debian 13 Development Environment Setup

This guide shows how I set up my Debian 13 Linux server for development, programming, Docker, AI tools, and basic server security.

This server environment:

OS: Debian GNU/Linux 13 (Trixie)

Architecture: x86_64

Use: Development, AI tools, Docker, programming, and server hosting

1. Change the Linux Password

After logging into a new Linux server for the first time, I recommend changing the default user password.

To change the password of the current user:

You will see:

When entering a password, nothing will appear on the screen. This is normal.

To change another user's password:

For example:

If you still have sudo access but forgot the current password:

After changing the password, you can test it by reconnecting through SSH.

2. Update the System

First, update the system:

Install some basic tools:

3. Install Programming Languages

Java

Install Java 21:

Check:

Python

Check:

C / C++

Check:

Haskell

Check:

4. Install Anaconda

Reload the shell:

Check:

5. Install uv

Add uv to the current PATH:

Or:

Check:

If you see:

run:

Then:

6. Install Node.js

Check:

7. Install Git

Configure Git:

8. Configure GitHub SSH

Show the public key:

Add the key to GitHub, then test:

9. Install Docker

Install Docker and Docker Compose:

Allow the current user to use Docker:

Log out and log in again after this.

Check:

10. Install AI Coding Tools

OpenAI Codex

Claude Code

Pi

Check:

11. Install Antigravity CLI

Add it to PATH:

Make it permanent:

Reload:

Check:

12. Install Ollama

Enable the service:

Check:

13. One-Command Installation Script

For a fresh Debian 13 server, you can also combine most of the setup into one script.

Create the script:

Paste the following:

Save the file and make it executable:

Run it:

After the installation finishes, log out:

Then reconnect to the server.

14. Install Useful Server Tools

15. Install tmux

Start:

Detach:

Reconnect:

This is useful for running programs on a remote server without worrying about an SSH disconnect.

16. Configure the Timezone

For a Malaysia-based server:

Check:

17. Configure Firewall

Install UFW:

Allow SSH:

Enable:

Check:

For a web server:

Only open the ports that are actually needed.

18. Secure SSH

Backup the configuration:

Edit:

If SSH key login is already working:

Test:

Restart:

Important: Make sure SSH key login works before disabling password authentication.

19. Install Fail2ban

Check:

20. Limit Docker Logs

Create:

Add:

Restart Docker:

21. Check RAM and Swap

Check Swap:

If necessary, create a 4 GB Swap file:

Make it permanent:

22. Check Disk Space

Check /var:

Or use:

This is especially useful when using Docker and Ollama because they can use a lot of disk space.

23. Enable Automatic Security Updates

Configure:

Select:

24. GitHub SSH

If you often need to do:

It is recommended to set SSH Key:

Check:

Then add this public key to GitHub.

Test:

25. Useful Server Commands

Check CPU and RAM:

Check memory:

Check disk:

Check processes:

Check network:

Check open ports:

Check uptime:

Check Docker:

Check Ollama:

26. Final Server Check

27. Final Environment

Conclusion

After completing these steps, the Debian 13 server is ready for development, programming, Docker, AI tools, and basic server hosting.

The most important things are not only installing software. You can also need to take care of security, SSH access, firewall rules, passwords, disk space, RAM, Docker logs, and system updates.

This setup may gives you a simple and practical development server that you can use for coding, AI experiments, Docker projects, and personal services.

Some Useful Linux Websites You Might Use

Here are some websites that I often find useful when working with Linux servers.

1. Linux Documentation

Linux man-pages

Useful for learning Linux commands and system functions.

Linux man-pages

Example:

2. Debian Documentation

The official Debian documentation is useful when working with Debian servers.

Debian Documentation

It includes installation guides, system administration information, and Debian manuals.

3. Debian Packages

When I want to check whether a package is available in Debian, I can use the Debian Packages website.

Debian Packages

For example, I can search for packages such as:

4. Ubuntu Documentation

Even when I am using Debian, Ubuntu documentation can sometimes be useful because many Linux commands and concepts are similar.

Ubuntu Documentation

5. Linux Journey

Linux Journey is a beginner-friendly website for learning Linux.

Linux Journey

It covers topics such as:

Command line

Permissions

Processes

Networking

File systems

Shell scripting

6. ExplainShell

When I find a complicated Linux command, ExplainShell can help me understand it.

ExplainShell

For example:

It can explain what each part of the command does.

7. Docker Documentation

If I use Docker, the official Docker documentation is one of the most useful resources.

Docker Documentation

It covers:

Docker

Docker Compose

Images

Containers

Volumes

Networks

Dockerfiles

8. Python Documentation

For Python development:

Python Documentation

This is useful for checking Python syntax, standard libraries, virtual environments, and other features.

9. Git Documentation

For Git:

Git Documentation

Useful commands include:

10. GitHub Docs

For GitHub-related problems:

GitHub Docs

It is especially useful for:

SSH keys

GitHub Actions

Repositories

Pull Requests

GitHub CLI

Authentication

11. Stack Overflow

When I have a programming or Linux problem, Stack Overflow is often useful for finding solutions from other developers.

Stack Overflow

A good approach is to search for the exact error message.

For example:

12. Server Fault

Server Fault is useful for more advanced server and system administration questions.

Server Fault

It is especially useful for:

Linux servers

Networking

Web servers

System administration

13. DigitalOcean Community

DigitalOcean has many practical Linux and server tutorials.

DigitalOcean Community Tutorials

The tutorials cover topics such as:

Linux

Docker

Nginx

Databases

Networking

Server security

14. ArchWiki

Even if I am not using Arch Linux, the ArchWiki is one of the best Linux references available.

ArchWiki

Many of the explanations about Linux concepts are useful on Debian and other distributions too.

15. Linux Kernel Documentation

For more advanced Linux topics:

Linux Kernel Documentation

This is useful when learning about the Linux kernel, drivers, networking, and system internals.

My Most Useful Websites

If I only need a few websites, I would start with:

Debian -- Documentation
Debian -- Documentation
Creating a high-quality free operating system also includes writing technical manuals which describe the operation and use of programs. The Debian project is making every effort to provide all users with good documentation in an easily accessible form. This page contains a collection of links, leading to installation guides, HOWTOs, FAQs, release notes, our Wiki, and more.

Linux man pages online
Linux man pages online
The links from this page display HTML renderings of the man pages from the Linux man-pages project as well as a curated collection of pages from various other free software projects.

Docker DocumentationHome
Home
Docker Documentation is the official Docker library of resources, manuals, and guides to help you containerize applications.
Docker Documentation

GitHub DocsGitHub.com Help Documentation
GitHub.com Help Documentation
Get started, troubleshoot, and make the most of GitHub. Documentation for new users, developers, administrators, and all of GitHub's products.
GitHub Docs

Stack OverflowNewest Questions
Newest Questions
Stack Overflow | The World’s Largest Online Community for Developers
Stack Overflow

ArchWiki
ArchWiki
Welcome to the ArchWiki: your source for Arch Linux documentation on the web.

Tutorials | DigitalOcean
Tutorials | DigitalOcean
Follow along with one of our 8,000+ development and sysadmin tutorials.

DistroSeaTest Linux distros online - DistroSea
Test Linux distros online - DistroSea
Instantly test run Linux distros online in the cloud for free, right from your web browser. No installation or live boot required.
DistroSea

GeeksforGeeksBasic Linux Commands - GeeksforGeeks
Basic Linux Commands - GeeksforGeeks
Your All-in-One Learning Portal: GeeksforGeeks is a comprehensive educational platform that empowers learners across domains-spanning computer science and programming, school education, upskilling, commerce, software tools, competitive exams, and more.
GeeksforGeeks

OmarchyThe Manual - Omarchy
The Manual - Omarchy
The Omarchy manual: installation, navigation, hotkeys, themes, plugins, and everything else about running the OS.
Omarchy

Omarchy 手册
Omarchy 手册
本文件依据 Omarchy 官方手册当前默认 quattro 分支整理并翻译, 原文入口为 Omarchy Manual, 源码位于 omacom/omarchy/manual. 原项目采用 MIT License.

Linux 命令速查表 & linux-command cheatsheet & Quick Reference
Linux 命令速查表 & linux-command cheatsheet & Quick Reference

50+ Essential Linux Commands: A Comprehensive Guide | DigitalOcean
50+ Essential Linux Commands: A Comprehensive Guide | DigitalOcean
Master essential Linux commands for file management, process control, networking, and system administration, from basic to advanced Linux commands

These websites cover most of the common problems I may encounter when using a Linux server.

Jom to UoSM

Sat, 05 Sep 2026 00:00:00 GMT

🔥

Special thanks to Bryan – our host and server manager. He funded the server, set everything up, and handles all the day‑to‑day operations and administration. From choosing the modpack and configuring the backend, to drafting the rules and keeping the community running smoothly – every part of this SMP exists because of his time and dedication. Without his passion and effort, this community simply wouldn’t be here.

We also ask everyone to enjoy the game while keeping the admin’s hard work in mind – please follow the rules and help us maintain this fun, friendly world we’ve built together.

Once again, our deepest gratitude to Bryan! 🎉🙏

📝 Jom to UoSM

📋

Server Rules (Quick Recap)

No griefing

Don’t be a jerk: no stealing; PvP is allowed, but spawncamping is not.

Have fun

The End is locked for the first 7 days (to slow down early dragon kills).

Server is hosted in Singapore, running in offline/insecure mode – you do not need a paid Minecraft account.

CUT DOWN YOUR TREES FULLY！

🛠️ Step 1 – Choose a Launcher

Recommended: X Minecraft Launcher (XMCLXMCL - A fully featured Minecraft launcher | XMCL
XMCL - A fully featured Minecraft launcher | XMCL
Empower Your Minecraft Experience with modern launcher
XMCL
).

If you prefer another launcher (e.g., MultiMC, Prism, GDLauncher), the steps are similar – you can find guides online.

📦 Step 2 – Get the Modpack (UoSMP)

The pack is currently still under review on CurseForge, so auto-install from the launcher may not work yet.

Go to the modpack page:https://www.curseforge.com/minecraft/modpacks/uosmp Or download here

📎

Default Pack: https://sotonac-my.sharepoint.com/:u:/g/personal/bweo1f24_soton_ac_uk/IQBVwr_0OqyBRZBbS6TJzbUOAcm8aNedyMJRumCx6FIEO1k?e=47VFIb

Zip file:

UoSMP-0.0.1.zip

153.3 MiB

📎

Lite Version: https://sotonac-my.sharepoint.com/:u:/g/personal/bweo1f24_soton_ac_uk/IQBboSP0LS_SQq0t0raego8MAdGh7FeCwvo9U2cwWMoEzkY?e=HyRtnA

Zip file:

UoSMP-0.0.1-LITE.zip

153.3 MiB

Click "Download" to get the .zip file manually.

Save it somewhere you can find easily.

Once the pack is approved, you’ll be able to search for UoSMP directly inside your launcher and install it with one click.

🖥️ Step 3 – Install the Modpack Manually (for X Launcher)

Open X Minecraft Launcher.

On the left sidebar, look for the “Import” button (it usually looks like a folder or a plus icon).

Select the UoSMP.zip file you downloaded.

The launcher will unpack and install all mods automatically.

After it finishes, select the pack from your versions list and click Launch.

For other launchers: the import option is usually called “Add instance” or “Import from zip” – use that.

🌐 Step 4 – Connect to the Server

Once in-game, go to Multiplayer → Add Server.

Enter the server IP/domain “ 23.109.123.95:25592 ”.

23.109.123.95:25592

Because the server is in offline mode, you don’t need to log in with a Microsoft/Mojang account. Just set your username in the launcher’s account settings (choose “Offline” mode and type your desired name).

Click Join Server – and you’re in!

⚠️ Common Tips & Troubleshooting

First launch may take a while as it downloads additional resources – be patient.

If you get missing mod errors, try re‑importing the zip or check your internet connection (CurseForge may be slow in some regions).

The End portal will be inaccessible for the first 7 days – after that, it opens automatically.

Remember the rules – breaking them can get you kicked or banned.

If you are still experiencing FPS Issues on the LITE pack, you can go into resource packs and click on the button on the top left

and select LITE, you can also do this on the Default pack if your FPS dips just a little.

Mod List Guide

🧱 Content Mods (Core Gameplay)

Mod	What it does	How to get started
Create	Build contraptions and automate processes using rotational power. Adds many mechanical components and block variants.	Use the Ponder function (hover over any Create item and hold the key prompt) or check the official wiki.
Refined Storage	Store large quantities of items easily, with autocrafting and automation.	Craft a controller, drives, and disks, then connect a terminal to access your network.
Iron's Spells 'n Spellbooks	RPG‑style magic system with spells and spellbooks.	Find spellbooks and a wand, then follow in‑game guides to learn spells.
Iron's Gems & Jewelry	Craft modular jewelry pieces with different patterns and materials.	Hunt for jewelcrafting patterns, then use a jewelry workbench to create your pieces.
Block Pack	Adds 1200+ decorative and functional furniture blocks in vanilla style.	Start by crafting the Blockpack Workbench to browse and craft all blocks.
NetherEx	Expands the Nether with new biomes, blocks, items, and mobs.	Explore the Nether normally – new content appears naturally.
Farmer's Delight + addons	Adds a wide variety of new food and cooking mechanics.	Craft a cooking pot and cutting board, then start planting new crops.
Artifacts & Relics	Adds upgradeable wearable artifacts.	Press `E` to open your inventory and click the accessories icon next to your player model to equip them.
Malum	A magic mod focused on spirit arcana.	Read the in‑game guidebook called Encyclopedia Arcana.
Starcatcher	A high‑quality fishing overhaul.	Read the Starcatcher's Guide to learn the new mechanics.
Simply Swords	Adds many unique new swords.	Craft or find them – no special guide needed.
Enchanted	Adds ~120 new enchantments.	Use an enchanting table or find them in loot.
Modified	Adds equipment tiers with modifiers; lets you upgrade and reroll stats.	Use the Reforging Anvil to ascend items to higher tiers and reroll modifiers.
Immersive Aircraft	Adds flyable airplanes.	Craft plane parts and assemble them.
Exposure	Adds a realistic camera and photo development system.	Craft a camera, film, and set up a darkroom to develop photos.
Joy of Painting	Allows you to create pixel art and place it on canvases.	Open the painting interface and start drawing.

🛠️ QOL / Utility Mods

Mod	What it does	Keybind / How to use
JEI + addons	Recipe viewer: shows how to craft items and what they're used for.	Hover over an item and press `R` to see recipes, `U` to see uses.
Xaero's Map	Minimap + full‑screen map with waypoints.	Press `M` to open the full map; you can add waypoints from there.
Ping Wheel	Send location pings to other players.	Default: Mouse Button 5 (configurable). Adjust max ping distance in settings if it gets noisy.
Simple Voice Chat	Proximity‑based voice chat in game.	Press `N` to open the configuration menu.
Mouse Tweaks	Quickly move items with the mouse wheel.	Hover over a slot and scroll to transfer one item at a time.
Gravestones	Keeps your items on death – a gravestone appears.	Break your own gravestone to retrieve your items (only the owner can).
Lootr	Makes chest loot per‑player – everyone can loot the same chest independently.	Do not break the chests – just right‑click to claim your loot.
Comforts	Adds sleeping bags (lets you sleep without resetting spawn point).	Craft and use a sleeping bag.
Keybind Atlas	Visual overview of all keybinds.	`Esc` → Options → Controls → Open Keybind Atlas.
Quick Skin	Change your skin in‑game.	Open the mod interface and select a new skin.
Grind Enchantments	Transfer enchantments from an item to a book (item is returned unenchanted).	Put an enchanted item + a book into a grindstone – you get the enchanted book and the clean item back.

📌 Quick Tips for New Players

When you first join, press E and check your accessories slot (next to your character).

Browse JEI – type @create or @refined to quickly see all items from those mods.

Use the Ponder feature for Create – it's more helpful than reading wikis.

Set up your Voice Chat and Ping Wheel early – they make team coordination much easier.

📌 Final Note

💡

If you run into any issues (e.g., launcher-specific questions), feel free to ask. Otherwise, enjoy the server! 🎮

Once again, huge thanks to Bryan for hosting and managing this server – it takes a lot of his time, effort, and money behind the scenes. If you're enjoying the experience and feel like showing a little extra appreciation, you're welcome to buy him a coffee – this is completely optional and not required at all.

Here is the donation link (Touch ‘n Go E-Wallet). But even if you don't, a simple "thank you" goes a long way in letting him know his work is valued. ☕

Mac系统配置

Sat, 29 Aug 2026 00:00:00 GMT

😀

这里写文章的前言：一个简单的开头,简述这篇文章讨论的问题、目标、人物、背景是什么？并简述你给出的答案。

可以说说你的故事：阻碍、努力、结果成果，意外与转折。

Mac 是大多数程序员的主力机器。如今各个互联网公司都会给员工配备 Mac 电脑，而拿到新电脑不免要鼓捣一番，安装各种环境、插件、软件等，以让自己用着更顺手。

本文记录了我从零开始配置一台新 Mac 的过程，基于我日常的开发习惯。尽管具有一定的主观性，但依然有相当的参考价值，读者可以按需选用。

建议首先完成系统设置和科学上网，再进行其他步骤。前者完成 Mac 的一些初步设置，后者提高终端命令如 brew、git clone 的下载速度。

本文部分内容参考了 Github - bestswifter/macbootstrap。

系统设置

触控板设置

开启轻点点按：“系统偏好设置-触控板-光标与点按-轻点来点按”，打开该选项。这样无需按下触控板即可点击。

开启三指拖动：“系统偏好设置-辅助功能-指针控制-触控板选项-启动拖移”，打开该选项，并选择“三指拖移”。这样在移动窗口、拖动选择大片文字等时不需要按下触控板，只需要三指在触控板上拖动即可。

默认情况下，“左右切换全屏幕窗口”、“显示调度中心”三指/四指均可。开启三指拖动后，这两个操作自动换为四指。

关闭文件验证、App 验证

跳过打开 DMG 文件时的验证过程：

默认情况下系统禁止安装第三方 App，通过以下代码绕过限制：

禁用文字自动更正

随便打开一个文本编辑框，如“信息”，尝试以下输入会发现：

' / " 被替换为了 ‘ / “

sdgs 被替换为了 Sdgs，首字母自动大写

-- 被替换为了 —

通过以下命令禁用：

也可以在“系统设置-键盘-文本”中设置。

打开全键盘控制

系统经常会出现如下图所示的 Confirm 框，包含“确定”、“取消”两个选项：

默认情况下，我们只能通过「回车」选择“确定”，如果想选择“取消”，必须通过鼠标点击。打开全键盘控制后，通过 Tab 键切换选项，聚焦到“取消”上，然后按下「空格」，就可以选择“取消”。

在“系统偏好设置-键盘-快捷键”页面下方，打开全键盘控制：

注意：无论焦点聚焦于哪个选项，按下「回车」都相当于是选择 “确定”。

当然，如果有 Touch Bar，可以直接在 Touch Bar 上完成操作。

显示电量百分比

点击状态栏电源图标，选择“显示百分比”。

加速 Zoom 动画

双击应用标题栏时，会自动调整窗口大小。下面的代码可以加速调整动画：

下文提到的插件 Moom 也可以快速调整窗口大小。

关闭触控板前进后退

在浏览网页时，可以在触控板两指水平轻扫，控制页面的前进后退。

图：在 Chrome 中两指右扫，会出现页面后退提示符

但实际场景下，这个功能基本没用，且误触频率很高 (和页面的水平滚动条冲突)。建议关闭：系统设置 - 触控板 - 更多手势 - 在页面之间轻扫，取消勾选。

开发环境

Homebrew

Homebrew 是 Mac 下的软件包管理工具，既可以用来安装开发环境，也可以用来安装 App Store 应用。

安装 Homebrew：

如果报错 Failed to connect to raw.githubusercontent.com port 443: Connection refused，重开一个终端窗口就可以了。

如果 Homebrew 速度很慢，需要配置终端科学上网。

iTerm2

安装：

快捷键：

光标移动：

⌃+A/E：光标移动到开头/结尾
⌃+W/U：删除光标前一个单词/所有内容
⌥+←/→：光标左/右移动一个单词（需要配置，见下文）

Tab 切换：

⌘+T：新建 Tab
⌘+数字：选择某一 Tab
⌘+←/→：左/右切换 Tab
这些快捷键在 Chrome 下也适用

Pane 相关：

⌘+D / ⌘+⇧+D：新建 Pane
⌘+⌥+方向键：切换 Pane
⌘+⌃+方向键：调整 Pane 大小

文本选择：

iTerm2 默认选中即复制，不需要“先选中，再复制”
双击选择单词，三击选择整行，按下 ⌘+⌥ 矩形选择

如果命令写错怎么办？

简单的方法：↑，重新编辑上一条命令

^{old}^{new}：这个命令可以将上一条命令的 {old} 部分替换为 {new} 重新执行，比如 vim a.txt 不小心写成 vom a.txt，可以执行 ^vom^vim

thefuck：输错一个命令时，直接输入一个 fuck，错误自动纠正，瞬间神清气爽

对于特别长的命令，可以使用 zsh 提供的快捷键 Ctrl-x + Ctrl-e 进入 vim 编辑

配置“光标左/右移动一个单词”：“Preferences-Profiles-Keys”，找到快捷键 ⌥←，双击，弹出如下的对话框，Action 选择“Send Escape Sequence”，Esc+b 表示向前移动。双击 ⌥→，Esc+ 后面填 f 表示向后移动。

vim 语法高亮

首先执行 cp /usr/share/vim/vimrc ~/.vimrc 复制 vim 配置文件，然后执行 vim ~/.vimrc，添加以下内容：

zsh 插件

Mac 自带了 zsh，执行 zsh --version 检查是否安装了 zsh。

安装 oh-my-zsh：

当 oh-my-zsh 安装成功后，我们会看到终端的文本不再是单调的白色，而是有了不同的颜色。这是因为 oh-my-zsh 提供了很多主题，可以通过编辑 ~/.zshrc 中的 ZSH_THEME 字段修改，默认是 robbyrussell。服务端我使用 jonathan。

oh-my-zsh 提供了一个 ~/.zshrc 模板，安装后会替换默认的 ~/.zshrc。下面以安装 oh-my-zsh 后的 ~/.zshrc 为准。

安装完成后，oh-my-zsh 会自动设置为默认 shell 工具。如果设置失败，手动执行：

此时再重新登录 shell，就可以看到效果了！

安装 zsh-autosuggestion 与 autojump：

zsh-autosuggestion 可以根据当前输入的内容，自动提示之前执行过的命令。补全命令的快捷键是 →，如果觉得方向键离键盘热区较远，也可以使用 End（Mac 下是 Fn + End）。

autojump 可以快速跳转到某个目录，比如当我们执行过 cd ~/some-file 后，执行 j some、j so、j sf 都可以跳转到 ~/some-file 目录下。

安装 zsh-syntax-highlighting：

输入命令后，如果命令正确，则高亮为绿色，反之高亮为红色。

安装完后，还需要在 ~/.zshrc 中加载这些插件，才能生效。执行 vim ~/.zshrc，找到 plugins=...，其内容如下所示：

改成这样：

然后 source ~/.zshrc 使插件生效。执行以下命令，验证插件是否安装成功：

验证 autojump：首先执行 cd ~/Downloads 跳转到目录 ~/Downloads，然后只需要输入目录的若干个字符：j dow，就可以自动跳转到 ~/Downloads

验证 zsh-autosuggestions：输入之前执行过的命令的前几个字符，就会自动提示完整命令，按 → 可补全

同步 bash 配置： 在 ~/.zshrc 的开头加入这两行（有的文件可能不存在，自行删除对应行）：

Git 配置

git commit 要求设置用户名和邮箱，通过以下命令设置，省略 --global 只对当前仓库设置：

为常用 git 命令设置更短的别名（~/.gitconfig）：

高效插件

系统资源查看 RunCat

这款软件主要可以快速查看电脑CPU、内存、储存、电池和网络的具体情况

可以通过Homebrew来下载

扩展预览程序：QuickLookPlugins

Mac 的预览程序十分方便，按下空格可以快速预览几乎所有文件，安装插件可以扩展其功能。Github - sindresorhus/quick-look-plugins 提供了一系列可供选用的插件，以及每个插件的介绍、截图、源码。

我选择通过 Homebrew 安装自己需要的几个插件：

每个插件的功能：

qlcolorcode：增加代码高亮

qlstephen：预览没有后缀名的纯文本文件，如 README

qlmarkdown：预览 Markdown 文件，自动渲染

quicklook-json：预览 JSON 文件

qlimagesize：预览图片时，显示图片大小与分辨率

其他插件请在 Github - sindresorhus/quick-look-plugins 自行选用，Catalina 系统的安装方法见 README。

快速调整窗口大小：Rectangle

Moom 是一款收费软件。推荐功能类似的免费软件：Rectangle

MacOS Homebrew国内镜像加速完整指南：解决安装慢、下载卡顿问题

Sat, 05 Sep 2026 00:00:00 GMT

😀

在MacOS上使用Homebrew（简称brew）安装软件时，许多用户都会遇到官方源访问慢、formula.jws.json文件下载超时、软件包拉取卡顿等问题——这是因为Homebrew默认连接的官方服务器位于海外，国内网络环境下容易出现网络波动或带宽限制。

📝 MacOS Homebrew国内镜像加速完整指南：解决安装慢、下载卡顿问题

一、为什么需要配置Homebrew国内镜像？

Homebrew的核心功能依赖两个关键资源：

软件包元数据：每次执行brew install或brew update时，都会从官方地址https://formulae.brew.sh/api/formula.jws.json下载软件包信息（如版本、依赖、下载链接），国内访问该地址常因网络延迟导致超时；

软件包本体：官方软件包（称为“bottle”）存储在海外服务器，下载速度通常只有几十KB/s，安装一个稍大的软件（如Python、Node.js）可能需要等待十几分钟甚至更久。

而国内镜像源（如中科大、清华等高校或企业提供的镜像）会实时同步Homebrew官方资源，将数据存储在国内服务器，访问速度可提升至几MB/s，彻底解决“安装慢”的痛点。

二、推荐的Homebrew国内镜像源

目前国内稳定可用的Homebrew镜像源主要有两类，综合稳定性和同步速度，优先推荐中科大（USTC）镜像——其同步频率高、支持完整的Homebrew生态（包括brew本体、core核心库、bottle软件包、API接口），且2025年仍保持活跃维护。

镜像类型	中科大（USTC）镜像地址	作用说明
Homebrew本体（brew.git）	https://mirrors.ustc.edu.cn/brew.git	存储Homebrew核心程序代码，影响`brew`命令基础功能
Homebrew核心库（core.git）	https://mirrors.ustc.edu.cn/homebrew-core.git	存储软件包元数据（如安装规则、依赖关系）
Bottle软件包域名	https://mirrors.ustc.edu.cn/homebrew-bottles	加速软件包本体下载（如Python、Git等二进制包）
Homebrew API接口	https://mirrors.ustc.edu.cn/homebrew-bottles/api	2025年新版brew依赖的API接口，获取软件包最新信息

注意：阿里镜像曾因Git Clone兼容性问题导致部分软件安装失败，2026年仍未完全解决，因此暂不推荐。

三、配置Homebrew国内镜像

配置过程仅需3步，适配所有MacOS版本（包括Sonoma、Ventura），且支持bash和zsh两种终端（MacOS新版默认使用zsh）。

步骤1：打开终端配置文件

根据你使用的终端类型，执行对应的命令打开配置文件：

zsh用户（推荐，MacOS默认）：

bash用户：

打开后会进入vim编辑模式（按i键切换到“插入模式”，此时可以输入文字）。

步骤2：添加镜像配置代码

在配置文件的末尾粘贴以下代码（直接复制即可，无需修改）：

粘贴完成后，按Esc键退出“插入模式”，再输入:wq（冒号+w+q）并按回车，保存配置并退出vim。

步骤3：让配置生效

执行以下命令，加载刚刚修改的配置文件，使其立即生效（无需重启终端）：

zsh用户：

bash用户：

四、测试加速效果：安装软件秒级完成

配置完成后，我们通过安装一个常用软件（如GitHub命令行工具gh）测试速度：

此时终端会显示下载地址为中科大镜像（如https://mirrors.ustc.edu.cn/homebrew-bottles/gh-xxx.tar.gz），下载进度条会以几MB/s的速度推进，原本需要几分钟的安装过程，现在几十秒内即可完成（如下图所示）：

如果仍遇到下载慢，可执行brew update更新Homebrew索引后再尝试——更新过程也会使用国内镜像，速度同样会大幅提升。

五、常见问题排查（2025年适用）

配置后执行brew命令提示“command not found”

原因：配置文件路径错误。解决方案：确认终端类型（执行echo $SHELL，输出/bin/zsh则为zsh，/bin/bash则为bash），重新执行对应终端的配置文件编辑和生效命令。

下载软件时提示“SSL证书错误”

原因：MacOS系统时间与网络时间不同步。解决方案：打开“系统设置→日期与时间”，勾选“自动设置日期与时间”，同步后重新执行安装命令。

brew update时提示“git pull failed”

原因：之前使用过其他镜像，导致本地Git仓库冲突。解决方案：执行以下命令重置Homebrew仓库并重新同步：

Windows 开发环境配置

Wed, 12 Aug 2026 00:00:00 GMT

😀

这里写文章的前言：本文旨在帮助一些希望入门CS的同学亦或是最近刚刚更换新的Windows电脑的伙伴重新从0开始配置一些Windows基础设置，提高电脑的好用效率，毕竟如孔子所言“工欲善其事，必先利其器”

📝 主旨内容

0. 前置条件

本文的内容虽然很简单，但仍然列出了一些前置条件，对于不满足的读者，可以在完成前置条件后再阅读本文。

本文内容基于 Windows 10/ Windows 11。

了解 Shell、终端、cmd、powershell 等概念。如果你刚刚接触编程，还弄不清楚这些名词之间的关系，可以先行了解。

了解包管理器的作用。如果没有使用过包管理器，或者完全不了解包管理器的概念的话，可以搜索 apt、homebrew 等关键词，快速了解其作用。

掌握科学的上网姿势。作为一名开发者，如果缺乏科学的上网姿势，将会常常遇到不方便的问题。关于如何以科学的姿势上网，本文不做讲解，需要大家自行掌握。

1. 使用 Powershell 作为默认终端

终端是程序员使用频率相当高的工具，提到 Windows 的终端，很多人的第一反应还是 cmd，过时且丑陋难用。幸运的是，微软已经开发了现代设计的新终端：Windows Terminal，并预装在了 Windows 10/11 系统中。可以尝试在本机搜索应用「Windows Terminal」或「终端」：

图1

如搜索不到，说明系统较老，没有得到预装，可以在 Microsoft Store 中搜索「Windows Terminal」安装即可，如图：

图2

最后，我们将其配置为默认终端，打开「设置」→ 「隐私和安全性」→「开发者选项」→「终端」，选择 Windows Terminal 即可，如图：

图3

2. 配置 PowerShell

2.1 安装最新版本的 PowerShell

作为开发人员，和终端命令打交道是必不可少的，Linux 和 MacOS 上都有诸多 Shell 可供选择，如 Bash、ZSH、Fish 等等，其中 ZSH、Fish 等选择可以通过安装插件提供诸如语法高亮、命令自动补全等功能，极大提高工作效率。而在 Windows 系统上，最官方正统的当然就是 PowerShell 了，其实通过简单的配置，PowerShell 也可以拥有不少方便的功能。

首先，我们先安装最新版本的 PowerShell。打开 Windows Terminal，此时应该可以看到标签页上已经显示了「Windows PowerShell」的字样，是的，此时打开的已经是预装的 PowerShell 了，但预装的版本往往比较旧，因此我们先装最新版本的 PowerShell，输入命令 winget search powershell ：

图4

可以看到目前的最新版本是 7.3.4，输入命令 winget install Microsoft.PowerShell 进行安装，安装成功后，重新打开 Windows Terminal，可以看到标签组里多了一个 PowerShell 的选项，这就是我们安装的最新版本的 PowerShell：

图5

可以在 Windows Terminal 的设置中选择最新版本的 PowerShell 作为默认启动项

2.2 配置 PSReadLine

接下来我们使用 PSReadLine 来提升终端工作效率。PSReadLine 是 PowerShell 的官方模块，旨在为 PowerShell 控制台提供强大的命令行编辑体验，其功能包括：

命令行的语法着色

语法错误的直观指示

编辑和历史记录

可自定义的键绑定

预测 IntelliSense

等等。如何使用这样强大的模块呢？其实非常简单，只要编辑 PowerShell 的配置文件即可，在终端输入命令：$PROFILE，可以看到 PowerShell 配置文件的路径，使用文本编辑器，如记事本、VSCode 等打开并进行编辑，这里提供两份示例：

示例1:

示例2:

PSReadLine 还提供有相当多的功能，这里列出 PSReadLine 的一些相关文档和网站：

关于 PSReadLine - PowerShell | Microsoft Learn

https://github.com/PowerShell/PSReadLine

如果希望定制功能，可以参考文档自己 DIY，只需要按照示例的样子填写到 PowerShell 配置文件里就可以了。当然，现如今你也可以完全询问ChatGPT、Claude关于具体的定制功能，同时可以直接下载Claude Code、Codex等工具，直接让他们在终端里帮你配置。

3. 安装 Scoop 包管理器

接下来介绍 Windows 的包管理器。什么是包管理器呢？一言以蔽之，就是终端下的软件商店，和苹果的 App Store、微软的 Microsoft Store 的概念差不多，只不过是用命令行来交互罢了。终端命令行下的软件商店，自然非常适合安装开发者工具啦，尤其是那些没有 GUI 的开发工具。Windows 的开发体验，一直以来一直被诟病的问题之一就是包括缺少良好的包管理器。如果细心观察会发现，和 Linux、MacOS 相比，网络上存在大量教学「如何在 Windows 上安装 XXX 软件/开发环境」的文章，一般的教学步骤都是先去官网下载软件包，然后使用下载好的软件包进行安装，最后讲解如何配置环境变量等等。然而如果有包管理器，这样的安装过程将会非常简单，只需要一条命令，包管理器就会自动地帮你下载、安装软件，并自动配置好环境变量。

还记得上文安装 PowerShell 时提到的「winget」么？这就是一个包管理器，只要 winget install 软件名 这样的命令就完成了软件的安装与环境配置，是不是非常简单呢？不过本文要推荐的包管理器，并不是微软官方的 winget，而是第三方的 Scoop。笔者一向推崇原生、官方的软件，但是在长期的使用中，必须要承认 scoop 目前要比 winget 好用太多了，非常适合安装开发工具/环境。Scoop 对干净、简洁的追求，例如避免环境变量污染、避免安装和卸载时的副产品、使用 portable 的软件包等等，完美符合系统洁癖型用户的需求，更多 Scoop 的信息可以参见官网：Scoop。接下来，我们进行 Scoop 的安装和使用简介，使用 Windows Terminal 打开 PowerShell，并输入以下命令：

等待安装完成后，输入 scoop 并回车，如果看到以下的画面就说明安装成功了：

图6

首次使用时，建议输入 scoop checkup 命令，可以看到缺少一些必要的软件，如 7zip、innounp、dark、git 等，按照提示进行安装即可。Scoop 的使用和一般的包管理器差不多，例如使用 scoop search 软件包 进行搜索，使用 scoop install 软件包 安装软件，scoop list 会展示列出所有已安装的软件，scoop uninstall 软件包 可以卸载已安装的软件等等。如果你从来没有使用过包管理器，推荐去 Scoop 的官方网站了解更多内容，可以阅读文档了解更详细的使用方法。

这里就可以使用scoop来下载一些本人常用的开发工具，仅供参考，大家可以按需下载自己想要的软件

同时附上winget的下载命令

说明与建议：

PyCharm 版本：脚本默认安装的是免费的 PyCharm Community 版。若需要 Professional 专业版，可将 ID 替换为 JetBrains.PyCharm.Professional。

Microsoft 365 (Word/Excel/PowerPoint)：Microsoft.Office 整合包包含 Word、Excel、PowerPoint 等完整套件。

环境生效：安装完成后，建议重启计算机或重启 PowerShell 窗口，以确保环境变量正确加载。

全局安装（可选）：Scoop 默认将软件安装在当前用户目录（C:\Users\<用户名>\scoop）。如需安装给系统所有用户，可在 scoop install 后加上 -g 参数（此项操作需要管理员权限）。

提示：参数 --silent 会开启无界面静默安装；--accept-package-agreements 和 --accept-source-agreements 会自动同意软件许可协议，避免安装过程中弹窗提示确认。

4. 安装 WSL

上述的一系列配置都是为了提升 Windows 下的开发体验，但如果你非常希望拥有完全的 Linux 开发环境，同时又不希望放弃 Windows 便利的娱乐影音和丰富的软件资源，那么微软推出的 WSL 技术将很好的满足你的需求。WSL 提供了几乎完整的 Linux，同时各大主流的 IDE/编辑器，如 VScode、JetBrains 等，都提供了良好的开箱即用的支持。WSL 的安装非常简单，使用 Windows Terminal 打开 PowerShell，键入命令：

然后一步步等待安装完成即可。安装完成后可以在开始菜单看到 Ubuntu 的图标，点击进去后就是 WSL 提供的 Linux 系统，更方便的进入方式是直接使用 Windows Terminal，重新打开 Windows Terminal，可以看到标签组中已经多了 Linux 的选择：

图7

默认安装的 Linux 发行版是 Ubuntu，如果想选择其他的版本，或者想了解更多信息，可以浏览官方文档：适用于 Linux 的 Windows 子系统文档 | Microsoft Learn。

5. 终端配置与美化

前面的内容介绍了终端、Shell、包管理器、WSL 的等内容，如果你是第一次接触，那么应该可以获得明显的体验提升。不过俗话说颜值也是一种生产力，因此在本文的最后一部分，将会介绍一些终端美化的配置。由于 WSL 和真实的 Linux 环境基本一致，而 Linux 终端美化的文章已有很多，因此本文以 PowerShell 作为例子，不过很多配置都是通用的。首先放出效果图：

图8

为了实现这样的效果，我们首先需要安装 Nerd Fonts 字体，Nerd Fonts 是一大类字体，和一般的字体相比，Nerd Fonts 字体提供了更丰富的字符集，可以更好地支持终端下的显示效果，Windows 下推荐 CascadiaCode-NF-Mono 字体，可以很方便的使用 scoop 进行安装：

安装成功后，重新打开 Windows Terminal，并修改终端字体：

图9

字体搞定之后，使用 scoop 安装 oh-my-posh：

安装成功后，打开 PowerShell 的配置文件 $PROFILE ，增加一行：

注意其中的 atomic.omp.json ，这是我们选择的主题，如果想尝试其他的主题，仅修改这部分就可以了，更多的 oh my posh 文档和主题信息，可以浏览官网：Home | Oh My Posh。

最后，我们再调整一下配色方案就大功告成了。这里推荐一个 Github repo：https://github.com/mbadolato/iTerm2-Color-Schemes，里面提供了相当多的配色方案，且支持相当多的终端软件，使用 git clone 下来：

完成后进入 windowsterminal 子目录，里面的每一个 json 文件都对应了一种配色方案，比如选择 shades-of-purple.json。打开 Windows Terminal 的设置页面，点击左下角的「打开 JSON 文件」：

图10

打开配置文件后，在 schemes 节点粘贴 shades-of-purple.json 文件中的内容：

图11

保存文件后，回到 Windows Terminal 的设置，将配色方案选择 shades-of-purple 就大功告成了。

6.文档整理

针对平时想要查找某个文件的时候，打开文件夹却看到一堆杂乱无章的exe、json等文件，自己想要的文件看半天都没有找到，实在是让人头大。这里本人建议无论是在做什么的时候都养成文档整理的习惯。例如，本人习惯于在D盘中下载我平时用到的APP，因此我会在D盘中创建一个Software文件夹，在每次下载软件时，在Software这个文件夹下再新建一个对应APP的文件夹。例如，我要下载VSCode这个软件，因此我会创建D:software/VSCode这个文件夹，在此文件夹下下载VSCode的安装程序。

图

7.基础设置

同时作为一个重度FPS游戏🎮爱好者，对于电脑能发挥的性能要求自然比较高，因此也简单写一些关于Windows的基础系统设置，以方便在玩游戏时能够彻底榨干每个硬件的性能。

这里十分推荐OptimizerDuck这个集成软件，基本涵盖了平时常用的设置，例如C盘清理、基础设置以及启动项的开启与关闭。当然市面上也存在许多相同的Optimizer系统优化软件，功能上应该是大同小异。

下面我贴出一些我自己个人的设置

图

🤗 总结归纳

本文的内容并不针对任何的技术栈，而是从 Shell 配置、终端配置和包管理器配置的角度出发，提供一些经验和建议，我相信任何技术栈的开发者都可以受益。需要注明的是，本人并不是 Windows 技术栈的开发者，也不是 Windows 专家，因此本文中的某些内容或许并不是最优方案，如果有可以提高的地方，欢迎大家提出和交流，共同学习进步~

📎 参考文章

zhuanlan.zhihu.com

跟我一起玩MC

Sat, 29 Aug 2026 00:00:00 GMT

😀

这里写文章的前言：

这个教程其实是我自己折腾了一圈之后写的。

当初刚玩整合包联机的时候，该踩的坑一个没落下。启动器下了不知道点哪，整合包拖进去没反应，服务器地址反反复复打了七八遍还连不上。最后好不容易进去了，顶着一张默认皮肤，自己攒的半天的皮肤压根没机会穿。

所以本文旨在把整个流程从头走一遍，从PCL2怎么导入手头现有的整合包，到连接服务器play.simpfun.cn:41435，再到去LittleSkin换个皮肤，希望对你有帮助。

📝 PCL2 启动器完整联机教程

第一部分：获取 PCL2 启动器（如果你还没有）

若电脑上已有 PCL2，可跳过本部分，直接进入第二部分。

下载

官网下载：访问 https://pcl2.org/download 获取最新版本。

备用镜像：若官网打不开，可尝试国内镜像站（如 https://cloud.aoe.top/s/XyfP）。

下载后得到 .zip 压缩包。

安装（解压即用）

将压缩包解压到一个不含中文和空格的文件夹，例如 D:\\PCL2。

双击 Plain Craft Launcher 2.exe 即可运行。若系统提示风险，选择“仍要运行”。

提示：若双击无反应，请以管理员身份运行，或将文件夹加入杀毒软件白名单。

第二部分：导入现有的整合包（无需重新下载）

你可以直接使用我提供的整合包压缩文件（格式为 .zip）：

1.21.1-Fabric 0.19.3.zip

4.4 MiB

打开 PCL2，进入主界面（左侧为版本列表）。

直接拖拽法（最快）：将整合包压缩文件拖拽到 PCL2 窗口的空白版本列表区域，松开鼠标，启动器会自动识别并弹出导入窗口。

菜单导入法：点击左下角 “版本选择” → 左侧 “导入整合包” → 在弹出的窗口中选择你的压缩包文件。

导入时，启动器会要求输入版本名称（可随意起名，例如“我的整合包”），点击确定。

PCL2 会自动解压并处理文件。如果该整合包依赖的 Minecraft 版本尚未下载，启动器会提示你下载对应的游戏核心（此时只需点击“下载”即可，这是正常的补全过程，不是下载新整合包）。

导入完成后，该整合包会出现在版本列表中，选中它即可准备启动。

注意：请确保你的整合包是完整可用的，如包含 mods、config 等文件夹，且版本号与服务器要求一致（见第三部分）。

第三部分：确认游戏版本与服务器兼容

在连接服务器前，务必确认你的整合包使用的 Minecraft 版本（如 1.20.1、1.19.2 等）与目标服务器 play.simpfun.cn:41435 所运行的版本完全相同。

若版本不匹配，进入服务器时会提示“无效的会话”或“无法连接”。

如何查看整合包版本：导入后，在版本列表中该整合包名称旁会显示版本号；也可进入游戏主菜单查看右下角。

如果不知道服务器版本，请向服主询问。

第四部分：连接服务器 `play.simpfun.cn:41435`

在 PCL2 中选中你的整合包，点击 “启动游戏”。

进入游戏主菜单后，点击 “多人游戏”。

点击 “添加服务器” 或 “直接连接”。

若选“添加服务器”：在“服务器名称”处随意填写（如“我的服务器”），在“服务器地址”处输入 play.simpfun.cn:41435。

若选“直接连接”：直接输入 play.simpfun.cn:41435 并点击“加入服务器”。

注意：冒号 : 必须是英文半角符号，不要误用中文冒号。

点击“完成”或“加入服务器”，稍等片刻即可进入。

常见连接失败原因及解决：

版本不一致：重新下载匹配版本的整合包或调整版本。

网络/防火墙拦截：关闭系统防火墙或添加 Minecraft 到允许列表；也可尝试更换网络环境。

服务器满员或维护：换个时间再试。

第五部分：使用 LittleSkin 设置个人皮肤

LittleSkin 为离线玩家提供皮肤服务，让其他玩家也能看到你的自定义形象。

5.1 注册并上传皮肤

浏览器打开 https://littleskin.cn，点击“注册”，使用邮箱完成注册。

登录后，进入 “用户中心” → “角色管理”，点击“添加角色”，输入你将在游戏中使用的角色名（此名字必须与进入服务器时使用的名字一致）。

进入 “衣柜”，点击“上传皮肤”，选择你的皮肤图片（PNG 格式，尺寸建议 64×64 或 64×32）。

上传后，在衣柜中将该皮肤分配给刚才创建的角色。

5.2 在 PCL2 中配置 LittleSkin 外置登录

关闭游戏，回到 PCL2 主界面。

点击左下角的 “版本设置”（齿轮图标），选择你正在使用的整合包版本。

在左侧菜单中点击 “设置”，滚动到最下方，找到 “登录方式”。

选择 “第三方登录”，然后在下拉列表中选中 “LittleSkin”。如果列表中没有，则选择“自定义认证服务器”，填入：

认证地址：https://littleskin.cn/api/yggdrasil

其他字段（如 token 等）留空即可。

保存设置，回到主界面，在登录框中输入你在 LittleSkin 注册时使用的邮箱和密码，点击“登录”。

此时 PCL2 会显示已登录的玩家名，即你在 LittleSkin 创建的角色名。启动游戏后，你的皮肤就会自动加载。

5.3 让服务器其他玩家看到你的皮肤（可选）

如果进入服务器后只有自己能看到皮肤，其他人看到的是默认皮肤，需安装 CustomSkinLoader（万用皮肤补丁）。

在 PCL2 的“下载”页面搜索 CustomSkinLoader，选择与你的 Minecraft 版本匹配的版本，点击安装，然后重启游戏即可。

第六部分：常见问题与解决方案

问题现象	可能原因	解决方法
启动器提示“无法找到Java”	未安装Java或路径错误	安装Java 8/17（根据版本需求），并在PCL2设置中手动指定Java路径
导入整合包后启动报错	整合包不完整或冲突	重新导入，确保压缩包未损坏；检查mods是否兼容
连接服务器时提示“无效的会话”	未登录正版或外置登录失败	确保LittleSkin登录成功，且角色名与服务器注册名一致
皮肤显示为黑色/没有皮肤	皮肤模型错误或加载失败	检查皮肤是否为Alex/Steve模型匹配；重新上传；安装CustomSkinLoader
联机时延迟高/卡顿	网络问题	尝试使用加速器；检查本地带宽；重启路由器

🎮

以上就是完整的教程，所有步骤均无需下载新整合包，只利用你现有的文件。有关MC & PCL2启动器安装或者使用上的问题，欢迎随时追问。祝你玩的开心腻！欢迎您在底部评论区留言，一起交流~