暗黑模式
包管理
设置镜像源
Python
在 Python 中使用镜像源来加速下载包，通常是通过配置 pip 使用国内的镜像源。这样可以大大提高包的下载速度，特别是在中国大陆，由于网络问题，默认的 PyPI 镜像可能会比较慢。
以下是几种常见的设置镜像源的方式：
临时使用镜像源
在安装某个 Python 包时，可以通过 -i 参数临时指定镜像源。例如：
bash
pip install <package_name> -i https://pypi.tuna.tsinghua.edu.cn/simple1
这条命令会使用 清华大学 的 PyPI 镜像源来加速包的下载。
永久设置镜像源
如果你希望每次使用 pip 安装包时都使用指定的镜像源，可以通过修改配置文件来永久设置镜像源。
方法一：修改 pip 配置文件
Windows 系统： 配置文件的路径通常是
C:\Users\<your_username>\pip\pip.ini。如果没有这个文件，可以手动创建。Linux/macOS 系统： 配置文件的路径通常是
~/.config/pip/pip.conf，如果没有这个文件，可以手动创建。
在配置文件中添加以下内容来设置镜像源：
ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple1
2
2
你也可以根据需要选择不同的镜像源，以下是一些常用的镜像源：
常用镜像源
- 清华大学：
https://pypi.tuna.tsinghua.edu.cn/simple - 阿里云：
https://mirrors.aliyun.com/pypi/simple/ - 豆瓣：
https://pypi.doubanio.com/simple/ - 中科大：
https://pypi.mirrors.ustc.edu.cn/simple/ - 华为云：
https://mirrors.huaweicloud.com/repository/pypi/simple
方法二：使用环境变量配置镜像
你也可以通过环境变量来设置镜像源，这种方式不需要修改配置文件。你只需要在终端中设置环境变量即可：
Linux/macOS：
bashexport PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple1Windows：
cmdset PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple # for current session setx -m PIP_INDEX_URL https://pypi.tuna.tsinghua.edu.cn/simple # for machine1
2Dockerfile
textRUN pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple1
这样，环境变量会在当前会话中生效。
使用 pip 加速工具
除了更改镜像源，还可以使用一些专门的工具来加速 Python 包的下载。比如：
pipenv：这是一个用于管理 Python 虚拟环境和依赖的工具，自动为你优化包的安装过程。conda：如果你使用 Anaconda 或 Miniconda，conda也支持设置镜像源，以加速包的下载。
安装 pip 加速工具（pip 多线程下载）
pip20.3+ 版本开始支持多线程下载，可以通过加速包的下载。
升级 pip：
bash
pip install --upgrade pip1
然后安装时，使用 -v 参数来查看详细输出，验证加速效果。
完整示例：使用清华镜像安装包
以下是一个完整的示例，演示如何使用清华大学的 PyPI 镜像来加速安装包：
bash
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple1
如果希望永久使用清华镜像源，则可以修改配置文件或设置环境变量，如前面所述。
总结
使用国内的镜像源（如清华、阿里云等）来加速 Python 包的下载是一个非常有效的方式，尤其是在国内网络环境下。你可以选择临时设置镜像源，也可以通过修改配置文件或环境变量来实现永久设置。
项目管理工具
Python: ruff + uv
常见包管理工具
- npm，Nodejs 官方自带的默认的包管理工具
- yarn， Facebook 出品的包管理工具，旨在解决
npm安装速度缓慢等问题 - pnpm， 通过软链接方式解决依赖占用磁盘等问题
- bun，
bun是一站式JS/TS的工具包，其中自带了包管理工具，旨在以更快的速度替代npmyarnpnpm - poetry，for python
初始化项目
安装项目所有依赖包
bash
npm install
npm install --production # npm will not install modules listed in devDependencies.
npm install --production=false # Install all modules listed in both dependencies and devDependencies when NODE_ENV environment variable is set to production.
npm config set registry https://registry.npmmirror.com1
2
3
4
2
3
4
bash
# First
corepack enable
corepack use pnpm@latest # Wll add `packageManager: pnpm@x.x.x` to package.json
pnpm -v
pnpm install
# Other machine
corepack enable
pnpm -v
pnpm install
# Registry
pnpm config set registry https://registry.npmmirror.com
# Node version manager
pnpm env use --global lts
pnpm env use --global 221
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
bash
yarn
yarn install
yarn install --production
yarn install --prod
yarn install --production=false
yarn install --prod=false
yarn config set registry https://registry.npmmirror.com1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
bash
# nodejs 18+
corepack enable # only once
yarn set version berry # will add `packageManager: yarn@4.x.x` to package.json; generate .yarn folder, .yarnrc.yml
yarn -v # output: 4.x.x
yarn
yarn install
yarn config set npmRegistryServer https://registry.npmmirror.com # optional
# .gitignore: add this line to ignore .yarn folder
.yarn
# other machine
corepack enable
corepack install # will download package manager according to `packageManager` in package.json1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
bash
bun install [--production]1
安装指定依赖包
bash
npm install <pkg-name>
npm install --global <pkg-name>
npm install -g <pkg-name>
# aliases: add, i, in, ins, inst, insta, instal, isnt, isnta, isntal, isntall
# -P, --save-prod: Package will appear in your dependencies. This is the default unless -D or -O are present.
# -D, --save-dev: Package will appear in your devDependencies.
# -O, --save-optional: Package will appear in your optionalDependencies.
# --no-save: Prevents saving to dependencies.1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
bash
yarn add <pkg-name>
yarn global add <pkg-name>
# This will install one or more packages in your dependencies.
# Using --dev or -D will install one or more packages in your devDependencies.
# Using --peer or -P will install one or more packages in your peerDependencies.
# Using --optional or -O will install one or more packages in your optionalDependencies.1
2
3
4
5
6
7
2
3
4
5
6
7
bash
bun add
bun add [--dev,development | -d,D] # devDependencies
bun add --optional # optionalDependencies
bun add [--exact | -E]
bun add [--global | -g]
bun add --help1
2
3
4
5
6
2
3
4
5
6
列出已安装的包
bash
npm ls # 列出当前项目已经安装的依赖包
npm list # 同上，list 是 ls 的别名
npm ls --global # 列出全局安装的包
/home/ronnie/.nvm/versions/node/v20.12.0/lib
├── corepack@0.25.2
└── npm@10.5.01
2
3
4
5
6
7
2
3
4
5
6
7
bash
yarn list # 列出当前项目已经安装的依赖包
yarn global list # 列出全局安装的包
yarn global v1.22.19
info "nodemon@3.1.0" has binaries:
- nodemon
Done in 0.11s.1
2
3
4
5
6
7
2
3
4
5
6
7
bash
bun pm ls [--all]1
问题排查
ERR_PNPM_FETCH_404
原因之一：设置了代理镜像，代理镜像没有及时同步 npm 源。
解决方法：
- 浏览器中：https://npmmirror.com/sync/{some-package}
- 在页面中找到【进行同步】按钮并点击，等待片刻，然后
pnpm install
CDN
以下是整理的国内快速 JS 代码托管平台的表格：
| 平台名称 | 特点 | 优势 | 官网链接 |
|---|---|---|---|
| BootCDN | 专注于前端开源库的快速 CDN 服务，提供常用库托管 | 国内访问速度快，支持版本切换 | BootCDN |
| Staticfile CDN | 由七牛云提供支持，托管前端开源库 | 国内节点稳定，支持 HTTPS | Staticfile CDN |
| JsDelivr | 国际知名开源 CDN，国内有 Cloudflare 镜像 | 自动选择最快节点，大量开源库托管 | JsDelivr |
| UNPKG | 专注于 NPM 包的 CDN，支持通过包名加载文件 | 支持按需加载，国内镜像速度快 | UNPKG |
| 腾讯云 CDN | 提供静态文件托管和全站加速服务 | 国内节点密集，延迟低，安全性高 | 腾讯云 CDN |
| 阿里云 OSS + CDN | 自行上传文件到阿里云对象存储，通过 CDN 分发 | 灵活性高，适合项目定制化需求 | 阿里云 CDN |
| 百度云加速 | 提供静态资源分发服务，支持自定义托管 | 国内访问速度快，配置简单 | 百度云加速 |
TIP
- 快速集成开源库： BootCDN 或 Staticfile CDN。
- 定制化托管需求： 腾讯云 CDN 或阿里云 OSS + CDN。
- 按需加载 NPM 包： UNPKG 或 JsDelivr。
poetry
bash
sudo apt install pipx
pipx install poetry
poetry source add aliyun https://mirrors.aliyun.com/pypi/simple/
poetry config repositories.default aliyun
pyenv install 3.9.7
pyenv local 3.9.7
pyenv version
poetry env use $(pyenv which python) # VS Code Python: Select Interpreter
poetry run python --version1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
toml
# pyproject.toml
[tool.poetry.source]
name = "tsinghua"
url = "https://pypi.tuna.tsinghua.edu.cn/simple/"
default = true1
2
3
4
5
2
3
4
5
DANGER
HTTPSConnectionPool(host='mirrors.aliyun.com', port=443): Max retries exceeded with url
可能原因：VPN 引起的 方法：关闭 VPN
Windows choco
choco install python --version 3.8.3: error → Windows 程序管理：卸载 python 相关