环境设置

这里的环境设置是指本地开发环境和服务器正式环境的设置。本地开发环境以 Windows 11 操作系统为例。服务器正式环境以 Debian 12（bookworm）为例。

本地开发环境

编程工具

JetBrains 系列产品推荐

• WebStorm: TypeScript 全栈开发者推荐，内置数据库支持，非商业用途可免费使用。
• PyCharm Pro: Python 全栈开发者推荐，内置数据库支持。
• Android Studio: Android 开发者推荐。

说明：WebStorm 和 PyCharm Pro 的 AI 体验相对较差，建议搭配 CC GUI 插件来使用，以在上下文选择上获得更好的交互体验。该插件支持 Claude Code 和 Codex。

产品对比

• PyCharm 包含 WebStorm 所有功能。
• WebStorm 和 PyCharm 虽然都内置数据库支持，但是配置的数据库是跟项目走的，也就是只要切换到新项目，就需要重新配数据库信息，即使新项目和旧有项目使用的是同一个数据库。如果你有很多项目，但是数据源比较固定的话，建议使用 DataGrip 来处理数据。

JetBrains 产品购买和避坑说明

购买 JetBrains 系列产品的年度订阅后，会获得 perpetual fallback license. 这样即使后续不再订阅，也可以永久使用早期版本（官方正版，非盗版）。

购买时请认准 .com 域名，不要在中国区（.com.cn 域名）购买。以 JetBrains 全家桶为例，在 .com 官网购买仅需 2000+ RMB，但是去中国区官网购买就需要 8000+ RMB。以 PyCharm Pro 为例，在 .com 官网购买需要 700+ RMB，但是在中国区购买则需要 2000+ RMB。也就是说在中国区购买单个产品的价格，放到 .com 官网已经可以购买全家桶了。

类 VS Code 系列产品推荐

• VS Code：相对中立，支持在右侧区域切换使用 Claude Code 和 Codex 官方插件。如果要安装国内 AI 插件的话，目前来看 CodeBuddy 的 VS Code 插件相对较好，其他比如 Trae 的 VS Code 插件基本不维护了。
• Trae IDE、CodeBuddy：不支持 Claude Code/Codex 官方插件，但是在 AI 上下文选择上交互比 VS Code 搭配插件更好。
• Cursor：它应该在这个列表中被列出来，不过自从公司停止订阅后，我很久没用过它了，不过多描述。

类龙虾产品

• Trae Work：字节出品。
• WorkBuddy：腾讯出品。

Cli 编程工具推荐

这些 Cli 工具可以直接在终端中使用，所以你可以单开终端来使用他们，也可以在 JetBrains 系列产品或者类 VS Code 等支持终端功能的 IDE 中通过终端来使用它们。

• Claude Code
• Codex Cli

文本编辑工具

其实最早大家谈论 IDE 和 编辑器时，VS Code 也是按编辑器来算的，只是现在类 VS Code 产品功能在 Language Service 和 AI 能力的加持下功能有了极大增强，所以现在将他们也归类成 IDE 了。现在，文本编辑工具，我只推荐一个：

• Sublime Text：非常轻量，打开速度极快，非常适合快速的进行文本修改，或者当备忘录和临时剪切板来使用也非常不错。

Sublime Text 推荐说明

即便你已经装了类 VS Code 工具，启动速度相对来说也不是很慢，也建议安装 Sublime Text，不仅是因为启动速度非常快，更重要的是很多时候我们需要一个相关纯粹的文本编辑环境：比如你的类 VS Code 工具可能配置了粘贴时自动格式化，但是你有些时候不希望粘贴内容被格式化；比如通常你的类 VS Code 打开时默认会打开上一次打开的项目，这时候你特意新建一个临时文件存放文本容易被误提交，用 Sublime Text 默认保存的文件不会存到你的仓库目录里。

版本管理工具

大部分团队都是使用 Git 来进行版本管理。

说明：点此查看 Git 常用命令。

终端环境

本地终端环境/工具

• Git bash：不用特意安装该环境，安装 Git for Windows 客户端时会自动安装该环境。
• PowerShell 7：Windows 11 操作系统自带的 PowerShell 版本太低，需要装更新的。

连接远程服务器

专门的本地终端工具中虽然可以通过命令连接到远程服务器，但是如果需要频繁连接远程服务器或者有多个服务器需要连接的话，使用下面的工具会更方便。

• Termius

免密登录远程服务器

先执行下面的命令，终端里让输入保存路径和设置密钥密码（不是远程服务器密码）时直接回车即可：

ssh-keygen

