PicList-Core 安装与快速开始

PicList-Core 是独立上传引擎，可通过命令行、终端界面、HTTP 服务或 Node.js API 使用。npm 包叫 piclist，安装后的命令叫 picgo 和 picgo-server。

已经使用桌面版时，不需要为了正常拖拽上传再安装 Core。需要服务器、命令行批处理或程序集成时再使用本页。

1. 检查 Node.js 并安装

Core 3.0.0 要求 Node.js 22.x 且至少 22.13.0；package.json 的 engine 范围是 ^22.13.0。先检查版本，再安装：

bash

node --version
npm install -g [email protected]
picgo --version

最后一个命令应显示 3.0.0。找不到 picgo 时，重新打开终端并确认 npm 的全局可执行目录在 PATH 中。

在有交互输入的终端运行：

bash

picgo init

选择 Local、本地保存目录与配置名，按提示保存。先创建可写目录，例如 D:\Pictures\PicList 或 /home/YOU/Pictures/piclist，填写绝对路径。这是存储路径，不是图片公网地址。

另一种方式是保存最小 JSON 配置，避免依赖交互提示。创建名为 practice.json 的文件：

WindowsmacOS / Linux

json

{
  "picBed": {
    "uploader": "local",
    "current": "local",
    "local": {
      "path": "D:/Pictures/PicList"
    }
  }
}

json

{
  "picBed": {
    "uploader": "local",
    "current": "local",
    "local": {
      "path": "/home/YOU/Pictures/piclist"
    }
  }
}

两个文件内容示例二选一；修改 path 为自己的现存目录。macOS 也使用实际绝对目录，不直接照抄 /home/YOU。

在配置文件所在目录，用自己的图片路径运行：

bash

picgo -c ./practice.json upload "./photo.png"

检查终端结果与目标目录中的 photo.png。Local 未设置 customUrl 时返回本地路径；想获得公开文章链接，需要配置在线图床或自己的文件网站，见选择图床。

使用 init 保存的默认配置时，可省略 -c：

bash

picgo upload ./image.png
picgo upload "./My Pictures/photo.jpg" ./another.png
picgo upload https://example.com/image.png

带空格的路径要加引号。URL 示例需替换为可直接下载的图片地址。省略输入参数可上传剪贴板图片；无桌面服务器通常没有图片剪贴板，应使用文件或 multipart HTTP 上传。

默认读取 ~/.piclist/data.json；只有 data.json 不存在时才读取旧 config.json，不会合并两者。-c 明确指定配置文件：

bash

picgo -c /absolute/path/data.json upload ./image.png

桌面与 Core 的图床结构兼容，但默认数据目录不同。迁移时检查本机路径、字体、插件、处理设置；不要以为两者会自动读取同一个文件。配置含凭据时保持私有。

使用 Node API 时，3.0 通过 await PicGo.create() 初始化。HTTP、CLI 与 API 的目的地图床参数拼写不同，具体示例见各自页面。

版本与源码见 PicList-Core 和 npm。