python安装火山引擎教程&windows启用长路径支持（24.12.16更新）

安装方法

直接使用pip安装
（1）安装sdk

pip install volcengine-python-sdk -i https://pypi.org/simple
（2）安装引擎
pip install volcengine

报错参考:

(1)安装sdk报错：

(project_name) PS E:\2image> pip install volcengine-python-sdk -i https://pypi.org/simple
Collecting volcengine-python-sdk
Downloading volcengine-python-sdk-1.0.114.tar.gz (2.9 MB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.9/2.9 MB 900.9 kB/s eta 0:00:00
ERROR: Could not install packages due to an OSError: [Errno 2] No such file or directory: ‘C:\Users\Administrator\AppData\Local\Temp\pip-install-mlsugnhd\volcengine-python-sdk_4aXXX\volcenginesdktransitrouter\models\transit_router_traffic_qos_marking_policy_for_describe_transit_router_traffic_qos_marking_policies_output.py’

错误原因：

这个错误出现在尝试安装 volcengine-python-sdk 时，系统无法在临时目录中创建一个非常长的文件名：
transit_router_traffic_qos_marking_policy_for_describe_transit_router_traffic_qos_marking_policies_output.py
解决方案:
在 Windows中启用长路径支持，请按以下步骤操作：
(1)打开 PowerShell（管理员模式）：
(2)点击开始菜单
(3)搜索 “PowerShell”
(4)右键点击 “Windows PowerShell” 或 “终端”
(5)选择 “以管理员身份运行”

(6)复制并粘贴以下命令：
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1

(7)按回车执行命令
(8 )重启电脑使更改生效
(*9)如果想要验证是否设置成功，重启后可以：

打开注册表编辑器（按 Win + R，输入 regedit）
导航到：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
查看 LongPathsEnabled 的值是否为 1

完成这些步骤后，系统就应该能够支持更长的文件路径了。

重新尝试安装，这一次就没问题了：

(xhs_data_analysis) PS E:\text2image> pip install volcengine-python-sdk -i https://pypi.org/simple
Collecting volcengine-python-sdk
Using cached volcengine-python-sdk-1.0.114.tar.gz (2.9 MB)
Preparing metadata (setup.py) … done
Requirement already satisfied: certifi>=2017.4.17 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from volcengine-python-sdk) (2024.7.4)
Collecting python-dateutil>=2.1 (from volcengine-python-sdk)
Downloading python_dateutil-2.9.0.post0-py2.py3-none-any.whl.metadata (8.4 kB)
Requirement already satisfied: six>=1.10 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from volcengine-python-sdk) (1.16.0)
Requirement already satisfied: urllib3>=1.23 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from volcengine-python-sdk) (2.2.2)
Downloading python_dateutil-2.9.0.post0-py2.py3-none-any.whl (229 kB)
Building wheels for collected packages: volcengine-python-sdk
Building wheel for volcengine-python-sdk (setup.py) … done
Created wheel for volcengine-python-sdk: filename=volcengine_python_sdk-1.0.114-py3-none-any.whl size=9939759 sha256=71fa64512a49b05385aef55f903a9928351d08521955b838b0270938a3b1b9df
Stored in directory: c:\users\administrator\appdata\local\pip\cache\wheels\bb\f6\21\dc21a6825c75e434bbbba59ebf39322235875dca1a74dbb047
Successfully built volcengine-python-sdk
Installing collected packages: python-dateutil, volcengine-python-sdk
Successfully installed python-dateutil-2.9.0.post0 volcengine-python-sdk-1.0.114

（2）安装volcengine报错

