Git dựa vào một số phụ thuộc trong các công cụ dòng lệnh Xcode của Apple để hoạt động bình thường. Nếu bạn chưa cài đặt Công cụ Xcode, bạn sẽ nhận được lỗi xcrun:error:đường dẫn nhà phát triển hoạt động không hợp lệ (/ Library / Developer / CommandLineTools) bất cứ khi nào bạn cố gắng chạy lệnh Git.
Hướng dẫn này giải thích lỗi này là gì và tại sao bạn có thể thấy lỗi này. Chúng tôi sẽ hướng dẫn bạn qua một tình huống ví dụ để bạn có thể tìm ra cách khắc phục sự cố này.
Git là gì?
Git là hệ thống điều khiển phiên bản phổ biến nhất. Git theo dõi những thay đổi bạn thực hiện đối với tệp, vì vậy bạn có một bản ghi về những gì đã được thực hiện và có thể hoàn nguyên về các phiên bản cụ thể nếu cần. Git cũng tạo điều kiện cộng tác bằng cách cho phép hợp nhất các thay đổi của nhiều người thành một nguồn duy nhất.
Vì vậy, cho dù bạn viết mã mà chỉ bạn mới thấy hay làm việc trong nhóm, Git vẫn hữu ích cho bạn.
Mẹo chuyên nghiệp:Quét máy Mac của bạn để tìm các vấn đề về hiệu suất, tệp rác, ứng dụng có hại và các mối đe dọa bảo mật
có thể gây ra sự cố hệ thống hoặc hiệu suất chậm.
Git là một phần mềm chạy trên máy tính của bạn. Các tệp của bạn, cũng như lịch sử của chúng, được lưu trên máy tính của bạn. Bạn cũng có thể lưu trữ bản sao của các tệp và lịch sử sửa đổi của chúng trên các máy chủ trực tuyến (chẳng hạn như GitHub hoặc Bitbucket). Có một vị trí trung tâm nơi bạn có thể tải lên các thay đổi của mình và tải xuống các thay đổi từ những người khác cho phép bạn cộng tác với các nhà phát triển khác dễ dàng hơn. Git có thể tự động hợp nhất các thay đổi, cho phép hai người làm việc trên các phần khác nhau của cùng một tệp và sau đó hợp nhất các thay đổi đó mà không làm mất công việc của nhau!
Git là phần mềm có thể được truy cập thông qua dòng lệnh (thiết bị đầu cuối) hoặc ứng dụng dành cho máy tính để bàn có giao diện người dùng đồ họa (GUI), chẳng hạn như Sourcetree.
Công cụ XCode là gì?
Xcode là môi trường phát triển và gỡ lỗi của Mac và nó cung cấp các tệp phát triển cần thiết cho các ứng dụng Mac OS X và iOS.
Trước khi họ có thể phát triển phần mềm trên máy Mac, trước tiên các nhà phát triển phải cài đặt Công cụ dòng lệnh Xcode.
Apple cung cấp một môi trường phát triển đầy đủ cho các lập trình viên được gọi là Xcode. Bạn phải cài đặt ứng dụng Xcode đầy đủ nếu bạn đang phát triển phần mềm cho macOS, iOS, tvOS hoặc watchOS.
Nó không được cài đặt sẵn, nhưng bạn có thể tải nó từ trang web của nhà phát triển Apple hoặc Mac App Store.
Bạn sẽ không cần ứng dụng Xcode đầy đủ nếu không phát triển phần mềm cho thiết bị Apple (phần mềm này chiếm hơn 40GB dung lượng đĩa!).
Thay vào đó, bạn sẽ tải xuống và cài đặt Công cụ dòng lệnh Xcode. Đây là một gói nhỏ hơn dành cho các nhà phát triển phần mềm bao gồm các công cụ dòng lệnh chạy trong ứng dụng Terminal.
Những công cụ này đã được các lập trình viên sử dụng trên hệ điều hành Unix kể từ khi máy tính ra đời và chúng là nền tảng của hầu hết mọi sự phát triển phần mềm.
May mắn thay, gói Công cụ dòng lệnh Xcode chỉ chiếm 1,2 GB dung lượng đĩa.
Để cài đặt Công cụ dòng lệnh Xcode trên máy Mac, bạn có ba tùy chọn:
- cài đặt toàn bộ gói Xcode.
- cài đặt Công cụ dòng lệnh Xcode qua Terminal
- cài đặt Công cụ dòng lệnh Xcode thông qua cài đặt Homebrew
Trừ khi bạn đang phát triển phần mềm cho thiết bị Apple, chúng tôi khuyên bạn không nên cài đặt gói Xcode đầy đủ. Quá trình tải xuống sẽ mất quá nhiều thời gian và chiếm quá nhiều dung lượng đĩa. Thay vào đó, hãy thử một trong hai phương pháp nhanh hơn.
Bởi vì hệ điều hành dựa trên Unix, tiêu chuẩn lâu đời để phát triển phần mềm, macOS là nền tảng phổ biến nhất để phát triển phần mềm.
Bạn sẽ có một nền tảng vững chắc để thêm hầu hết mọi công cụ phát triển nguồn mở nếu bạn cài đặt Công cụ dòng lệnh Xcode.
Git xcrun:error:đường dẫn nhà phát triển hoạt động không hợp lệ là gì Lỗi?
Khi chạy bất kỳ lệnh git nào - chẳng hạn như git pull, git push, git clone, git status, git branch, v.v. — người dùng gặp lỗi trên các phiên bản macOS khác nhau.
Một số người dùng Mac Terminal có thể phát hiện ra rằng việc sử dụng pip, HomeBrew và các công cụ dòng lệnh khác không thành công hoặc không hoạt động bình thường, với thông báo lỗi cho biết “xcrun:error:đường dẫn nhà phát triển hoạt động không hợp lệ (/ Library / Developer / CommandLineTools)”. Các công cụ dòng lệnh này có thể ngừng hoạt động sau khi cập nhật phần mềm hệ thống macOS nếu chúng hoạt động trước đó.
Thông báo lỗi thường có nội dung:
xcrun:error:đường dẫn nhà phát triển hoạt động không hợp lệ (/ Library / Developer / CommandLineTools), thiếu xcrun tại:/ Library / Developer / CommandLineTools / usr / bin / xcrun
Nguyên nhân gây ra Xcrun:error:đường dẫn nhà phát triển hoạt động không hợp lệ (/ library / developer / commandlinetools) ?
Trong hầu hết các trường hợp, lỗi xcrun:error:đường dẫn nhà phát triển hoạt động không hợp lệ đã xuất hiện khi cố gắng chạy lệnh git trong ứng dụng Terminal sau khi cập nhật hoặc nâng cấp. Hầu hết các lỗi xuất hiện liên quan đến máy Mac được cập nhật gần đây lên Big Sur.
Thông báo lỗi ở trên là tự giải thích. Nó nói rằng đường dẫn nhà phát triển đang hoạt động được tìm thấy tại / Library / Developer / CommandLineTools không hợp lệ. Điều này có nghĩa là lỗi không liên quan đến bản thân git mà thay vào đó là Công cụ dòng lệnh.
Điều này xảy ra ngay cả khi Công cụ dòng lệnh được cài đặt trên macOS và hoạt động tốt trước đó. Nếu lỗi xuất hiện sau khi nâng cấp macOS của bạn, việc cài đặt lại “Công cụ dòng lệnh” trên máy Mac của bạn sẽ giải quyết được sự cố với các đường dẫn trong cài đặt “Công cụ dòng lệnh”.
Cách xử lý với Git Xcrun:Lỗi:Đường dẫn dành cho nhà phát triển đang hoạt động không hợp lệ
Điều đầu tiên bạn cần làm khi gặp lỗi này là đóng cửa sổ Terminal và khởi chạy lại nó. Sau khi khởi động lại ứng dụng, hãy thử chạy lại lệnh để kiểm tra xem nó có hoạt động ngay bây giờ không. Nếu lỗi do trục trặc, việc khởi động lại ứng dụng sẽ khắc phục được lỗi đó.
Bạn cũng nên đảm bảo rằng ứng dụng Terminal có đủ quyền để chạy lệnh. Mở cửa sổ Terminal trên cao thay vì một bảng điều khiển thông thường để bạn không gặp phải sự cố truy cập. Nếu các bước này không hữu ích, hãy khởi động lại máy Mac của bạn trước khi thử lại mọi thứ. Nó cũng giúp tối ưu hóa máy tính của bạn trước tiên bằng cách sử dụng Outbyte macAries để loại bỏ các tệp rác và các vấn đề nhỏ khác.
Nếu lỗi liên tục đến mức các bước khắc phục sự cố này không hoạt động, thì hãy làm theo các giải pháp bên dưới.
Để khắc phục sự cố này, hãy cài đặt Xcode. Nếu bạn quan tâm đến phát triển ứng dụng iOS, bạn có thể cài đặt phiên bản đầy đủ và nó cũng sẽ khắc phục sự cố này. Tải xuống tệp Xcode .dmg từ trang web dành cho nhà phát triển của Apple.
Nếu không sử dụng nhiều, bạn có thể tìm gói công cụ dòng lệnh cho Xcode và tải xuống và cài đặt tệp .dmg tương ứng. Bạn có thể tải xuống từ trang web dành cho nhà phát triển của Apple.
Khắc phục # 1:Cài đặt hoặc cài đặt lại công cụ dòng lệnh.
Nếu bạn không muốn tải xuống bất cứ thứ gì và chỉ muốn chạy một vài lệnh trong Terminal để khắc phục sự cố này, đây là giải pháp cho bạn:
- Khởi động Thiết bị đầu cuối của bạn Bạn cũng có thể sử dụng bất kỳ ứng dụng đầu cuối nào khác. Đối với người dùng macOS:Ứng dụng Terminal có thể được tìm thấy trong thư mục Tiện ích của thư mục Ứng dụng của bạn hoặc sử dụng Spotlight để tìm nó.
- Trong Terminal, nhập lệnh sau và nhấn Enter để cài đặt các công cụ dòng lệnh: xcode-select –install
- Đây là lệnh có thể chạy trong terminal và sẽ cài đặt các công cụ dòng lệnh cho Xcode. Bạn sẽ nhận được kết quả sau: xcode-select:lưu ý:cài đặt được yêu cầu cho các công cụ dành cho nhà phát triển dòng lệnh
- Nhấp vào Cài đặt cái nút.
- Chấp nhận Thỏa thuận Cấp phép bằng cách nhấp vào “ Chấp nhận " cái nút.
Hãy để quá trình cài đặt thực hiện công việc của nó, đừng làm gián đoạn nó. Điều này có thể mất một lúc, vì vậy hãy kiên nhẫn. Bây giờ khởi động lại ứng dụng đầu cuối. Tôi không phải khởi động lại thiết bị đầu cuối. Nhưng tôi biết rằng trong một số trường hợp, nó sẽ không hoạt động nếu không khởi động lại.
Cuối cùng, bạn có thể nhập lại lệnh mà bạn đã sử dụng khi nhận được thông báo lỗi để đảm bảo rằng nó chạy không có lỗi. (trong trường hợp của tôi, lệnh là git commit)
Nếu bạn được thông báo rằng quá trình tải xuống yêu cầu hơn 7GB dung lượng, xin lưu ý rằng bạn sẽ buộc phải tải xuống ứng dụng Xcode cụ thể từ trang web dành cho nhà phát triển của Apple.
Lệnh trên sẽ khắc phục sự cố nếu bạn cũng không chạy lệnh sau:
xcode-select –reset
Mặc dù điều này sẽ khắc phục được sự cố của bạn, nhưng bước tiếp theo có thể là đặt đường dẫn để các công cụ dòng lệnh chạy mà không cần Xcode: xcode-select –switch / Library / Developer / CommandLineTools
Nếu bạn đang làm việc với Node.js và một mô-đun yêu cầu loại nút, bạn có thể tìm thấy cảnh báo sau trong thiết bị đầu cuối của mình:
xcode-select:error:tool ‘xcodebuild’ yêu cầu Xcode
nhưng thư mục nhà phát triển đang hoạt động ‘/ Library / Developer / CommandLineTools’ là một phiên bản công cụ dòng lệnh
Lỗi này xảy ra khi thư mục nhà phát triển xcodeselect trỏ đến / Library / Developer / CommandLineTools khi yêu cầu Xcode thông thường đầy đủ (xảy ra khi CommandLineTools được cài đặt sau Xcode). Bạn có thể nhanh chóng khắc phục sự cố này bằng cách cập nhật thư mục nhà phát triển lên Xcode.app: sudo xcode-select -s /Application/Xcode.app/Contents/Developer
Khắc phục # 2:Cài đặt từ Trang tải xuống dành cho nhà phát triển của Apple
Nếu bạn đã cài đặt hoặc cài đặt lại Công cụ dòng lệnh từ Terminal, khởi động lại máy Mac của bạn và lỗi vẫn tiếp diễn, bạn cũng có thể thử cài đặt Công cụ dòng lệnh theo cách thủ công bằng tệp DMG trực tiếp từ Apple.
Bạn cần có ID Apple để truy cập tải xuống, sau đó truy cập developer.apple.com và tải xuống Công cụ dòng lệnh cho Xcode (phiên bản mới nhất) và cài đặt thủ công.
Nếu bạn đang sử dụng Homebrew, bạn cần cập nhật nó. Bạn không nên cài đặt lại Homebrew hoặc gỡ bỏ rồi cài đặt lại, một bản cập nhật đơn giản sẽ hoạt động.
Khắc phục # 3:Buộc thiết bị đầu cuối sử dụng XCode
Nếu bạn đã cài đặt Xcode trên máy Mac, bạn có thể bỏ qua các bước cài đặt ở trên và buộc Thiết bị đầu cuối sử dụng các công cụ Xcode’s CommandLine. Để thực hiện việc này, bạn cần sử dụng các lệnh sau:
- sudo xcode-select –reset
- sudo xcodebuild -license
Nếu bạn có nhiều phiên bản Xcode, bạn có thể chọn phiên bản bạn muốn bằng lệnh này: xcode-select –switch /Application/Xcode.app
Bạn cũng có thể chọn chạy Công cụ dòng lệnh mà không có Xcode: xcode-select –switch / Library / Developer / CommandLineTools
Kết thúc
Sự cố này có thể xảy ra sau khi cập nhật hệ điều hành và làm cho các dịch vụ đang chạy trước đó trở nên vô dụng trong một thời gian dài. Tuy nhiên, giải pháp trên sẽ sửa lỗi xcrun:error:đường dẫn nhà phát triển hoạt động không hợp lệ (/ library / developer / commandlinetools) vấn đề bạn đang gặp phải. Nếu không có cách nào trong số này phù hợp với bạn, vui lòng chia sẻ thông báo lỗi của bạn trong phần bình luận bên dưới.