然后在终端中通过下面的命令登录远程服务器（将端口号、用户名、IP 地址替换为实际值），提示输入密码时输入正确的远程服务器 SSH 登录密码即可：

ssh -p 2222 root@110.22.33.44

登录服务器后执行如下命令：

vi ~/.ssh/authorized_keys

这时我们会进入 vi(m) 编辑器界面，将本地生成的公钥内容复制到该文件中。然后输入 :wq 保存并退出。

重启本地终端，然后执行：

ssh -p 2222 root@110.22.33.44

如果这时没有要求我们输入密码，则说明我们已经实现了免密登录远程服务器。

编程语言运行环境

安装编程语言的对应运行环境时，如无特定版本要求，建议安装 LTS 版本。

什么是 LTS 版本

LTS 是 Long Term Support 的缩写，即长期支持的版本，会比普通版本拥有更长的维护时间，长期来看生态也会相对更完善。

Node.js

安装/多版本管理

如果你只需要一个 Node.js 版本，直接到 Node.js 官网下载安装。

不过通常来说，你可能会有多想项目分别要使用不同的 Node.js 版本。这种情况，建议安装 nvm 来安装和管理多个 Node.js 版本。

• 大部分 Linux 系统：NVM
• Windows 系统：NVM for Windows

NVM for Windows 配置文件（settings.txt）内容示例（含镜像源配置）

root: C:\Users\Corey\AppData\Roaming\nvm
path: C:\Program Files\nodejs
proxy: none
# 配置 node 国内镜像：
node_mirror: https://npmmirror.com/mirrors/node/
# 配置 npm 国内镜像：
npm_mirror: https://npmmirror.com/mirrors/npm/

包管理器和镜像源

安装 Node.js 后，会默认自带 npm 包管理器。如果你的电脑存储空间比较紧张，或者你需要使用 workspace 特性来搭建 monorepo 项目，可以执行下面的命令来全局安装 pnpm 包管理器。

npm install -g pnpm

镜像源配置

• 官方镜像（默认）：https://registry.npmjs.org
• 国内阿里镜像：https://registry.npmmirror.com

查看/切换镜像源

• 查看当前镜像源：npm config get registry
• 切换镜像源：npm config set registry <镜像源>

注意，发布 npm 包需要配置镜像源为官方镜像源，国内镜像源只是对官方镜像的定期快照同步，不支持 npm publish 发布包。

Python

安装/多版本管理

到 Python 官网下载安装。需要哪些版本就下载哪些版本进行安装即可。第一次安装时，将添加到 Path 环境变量的选项勾选起来，后续安装其他版本时则不要勾选该选项（所有版本都安装到同一个父目录下，方便后续切换默认版本）。

这样系统 Path 环境变量里会新增 2 个目录，类似这样：

• C:\Program Files\Python313\
• C:\Program Files\Python313\Scripts\

这样后续想要切换默认版本为 Python 3.13 的话，只需要下载安装 Python 3.14，然后将 Path 环境变量中上面这两个路径里的 Python314 替换为 Python314 即可。

如果只是需要临时切换版本，可以使用 py 命令。注意，py 并不是 python 命令的别名，两者是不同的程序。你可以将 py 视为和 Node.js 生态里的 nvm 一样版本管理器。

py 的常用命令

列出本机全部 Python 版本（- 后面的是数字 0，不是字母 o）：

py -0

指定精确版本启动：

py -3.13

指定模糊版本启动：

py -3

安装依赖：

py -3.13 -m pip install xxx -i https://mirrors.aliyun.com/pypi/simple/

包管理器和镜像源

PyPI 包国内常用镜像地址：

• 阿里（推荐，稳定）：https://mirrors.aliyun.com/pypi/simple/
• 清华大学：https://pypi.tuna.tsinghua.edu.cn/simple/
• 中科大：https://pypi.mirrors.ustc.edu.cn/simple/

pip 介绍

pip 是 Python 官方自带，随 Python 一起安装，使用 Python 语言编写。用于安装 / 卸载 / 管理 PyPI 包。锁文件为 requirements.txt（无法锁定间接依赖）。

临时切换镜像：

# 示例：使用清华源安装包
pip install xxx -i https://mirrors.aliyun.com/pypi/simple/
# py 多版本场景务必这样写（推荐）
py -3.13 -m pip install xxx -i https://mirrors.aliyun.com/pypi/simple/

永久切换镜像：

# 阿里源版本
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

# 给python3.13配置镜像
py -3.13 -m pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
# 给python3.11配置镜像
py -3.11 -m pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

其他镜像相关命令：

# 查看当前镜像配置
pip config list