pip install volcengine
Looking in indexes: https://mirrors.aliyun.com/pypi/simple/
Collecting volcengine
Using cached https://mirrors.aliyun.com/pypi/packages/31/26/ac6f1a7d6d82bebf2d0e9fe35d21d0085120224df1b153dfdd26a0cce194/volcengine-1.0.164.tar.gz (337 kB)
Preparing metadata (setup.py) … done
Requirement already satisfied: requests>=2.25.1 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from volcengine) (2.32.3)
Collecting retry0.9.2 (from volcengine)
Using cached https://mirrors.aliyun.com/pypi/packages/4b/0d/53aea75710af4528a25ed6837d71d117602b01946b307a3912cb3cfcbcba/retry-0.9.2-py2.py3-none-any.whl (8.0 kB)
Collecting pytz2020.5 (from volcengine)
Using cached https://mirrors.aliyun.com/pypi/packages/89/06/2c2d3034b4d6bf22f2a4ae546d16925898658a33b4400cfb7e2c1e2871a3/pytz-2020.5-py2.py3-none-any.whl (510 kB)
Collecting pycryptodome==3.9.9 (from volcengine)
Using cached https://mirrors.aliyun.com/pypi/packages/c4/3a/5bca2cb1648b171afd6b7d29a11c6bca8b305bb75b7e2d78a0f5c61ff95e/pycryptodome-3.9.9.tar.gz (15.5 MB)
Preparing metadata (setup.py) … error
error: subprocess-exited-with-error
× python setup.py egg_info did not run successfully.
│ exit code: 1
╰─> [21 lines of output]
Traceback (most recent call last):
File “”, line 2, in
File “”, line 34, in
File “C:\Users\Administrator\AppData\Local\Temp\pip-install-ukqwb4nm\pycryptodome_a7a74febded34710915e3721837a51d1\setup.py”, line 457, in
set_compiler_options(package_root, ext_modules)
File “C:\Users\Administrator\AppData\Local\Temp\pip-install-ukqwb4nm\pycryptodome_a7a74febded34710915e3721837a51d1\compiler_opt.py”, line 341, in set_compiler_options
clang = compiler_is_clang()
File “C:\Users\Administrator\AppData\Local\Temp\pip-install-ukqwb4nm\pycryptodome_a7a74febded34710915e3721837a51d1\compiler_opt.py”, line 251, in compiler_is_clang
return test_compilation(source, msg=“clang”)
File “C:\Users\Administrator\AppData\Local\Temp\pip-install-ukqwb4nm\pycryptodome_a7a74febded34710915e3721837a51d1\compiler_opt.py”, line 82, in test_compilation
objects = compiler.compile([fname], extra_postargs=extra_cc_options)
File “D:\annaconda\envs\xhs_data_analysis\lib\site-packages\setuptools_distutils_msvccompiler.py”, line 343, in compile
self.initialize()
File “D:\annaconda\envs\xhs_data_analysis\lib\site-packages\setuptools_distutils_msvccompiler.py”, line 253, in initialize
vc_env = _get_vc_env(plat_spec)
File “D:\annaconda\envs\xhs_data_analysis\lib\site-packages\setuptools\msvc.py”, line 233, in msvc14_get_vc_env
return _msvc14_get_vc_env(plat_spec)
File “D:\annaconda\envs\xhs_data_analysis\lib\site-packages\setuptools\msvc.py”, line 190, in _msvc14_get_vc_env
raise distutils.errors.DistutilsPlatformError(“Unable to find vcvarsall.bat”)
distutils.errors.DistutilsPlatformError: Microsoft Visual C++ 14.0 or greater is required. Get it with “Microsoft C++ Build Tools”: https://visualstudio.microsoft.com/visual-cpp-build-tools/
Testing support for clang
[end of output]
note: This error originates from a subprocess, and is likely not a problem with pip.
error: metadata-generation-failed
× Encountered error while generating package metadata.
╰─> See above for output.

报错原因：

从安装 volcengine 库时的报错信息来看，问题出在安装依赖库 pycryptodome==3.9.9 的过程中。
在准备 pycryptodome 的元数据（通过运行 python setup.py egg_info ）时出错了，具体错误提示表明：
需要 Microsoft Visual C++ 14.0 或更高版本才能继续安装 pycryptodome 库。它建议你通过 “Microsoft C++ Build Tools” 来获取相应的工具，链接为 https://visualstudio.microsoft.com/visual-cpp-build-tools/ 。

解决办法如下：

(1)访问官方网站
打开浏览器，访问https://visualstudio.microsoft.com/visual - cpp - build - tools/。
(2)下载安装程序
在该网页上，你会看到 “下载” 按钮或者选项，点击它来下载 Visual C++ Build Tools 的安装程序。
在这里插入图片描述

(3)运行安装程序
(4)下载完成后，找到安装程序文件并双击运行它。
(5)在安装过程中，你可能会看到一个安装向导，它会引导你完成安装步骤。确保勾选了 “使用 C++ 的桌面开发” 相关的工作负载选项。
(6)验证安装
安装完成后，重新打开命令提示符或者 PowerShell，再次输入where cl.exe（这里我的方法是直接在vs installer里面点击点击启动，进入开发者命令行模式），此时应该能够看到cl.exe文件所在的路径，这就表示安装成功了。
![验证安装step1(https://i-blog.csdnimg.cn/direct/912e00a1312d4fdb99653b72fe85ff68.png)


重新尝试安装一次，就可以正常安装了：

pip install volcengine
Looking in indexes: https://mirrors.aliyun.com/pypi/simple/
Collecting volcengine
Using cached https://mirrors.aliyun.com/pypi/packages/31/26/ac6f1a7d6d82bebf2d0e9fe35d21d0085120224df1b153dfdd26a0cce194/volcengine-1.0.164.tar.gz (337 kB)
Preparing metadata (setup.py) … done
Requirement already satisfied: requests>=2.25.1 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from volcengine) (2.32.3)
Collecting retry0.9.2 (from volcengine)
Downloading https://mirrors.aliyun.com/pypi/packages/4b/0d/53aea75710af4528a25ed6837d71d117602b01946b307a3912cb3cfcbcba/retry-0.9.2-py2.py3-none-any.whl (8.0 kB)
Collecting pytz2020.5 (from volcengine)
Downloading https://mirrors.aliyun.com/pypi/packages/89/06/2c2d3034b4d6bf22f2a4ae546d16925898658a33b4400cfb7e2c1e2871a3/pytz-2020.5-py2.py3-none-any.whl (510 kB)
Collecting pycryptodome3.9.9 (from volcengine)
Using cached https://mirrors.aliyun.com/pypi/packages/c4/3a/5bca2cb1648b171afd6b7d29a11c6bca8b305bb75b7e2d78a0f5c61ff95e/pycryptodome-3.9.9.tar.gz (15.5 MB)
Preparing metadata (setup.py) … done
Collecting protobuf>=3.18.3 (from volcengine)
Downloading https://mirrors.aliyun.com/pypi/packages/e3/33/dc7a7712f457456b7e0b16420ab8ba1cc8686751d3f28392eb43d0029ab9/protobuf-5.29.1-cp310-abi3-win_amd64.whl (434 kB)
Collecting google>=3.0.0 (from volcengine)
Downloading https://mirrors.aliyun.com/pypi/packages/ac/35/17c9141c4ae21e9a29a43acdfd848e3e468a810517f862cad07977bf8fe9/google-3.0.0-py2.py3-none-any.whl (45 kB)
Requirement already satisfied: six>=1.0 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from volcengine) (1.16.0)
Collecting decorator>=3.4.2 (from retry0.9.2->volcengine)
Downloading https://mirrors.aliyun.com/pypi/packages/d5/50/83c593b07763e1161326b3b8c6686f0f4b0f24d5526546bee538c89837d6/decorator-5.1.1-py3-none-any.whl (9.1 kB)
Collecting py<2.0.0,>=1.4.26 (from retry==0.9.2->volcengine)
Downloading https://mirrors.aliyun.com/pypi/packages/f6/f0/10642828a8dfb741e5f3fbaac830550a518a775c7fff6f04a007259b0548/py-1.11.0-py2.py3-none-any.whl (98 kB)
Requirement already satisfied: beautifulsoup4 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from google>=3.0.0->volcengine) (4.12.3)
Requirement already satisfied: charset-normalizer<4,>=2 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from requests>=2.25.1->volcengine) (3.3.2)
Requirement already satisfied: idna<4,>=2.5 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from requests>=2.25.1->volcengine) (3.7)
Requirement already satisfied: urllib3<3,>=1.21.1 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from requests>=2.25.1->volcengine) (2.2.2)
Requirement already satisfied: certifi>=2017.4.17 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from requests>=2.25.1->volcengine) (2024.7.4)
Requirement already satisfied: soupsieve>1.2 in d:\annaconda\envs\xhs_data_analysis\lib\site-packages (from beautifulsoup4->google>=3.0.0->volcengine) (2.6)
Building wheels for collected packages: volcengine, pycryptodome
Building wheel for volcengine (setup.py) … done
Created wheel for volcengine: filename=volcengine-1.0.164-py3-none-any.whl size=687262 sha256=f88bdde89e8338d9099f08b060e087d3ac817b1e227be37a664d5c0d262081b3
Stored in directory: c:\users\administrator\appdata\local\pip\cache\wheels\09\63\3c\99033008d7befcc0b8848752c06ca4d1c3ec18501fb5516d9f
Building wheel for pycryptodome (setup.py) … done
Created wheel for pycryptodome: filename=pycryptodome-3.9.9-cp310-cp310-win_amd64.whl size=13470624 sha256=d721a090912d2f023c3ce92ea7a897a6aad9045f7e954a2006da14152822aea7
Stored in directory: c:\users\administrator\appdata\local\pip\cache\wheels\44\6e\82\934f3f4058f99923e958737510617a472e6eef9e7da1360158
Successfully built volcengine pycryptodome
Installing collected packages: pytz, pycryptodome, py, protobuf, decorator, retry, google, volcengine
Attempting uninstall: pycryptodome
Found existing installation: pycryptodome 3.20.0
Uninstalling pycryptodome-3.20.0:
Successfully uninstalled pycryptodome-3.20.0
Successfully installed decorator-5.1.1 google-3.0.0 protobuf-5.29.1 py-1.11.0 pycryptodome-3.9.9 pytz-2020.5 retry-0.9.2 volcengine-1.0.164

如果大家在安装的时候遇到了什么问题，欢迎留言给我。
📧Email：cecaibabe@outlook.com