# 恢复官方源
pip config unset global.index-url

uv 介绍

uv 是独立二进制程序，Rust 编写，不依赖 Python 解释器运行，是一站式工具，整合：pip + venv + pip-tools + pyenv 能力。

uv 支持兼容模式（新项目不建议使用），可以使用和 pip 类似的命令，只需要在前面添加 uv 即可。兼容模式下，命令语法和 pip 几乎完全一致，直接替换原有 pip 命令，读写同一个 site-packages，和 pip 安装的包互通。命令示例如下：

pip install requests
uv pip install requests    # 等价替换

uv 的原生项目模式，适合现代项目管理，使用 pyproject.toml + uv.lock。

Rust

安装

到 Rust 官网下载安装。

由于目前只是会用到，但是用的不多，也没有写过以该语言为主的项目，所以不展开描述了。

Go

安装

到 Go 官网下载安装。

由于目前只是会用到，但是用的不多，也没有写过以该语言为主的项目，所以不展开描述了。

Java/Android

我主要是需要开发 Android 项目，所以 Android Studio 基本上是必装的，因此可以复用 Android Studio 安装目录里的 Java 环境。

找到 Android Studio 安装目录下的 jbr 目录路径，例如 C:\workspace\programs\Android Studio\jbr。然后在电脑环境变量里设置 JAVA_HOME 变量，值填我们刚才找到的 C:\workspace\programs\Android Studio\jbr 路径即可。

然后再在 Path 环境变量里添加 %JAVA_HOME%\bin。

最后设置 ANDROID_HOME 变量，值一般类似 C:\Users\<user-name>\AppData\Local\Android\Sdk。

数据库工具

• DataGrip: 数据库开发推荐。
• MySQL：如果有远程测试数据库，并且没有本地使用 mysqldump 来导出数据库的需求的话，可以不装。

配置环境变量

常用命令

请求代理

以端口号 7890 为例，Bash 对应的代理命令如下：

export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890 all_proxy=socks5://127.0.0.1:7890

PowerShell 和 CMD 对应的代理命令

PowerShell：

$env:HTTP_PROXY="http://127.0.0.1:7890"; $env:HTTPS_PROXY="http://127.0.0.1:7890"

CMD：

set http_proxy=http://127.0.0.1:7890
set https_proxy=http://127.0.0.1:7890

常见快捷键推荐

以 Windows 11 操作系统为例：

• Alt + Tab：切换窗口
• Win + R：打开运行对话框
• Alt + A：截图（非系统默认快捷键，打开微信后才有用）

AI 词元套餐

针对 AI 编程场景、龙虾场景，国内有众多 Coding Plan、Token Plan 套餐可供选择，各位可以按需购买。详见 AI 词元套餐。

服务器正式环境

判断 Linux 操作系统

Linux 是一套开源、多用户、多任务、支持多线程与多 CPU的类 Unix 操作系统内核。

Linux 内核和发行版

Linux Kernel（内核）：操作系统核心，负责调度硬件、内存、进程、IO；

Linux 发行版（Distribution）：内核 + 桌面 / 服务软件 + 包管理工具组成完整操作系统。

我们平时服务器使用的 Ubuntu Server、CentOS、Debian、Rocky Linux 都属于发行版，不是单纯内核。

要正确使用 Linux 发行版，需要先确认我们使用的操作系统具体是哪个发行版，以及具体的版本号。

对绝大多数现在绝大多数现代 Linux 发行版，都可以通过 cat /etc/os-release 来确认发行版和版本号。

执行 cat /etc/os-release 后得到的输出

PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"
NAME="Debian GNU/Linux"
VERSION_ID="12"
VERSION="12 (bookworm)"
VERSION_CODENAME=bookworm
ID=debian
HOME_URL="https://www.debian.org/"
SUPPORT_URL="https://www.debian.org/support"
BUG_REPORT_URL="https://bugs.debian.org/"

Debian 12 系统介绍

• 包管理器：apt
• 默认系统服务管理器：systemd
• 支持架构：amd64、arm64 等，非常适合虚拟机、WSL、容器开发环境
• 软件源特点：稳定保守，追求可靠性；软件版本不如 Ubuntu 新

常用命令

# 更新软件源
apt update
# 升级已安装软件
apt upgrade

# 安装软件
apt install xxx

# 查看系统服务
systemctl list-units

编程语言运行环境

这里其实和 Windows 操作系统下的安装流程是一样的，区别主要是不通过 .exe/.msi 这种安装包来安装，而是通过在终端里执行安装命令来安装。配置镜像等操作也是大同小异。这里不再赘述了。